Agent Skill

全国招投标数据商机查询助手

全国招投标数据商机查询助手。用户涉及招标、中标、采购意向、合同、项目详情、附件、拟在建项目、企业画像、联系人、客户供应商关系、自然语言查标、行业推理、标讯分类、文本结构化、项目甄别、销售获客、竞品监测或行业分析时使用本 Skill;即使用户未提到世舶科技,只要需求属于上述招投标数据场景,也使用本 Skill 选择正确接口并按需加载对应场景模块。需配置世舶科技 API Key 使用,面向全国招标中标查询、项目订阅、接口调用、数据检索和结果整理,覆盖招标公告、中标公告、中标候选人、政府采购、工程建设、企业采购、采购意向、合同公告、变更公告、废标流标、拟在建项目、临期项目、即将到期项目。支持按地区、行业、时间、项目分类、采购分类、采购单位、中标单位、供应商、企业名称、标的物、项目金额、发布时间、开标时间查询筛选,适用于AI招投标智能搜索、自然语言找标、商机发现、CRM客户商机、销售线索、企业画像、采购单位画像、供应商画像、上下游关系、历史中标记录、竞争对手监测、重点企业预警、Top采购单位、Top中标单位、价格趋势、市场份额、标讯文本结构化、项目甄别、字段抽取、区域市场分析和行业情报。

商业运营·览山科技·来自 skill_hub·skillhub.cn ↗
skillhub install @org-whlskj/lskj-official-ztbdata
3 Stars·4.3万 综合热度·7,632 字文档·源站更新 2026-11-13

README 文档

7,632 字

世舶科技招投标数据 API 场景概览

⭐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/{接口名}
Content-Type: application/json

鉴权配置与开通

按以下顺序处理:

  1. 优先使用运行环境中已配置的鉴权变量 BBIAOAPIKEY。
  2. 服务地址优先读取 BBIAOSERVERURL;未配置时使用 https://gate.gov-bid.com。
  3. 如未找到可用鉴权配置,停止接口调用,并提示用户访问 世舶科技开通页 获取后再配置。
  4. 鉴权信息仅用于接口认证,不在回答、示例、报错、日志摘要或请求地址中展示。
  5. 用户额度不足时,提示用户通过 点击获取世舶科技API套餐 充值或扩容。

⭐接入方式

接入方式属于交付渠道,不属于独立业务场景。根据运行环境选择一种即可。

1. 直接 HTTP API

适用于已列出的直接 HTTP 接口。按平台配置的鉴权方式调用,不在文档示例中拼接或展示鉴权参数。

2. MCP

  • 地址:https://gate.gov-bid.com/bid-gateway/mcp
  • 传输方式:Streamable HTTP
  • 鉴权方式:按平台配置
  • MCP 服务名建议:gov-bbiao-mcp-gateway

MCP 可用于部分通用工具。具体工具以平台文档为准。

3. CLI

运行环境已安装配套命令行工具时,可按平台文档调用部分通用能力:

<command> [options]

企业画像、拟在建项目和定制化 AI 模型接口使用直接 HTTP API。


⭐接口清单(20 个)

🪶接口详细参数见文件reference/Parameter-Description.md

一、招中标与合同数据(9 个)

接口地址主要用途
招中标信息搜索列表/bid/searchProjectApi按关键词、地区、行业、时间、金额和企业角色搜索标讯
根据项目编号查询列表/bid/getProjectByProjectNumber串联同一项目编号的招标、变更、中标、合同等公告
招中标结构化详情/bid/getZTBStructreDetail获取项目编号、预算、中标金额、甲乙方、代理机构和联系方式
招中标正文详情/bid/getZTBProjectDetail获取完整公告正文,不含结构化字段
招中标附件列表/bid/getZTBProjectFiles获取附件名称、状态和下载地址
AI/Agent 专用搜索/bid/SearchProjectForAI使用地区名称、类别名称和企业名称进行自然语言友好搜索
合同数据搜索/bid/searchProjectContactApi搜索合同公告、合同周期、甲乙方和合同期限
获取采集源网址/bid/getCollectUrl获取公告原始发布网页
AI 搜索条件重写/bid/aiSearchSubmitPolling将自然语言需求改写为时间、关键词、企业、行业和地区条件

二、企业画像(4 个)

接口地址主要用途
企业基本信息/bid/companyProfileSummary查询工商基础、经营信息、招投标统计和关系汇总
企业联系电话/bid/companyProfileContacts分页获取联系人和电话,每页最多 5 条
企业合作客户/bid/companyProfileCustomers获取客户企业及关联项目,每页最多 20 条
企业供应商/bid/companyProfileSuppliers获取供应商企业及关联项目,每页最多 20 条

三、拟在建项目(3 个)

接口地址主要用途
拟在建项目搜索/bid/searchNZJProjectApi按关键词、地区和时间搜索拟在建信息
拟在建项目详情/bid/getNZJProjectDetail获取建设单位、完整正文、地区和附件摘要
拟在建附件列表/bid/getNZJProjectFileList获取拟在建项目附件名称、格式、状态和下载地址

四、AI 推理与结构化(4 个)

接口地址主要用途
AI 行业搜索/bid/industryReasoning将行业短语映射为国家统计局行业编码候选
LLM 标讯结构化/bid/ztbAiStructureInfo兼容 Chat Completions 消息格式,抽取招中标结构化字段
招中标分类推理/bid/categoryReasoning根据标题和正文推理招中标信息分类
项目信息甄别/bid/projectDiscrimination判断文本属于标讯、拟在建、非项目或异常信息

⭐核心概念:关键词组合

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

字段规则示例
keyword空格表示同时出现,`` 表示任一出现医院 病床、`病床医疗床`
inCludeKW结果必须包含,多个词使用 ```采购招标`
excludeKW排除包含任一关键词的结果`维修维保配件`

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

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

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

⭐核心概念:搜索模式

searchType 搜索类型

值含义
1智能模糊搜索
2精准搜索
3高级搜索

searchMode 搜索字段

值含义
1标题和内容
2仅标题
3仅内容

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


⭐核心概念:企业角色

字段企业角色使用场景
partAName甲方、采购人、招标人查询某单位采购或招标的项目
partBName乙方、中标人、供应商查询某企业中标或签约项目
agentName招标代理机构查询代理机构经办项目
companyName不确定角色查询企业参与的全部相关项目

不得把 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 表示全部分类。

采购分类

ID分类
0其它类
1服务类
2工程类
3货物类

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


⭐分页与数量规则

接口分页字段单页上限仅查数量
招中标搜索pageId、pageNumber50pageNumber=0
AI 专用搜索pageId、pageNumber100pageNumber=0
合同搜索pageId、pageNumber100pageNumber=0
拟在建搜索pageId、pageNumber50pageNumber=0
企业联系人pageNo、pageSize5不支持
企业客户/供应商pageNo、pageSize20不支持

需要全量结果时根据 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 状态、接口状态和业务状态。接口返回空数组时写“未命中”,不要解释为现实中不存在相关项目或企业关系。


错误处理

情况处理方式
缺少 API Key停止调用,提示配置 BBIAOAPIKEY 并联系商务获取密钥
鉴权失败检查密钥是否正确、是否过期和请求地址是否携带 key
日期格式错误使用 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss
页码或页大小错误使用正整数并遵守各接口上限;仅查数量时使用允许的 pageNumber=0
参数名错误区分 pageId/pageNumber、pageNo/pageSize、publishtime/publishTime
业务状态失败返回 code/state、subCode、msg/subMsg,不要生成模拟数据
AI 处理超时返回 requestKey 和当前 status,允许稍后重试,不猜测结果
附件不可用保留附件状态,不声称文件可下载

场景模块路由

识别用户需求后,只读取对应的场景文件,并按照其中流程、接口编排、输出格式和数据边界执行。场景文件中的“详细接口参数”链接指向 references 内的权威输入输出说明;实际调用前读取本次使用的接口文件,不要一次加载全部参数文档。跨场景任务可加载多个文件,但要说明执行顺序。

用户需求场景文件
标讯搜索、订阅、提醒标讯搜索与订阅(scenarios/search-subscribe-bids.md)
销售获客、采购线索销售获客(scenarios/find-sales-leads.md)
CRM 客户与商机补全CRM 商机增强(scenarios/enrich-crm-opportunities.md)
拟在建项目发现拟在建项目(scenarios/find-planned-projects.md)
企业画像与上下游企业关系分析(scenarios/analyze-company-network.md)
投标监测与竞品跟踪竞品监测(scenarios/monitor-competitors.md)
行业统计与市场分析行业分析(scenarios/analyze-bid-industry.md)
自然语言智能查标AI 智能搜索(scenarios/search-bids-ai.md)
文本甄别、分类、结构化文本结构化(scenarios/structure-bid-text.md)

完整参数原文见 接口输入输出详细说明(references/Parameter-Description.md),枚举值和码表见 枚举与码表(references/enums-and-code-tables.md)。


数据与分析边界

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

回答后引导

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

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

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

余额或额度不足处理

当接口返回 100590006,表示余额或额度不足:

  1. 提供固定购买页:点击获取世舶科技API套餐。
  2. 停止当前调用,等待用户明确确认购买完成。
  3. 用户确认后,只对原请求重试一次;若仍失败,说明结果并停止。
  4. 不轮询、不循环重试、不自动打开购买页或代为支付。

余额或额度不足处理

当接口返回 0100590006,表示余额或额度不足:

  1. 提供固定购买页:点击获取世舶科技API套餐。
  2. 停止当前调用,等待用户明确确认购买完成。
  3. 用户确认后,只对原请求重试一次;若仍失败,说明结果并停止。
  4. 不轮询、不循环重试、不自动打开购买页或代为支付。

同分类其他技能

查看全部 ›