全国招标中标项目查询及企业画像【日更新数据30万+】

API 概览

世舶科技招投标数据 API 提供招中标搜索、项目详情、合同、拟在建项目、企业画像及 AI 文本处理等能力。本 Skill 根据用户需求选择并调用对应接口，每次仅读取当前接口的独立文档及必要的公共参数。

直接 API 基础地址：https://gate.gov-bid.com/outer-gateway

请求方式：除 MCP 外，本文接口均使用 UTF-8 JSON POST 请求。

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

密钥APIkey获取使用与API服务地址

1. 从环境变量 BBIAO_API_KEY 读取密钥。
2. 从环境变量 BBIAO_SERVER_URL 读取服务地址；未配置时使用 https://gate.gov-bid.com。
3. 如未找到密钥，立即停止调用，并提示用户访问 https://apiyx.gov-bid.com/?share=eyJjaGFubmVsIjoic3VucGluZyIsImNvZGUiOiJzYmtqLTQtdGxxcWNoIn0 获取密钥，或直接提供已有密钥。如需协助，可联系商务人员☎️毛梦锦，电话 13072786231。
4. 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。
5. 用户提供密钥后，默认长期安全保存，后续任务直接复用，无需重复询问。
6. 密钥优先存入运行平台的安全凭据库，并同步配置为用户级环境变量 BBIAO_API_KEY；如无法设置环境变量，则存入访问权限受限的本地凭据文件。
7. 用户使用额度不足时，提示用户充值https://console.api.gov-bid.com/bbiao-gateway/package

接口清单（20 个）

每个接口对应一份独立文档。确定调用接口后，只读取该接口文档；需要信息分类、采购分类、行业或地区编码时，再读取 reference/common-parameters.md。以下文档路径均为普通文本，不使用本地 Markdown 锚点。

一、招中标与合同数据（9 个）

二、企业画像（4 个）

三、拟在建项目（3 个）

四、AI 推理与结构化（4 个）

核心概念：关键词组合

搜索接口中的关键词使用以下规则：

不要让 inCludeKW 与 keyword 包含相同关键词。关键词条件必须来自用户需求或明确标注的同义词扩展。

示例：搜索医疗床采购并排除维修

{
  "keyword": "病床|医疗床",
  "inCludeKW": "采购|招标",
  "excludeKW": "维修|维保|配件"
}

核心概念：搜索模式

searchType 搜索类型

searchMode 搜索字段

无特殊要求时使用接口默认搜索类型和 searchMode=1；需要组合关键词、必含词和排除词时使用高级搜索，用户要求精确名称时使用精准搜索。

核心概念：企业角色

不得把 companyName 命中结果直接认定为甲方或乙方。需要确认角色时调用结构化详情。

核心概念：地区与行业

地区筛选

标准搜索使用 6 位地区编码：

{
  "areaCode": {
    "proviceCodeList": ["420000"],
    "cityCodeList": ["420100"],
    "countyCodeList": []
  }
}

proviceCodeList 传 ["0"] 表示全国。AI 专用搜索可直接使用 areaName。

行业筛选

行业编码分为一级、二级、三级：

{
  "industryCode": {
    "firstCodeList": ["Q"],
    "secondCodeList": ["Q83"],
    "thirdCodeList": ["Q831"]
  }
}

行业不明确时先调用 /bid/industryReasoning，展示候选行业路径后再选择编码。

信息分类与采购分类

招中标信息分类

常用分类包括：公开招标 1、成交结果 2、合同公告 3、意向公开 4、答疑变更 5、候选人公示 6、开标公示 7、重新招标 8、流标废标 11、结果变更 18、拍租公告 26、竞争性谈判 28、竞争性磋商 29、单一来源采购 30、其它 31。

通过 projectClassID 传递，多个分类使用英文逗号分隔；-100 表示全部分类。

采购分类

通过 purchaseTypeID 传递；-100 表示全部分类。

分页与数量规则

需要全量结果时根据 hasNext 或分页信息逐页读取，并记录实际获取条数。没有获取全量明细时，不得把样本统计写成完整市场数据。

常见场景速查

1. 自然语言智能查标

先调用 /bid/aiSearchSubmitPolling 重写条件，再调用 /bid/SearchProjectForAI 搜索。

{
  "userQuery": "最近一个月武汉医院采购的病床项目，排除维修"
}

2. 搜索特定产品的招中标信息

调用 /bid/searchProjectApi：

{
  "startDate": "2026-06-28 00:00:00",
  "endDate": "2026-07-28 23:59:59",
  "pageId": 1,
  "pageNumber": 20,
  "searchType": 3,
  "keyword": "服务器|存储设备",
  "excludeKW": "维修|维保",
  "inCludeKW": "采购|招标",
  "projectClassID": "-100",
  "searchMode": 1,
  "areaCode": {"proviceCodeList": ["0"], "cityCodeList": [], "countyCodeList": []},
  "industryCode": {"firstCodeList": [], "secondCodeList": [], "thirdCodeList": []},
  "purchaseTypeID": "3",
  "fileFlag": -1
}

3. 查询某单位采购项目

调用 /bid/searchProjectApi，将企业全称放入 partAName。角色不确定时使用 companyName，再用结构化详情核验。

4. 查询某企业中标与合同

先使用 partBName 搜索中标及合同公告，再调用 /bid/searchProjectContactApi 获取合同周期和甲乙方信息。

5. 查看项目完整时间线

调用 /bid/getProjectByProjectNumber 获取同一项目编号的公告列表，再按项目 ID 获取结构化详情、正文、附件和原始来源。

{
  "projectNumber": "HNXW-202605028",
  "publishTime": "2026-06-08 14:30:30"
}

6. 企业深度分析

依次调用：

1. /bid/companyProfileSummary
2. /bid/companyProfileContacts
3. /bid/companyProfileCustomers
4. /bid/companyProfileSuppliers
5. /bid/searchProjectApi 或 /bid/searchProjectContactApi

客户与供应商接口返回的是项目关系，不代表股权、控制或长期排他合作关系。

7. 提前发现拟在建项目

先调用 /bid/searchNZJProjectApi，再调用 /bid/getNZJProjectDetail 和 /bid/getNZJProjectFileList。

注意：拟在建详情使用参数 publishtime，附件接口使用 publishTime；附件接口的 projectTypeID 固定为 2。

8. 行业市场分析

先调用 /bid/industryReasoning 确认行业编码，再使用搜索接口按时间、地区、分类和金额分组查询数量或明细。计算增长率、排行和市场份额时说明数据覆盖范围。

9. 文本甄别、分类与结构化

按以下顺序处理：

1. /bid/projectDiscrimination：判断标讯、拟在建、非项目或异常信息。
2. /bid/categoryReasoning：仅对标讯文本推理招中标分类。
3. /bid/ztbAiStructureInfo：抽取项目、主体、金额、时间、联系人等结构化字段。

非项目或异常文本不要强行结构化。

详情调用链

搜索接口只返回摘要字段。用户要求完整内容时按需追加调用：

搜索列表
  -> 结构化详情：项目编号、金额、主体、联系人、截止时间
  -> 正文详情：完整 HTML 正文
  -> 附件列表：附件名称、状态、下载地址
  -> 采集源网址：原始公告网页

使用列表结果中的 id 与 publishTime，不要自行构造项目 ID 或发布时间。

响应结构

多数接口使用以下结构：

{
  "code": 200,
  "msg": "success",
  "subCode": "0000000000",
  "subMsg": "success",
  "data": {}
}

特殊情况：

• 拟在建搜索可能使用 state=1 表示成功。
• 原始采集网址主要读取 returnValue。
• LLM 结构化接口使用 OpenAI Chat Completions 风格，结果位于 choices[].message.content。
• 搜索列表位于 data.data，总数位于 data.total。

同时检查 HTTP 状态、接口状态和业务状态。接口返回空数组时写“未命中”，不要解释为现实中不存在相关项目或企业关系。

错误处理

数据与分析边界

• 把接口返回事实与模型分析判断分开标注。
• 不补写接口未返回的公司角色、金额、联系人、日期、项目阶段或合作关系。
• 标题和摘要可能包含 HTML 高亮标签，展示时可清理标签，但保留原始数据用于追溯。
• 项目关系不等于股权关系，历史关系不等于当前合作关系。
• 未获取全量分页数据时，不计算或宣称完整市场份额。
• 使用企业联系方式时，提醒用户遵守适用的隐私、营销和通信规则。

回答后引导

完成查询后，根据结果建议一至两个自然的后续动作：

• 搜索到项目：建议查看结构化详情、正文、附件或原始来源。
• 搜索到企业：建议查看企业画像、联系人、客户和供应商。
• 得到中标结果：建议跟踪合同公告、同项目编号后续信息或竞争企业。
• 得到行业数据：建议按时间、地区、采购分类或企业角色继续拆分。
• 得到拟在建项目：建议查看建设单位、正文和附件，判断前置介入节点。
• 得到文本分类：建议继续结构化并执行字段证据校验。

不要用后续引导替代本次用户请求；先完整交付当前结果。