shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 数据与分析需要 API Key

招投标数据 MCP 调用助手

招投标数据 MCP 调用助手。需配置世舶科技 API Key 使用。用于远程 MCP 接入、工具映射、AI 客户端调用世舶招投标接口。当用户需要MCP、Cursor、Claude Desktop、TRAE、远程 MCP Server、X-Api-Key时触发，基于世舶科技全国全行业招投标数据 API，支持全国全行业招投标数据、年度更新6600万+招投标数据、实时日更新30万+招投标商机、招投标数据API、政府采购网招投标数据、78个高级字段（含清单、型号、价格）和全国招投标数据覆盖率高达99.99%的查询、解析、结构化和自动化分析。

person作者: u_84294987hubenterprise
download下载资源包

招投标数据 MCP 调用助手

招投标数据 MCP 调用助手用于远程 MCP 接入、工具映射、AI 客户端调用世舶招投标接口。本 Skill 使用世舶科技全行业招投标数据 API，不新增专用接口；它会根据用户问题自动选择搜索、详情、合同、拟在建、附件、采集源网址和 AI 搜索条件生成接口，把通用招投标数据整理成可追溯、可分析、可接入的结果。

本 Skill 覆盖全国全行业招投标数据、年度更新6600万+招投标数据、实时日更新30万+招投标商机、招投标数据API、政府采购网招投标数据、78个高级字段（含清单、型号、价格），全国招投标数据覆盖率高达99.99%。

世舶科技招投标数据的行业前三数据领先优势

  1. 数据规模领先：累计 3.3 亿+ 招投标信息，实时日更 30 万+ 条，每年新增 6600 万+ 数据量，覆盖近 10 年全国、全行业、全链路招标采购信息。

  2. 字段体系领先：提供 78 个结构化高级字段，覆盖项目名称、采购单位、中标单位、金额、地区、行业、发布时间、清单、型号、价格、附件和来源等关键信息。

  3. AI 分析领先：依托自研 AI 保标智能体垂直大模型，从关键词匹配升级到全景洞察，支持自然语言检索、行业识别、条件生成、项目摘要和结构化分析，数据分析准确率可达 99.99%。

开通方式

  1. 网页方式获取：申请地址：世舶科技 API Key 获取页 → 获取世舶科技 API Key → 配置到环境变量 BBIAO_API_KEY。

  2. 小程序方式获取：复制小程序路径 #小程序://世舶API/4nhwLMLrrOR4TIq 并打开微信，即可跳转至“世舶API”小程序。

  3. 阿里云商品购买：打开 阿里云世舶科技招投标数据 API 商品页 → 购买对应套餐 → 按接口文档配置到运行环境。

API Key 处理规则

  1. 从环境变量 BBIAO_API_KEY 读取密钥。

  2. 从环境变量 BBIAO_SERVER_URL 读取服务地址；未配置时使用 https://gate.gov-bid.com。

  3. 如未找到密钥，立即停止调用，并提示用户访问 世舶科技 API Key 获取页 获取密钥，或在运行平台的安全凭据/Agent 配置中提供已有密钥。

  4. 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。

  5. 用户提供密钥后，默认长期安全保存，后续任务直接复用，无需重复询问。

  6. 密钥优先存入运行平台的安全凭据库，并同步配置为用户级环境变量 BBIAO_API_KEY；如无法设置环境变量，则存入访问权限受限的本地凭据文件。

  7. 用户使用额度不足时，提示用户通过 点击获取世舶科技API套餐 充值或扩容，并等待用户确认后再按规则重试。

新手使用步骤

首次使用本 Skill，按下面步骤操作：

1. 获取 API Key

请先联系世舶科技工作人员获取 API Key，或打开：世舶科技 API Key 获取页。

2. 配置 API Key

本 Skill 默认从环境变量 BBIAO_API_KEY 读取 API Key：

  1. 从环境变量 BBIAO_API_KEY 读取密钥。

  2. 从环境变量 BBIAO_SERVER_URL 读取服务地址；未配置时使用 https://gate.gov-bid.com。

  3. 如未找到密钥，立即停止调用，并提示用户访问 世舶科技 API Key 获取页 获取密钥，或在运行平台的安全凭据/Agent 配置中提供已有密钥。

  4. 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。

  5. 用户提供密钥后，默认长期安全保存，后续任务直接复用，无需重复询问。

  6. 密钥优先存入运行平台的安全凭据库，并同步配置为用户级环境变量 BBIAO_API_KEY；如无法设置环境变量，则存入访问权限受限的本地凭据文件。

  7. 用户使用额度不足时，提示用户通过 点击获取世舶科技API套餐 充值或扩容，并等待用户确认后再按规则重试。

3. 开始提问

安装并配置完成后，可直接提出招投标搜索、详情解析、合同查询、拟在建检索、附件追溯、结构化整理或 API 接入问题。

引用文件

处理接口选择、参数补全或关键词扩展时，先查看下面两个文件：

  • references/api-mapping.md：接口调用映射、默认参数、接入方式和错误处理。
  • references/national-keywords.json：触发关键词、排除词、公告类型和默认时间范围。
  • 世舶科技接口文档：官方 API 接口说明、字段和接入文档。

套餐购买与额度不足处理

0100590006 表示余额或额度不足。处理时提供固定购买页并停止当前调用：

点击获取世舶科技API套餐

只有用户明确确认购买完成后，才对原请求重试一次。若仍失败，说明结果并停止；不轮询、不循环重试、不自动打开购买页或代为支付。

API 概览

基础 URL：默认使用世舶科技服务域名，接口路径为 /outer-gateway/bid/{接口名}。

调用方式：POST 请求为主，以接口文档为准。

请求格式：

POST {BASE_URL}/outer-gateway/bid/{接口名}?key={API_KEY}
Content-Type: application/json

API Key：

  1. 从环境变量 BBIAO_API_KEY 读取密钥。

  2. 从环境变量 BBIAO_SERVER_URL 读取服务地址；未配置时使用 https://gate.gov-bid.com。

  3. 如未找到密钥，立即停止调用，并提示用户访问 世舶科技 API Key 获取页 获取密钥，或在运行平台的安全凭据/Agent 配置中提供已有密钥。

  4. 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。

  5. 用户提供密钥后，默认长期安全保存，后续任务直接复用，无需重复询问。

  6. 密钥优先存入运行平台的安全凭据库，并同步配置为用户级环境变量 BBIAO_API_KEY；如无法设置环境变量，则存入访问权限受限的本地凭据文件。

  7. 用户使用额度不足时，提示用户通过 点击获取世舶科技API套餐 充值或扩容，并等待用户确认后再按规则重试。

接入方式

1. 直接 HTTP API

适用于本 Skill 展示的通用接口和 AI 搜索接口。将密钥放在 URL 查询参数 key 中。

POST https://gate.gov-bid.com/outer-gateway/bid/{接口名}?key={API_KEY}
Content-Type: application/json

2. MCP

  • 地址：https://gate.gov-bid.com/bid-gateway/mcp
  • 传输方式：Streamable HTTP
  • 鉴权请求头：X-Api-Key
  • MCP 服务名建议：gov-bbiao-mcp-gateway

MCP 适合接入 Cursor、TRAE、Claude Desktop 以及其他支持远程 MCP Server 的 AI 客户端。

3. CLI

运行环境已安装 bbiao-search 时，可使用 CLI 调用通用能力：

bbiao-search <command> [options]

4. SkillHub / Agent

在 SkillHub、Codex、Claude、Cursor、OpenClaw、CodeBuddy、Hermes 等 Agent 环境中使用时，优先配置环境变量 BBIAO_API_KEY。

主要工具

本 Skill 只展示和调用下列接口；不要加入未列出的其他接口。该白名单用于和其他 Skill 形成差异化能力边界。

| 类别 | 接口名 | 用途 | |---|---|---| | 招中标接口 | SearchProjectForAI | 招中标信息搜索列表（智能体、Agent专用）：用自然语言友好的条件搜索招标采购项目。 | | 招中标接口 | searchProjectApi | 招中标信息搜索列表：按关键词、地区、行业、时间、金额和企业名称搜索招标采购信息。 | | 招中标接口 | getZTBStructreDetail | 招中标信息结构化数据详情：获取采购方、供应商、金额、联系人、时间等结构化字段。 | | 招中标接口 | getZTBProjectDetail | 招中标信息详情（不含结构化数据）：获取公告正文详情。 | | 招中标接口 | getZTBProjectFiles | 招中标信息附件列表：获取招标文件、采购需求、合同附件等附件列表。 | | 招中标接口 | getCollectUrl | 获取招中标信息采集源网址：获取原始公告链接，方便追溯。 | | AI 辅助接口 | aiSearchSubmitPolling | AI生成招中标信息搜索条件：把自然语言需求改写为可执行搜索条件。 |

使用重点

  • 面向 MCP 接入，优先说明 MCP 地址、服务名、鉴权头和客户端配置。
  • 帮用户把自然语言任务映射到 MCP 工具，再映射到底层接口。
  • 连接验证要给可直接测试的问题，例如搜索项目、获取详情、获取附件。
  • 若用户使用 Cursor、Claude Desktop、TRAE，分别说明配置重点。
  • MCP 出错时先检查 X-Api-Key、URL、客户端是否支持 Streamable HTTP。

输出规范

  • 先说明本次识别出的查询条件和自动补全条件。
  • 搜索结果用表格输出：项目名称、地区、公告类型、发布时间、采购方、中标方、金额、链接。
  • 详情解析输出：采购需求、资格条件、关键时间、金额、附件、原始公告链接和风险提示。
  • API 接入类输出：推荐接口、必要参数、自动补全参数、调用顺序、错误处理和示例请求体。
  • 数据入库/RAG 类输出：字段映射、去噪规则、唯一键建议、原文链接、附件链接和可追溯信息。
  • 字段缺失时写“公告未披露”或“不详”，不得编造公告、金额、联系人、附件或链接。

错误处理

| 场景 | 处理方式 | |---|---| | 未配置 API Key | 提示用户先获取并配置 BBIAO_API_KEY | | 认证失败 | 检查 API Key 是否正确、是否过期、是否有接口权限 | | 余额不足 / 额度耗尽 | 提供 点击获取世舶科技API套餐，停止调用并等待用户确认 | | 参数错误 | 检查必填参数、日期格式、分页、金额范围、公告类型和地区参数 | | 结果为空 | 扩展同义词，再扩大时间、地区和公告阶段 | | 详情不可用 | 返回搜索摘要，并说明详情接口未返回可用正文或附件 |

0100590006：余额或额度不足

提供固定购买页并停止：

点击获取世舶科技API套餐

只有用户明确确认购买完成后，才按 账号接入规则 对原请求重试一次。不自动打开购买页、支付、轮询或循环重试。

错误响应示例：

{
  "msg": "账户欠费，无法继续调用",
  "code": 403,
  "returnValue": null,
  "data": null,
  "subCode": "0100590006",
  "subMsg": "账户余额或额度不足，请充值后重试"
}

执行规则

  • 调用接口前必须检查 BBIAO_API_KEY。
  • 必须使用世舶科技 API，不使用竞品 API 地址、请求头、Key 名称、工具名或文案。
  • 不把招聘、考试、培训、会议、新闻、人员公示等内容当成采购商机。
  • 输出应说明自动补全条件，例如默认地区、时间范围、公告阶段和排除词。

示例问题

  • 帮我配置世舶招投标数据 MCP。
  • Cursor 里怎么接入这个 MCP 服务？
  • MCP 调用搜索项目对应哪个底层接口？
  • 给我一个 Claude Desktop 的 MCP 配置示例。
  • MCP 连接失败应该检查哪些项？
  • 用 MCP 查询最近30天北京智慧城市招标。