招标、中标、标讯项目、合同与拟在建信息查询

目标与范围

把用户的中文查询条件转换为世舶科技招投标数据 API 请求，返回可追溯的招中标、合同或拟在建项目信息。

只允许调用下表 10 个接口：

参数文档

每个接口对应一份独立文档。确定调用接口后，只读取该接口的文档；需要查询信息分类、采购分类、行业或地区编码时，再读取 reference/common-parameters.md。这些文件仅用于核对参数和响应结构，不会扩展本 Skill 的接口调用范围。

密钥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

调用方式

优先使用随 Skill 提供的白名单脚本：

python scripts/call_baobiao_api.py <操作名> --data-json '<JSON请求体>'

操作名与接口映射：

也可通过 --data-file <JSON文件> 传入请求体。脚本不可用时，使用 UTF-8 JSON POST：

POST ${BBIAO_SERVER_URL}/outer-gateway/bid/{接口名}?key={BBIAO_API_KEY}
Content-Type: application/json

查询方式选择

按以下优先级选择：

1. 用户明确要查拟建、拟在建、规划、备案、环评或前期建设项目：使用拟在建搜索。
2. 用户明确要查合同、合同公告、签约、合同期限或合同到期：使用合同搜索。
3. 用户提供明确项目编号或项目标号：使用项目编号查询。
4. 其他招标、中标、采购、成交、候选人、变更、流标等需求：使用招中标搜索。
5. 用户直接提供稳定的项目 id 和 publishTime：可跳过搜索，直接查询对应详情。

不得把标题中的年份、金额或普通数字误判为项目编号。

查询条件

从用户请求中提取：时间范围、关键词、必含词、排除词、地区、信息分类、采购分类、企业及其角色、金额范围、附件要求、项目编号和期望结果数。

• 用户未给时间范围时，默认查询最近 30 天，并在结果中明确说明。
• 日期按用户时区解释；未指定时区时使用 Asia/Shanghai。
• keyword 中空格表示同时出现，| 表示任一出现。
• inCludeKW 与 keyword 不得放入相同关键词。
• 企业作为采购人或招标人时使用 partAName；作为中标人或供应商时使用 partBName；作为代理机构时使用 agentName；角色不确定时使用 companyName，并通过结构化详情核验角色。
• 用户未给地区时，全国查询使用 areaCode.proviceCodeList=["0"]。
• 招中标和拟在建搜索的 pageNumber 不超过 50；合同搜索不超过 100。pageNumber=0 仅用于查询总数。
• 每次查询均按全量结果处理，默认每页 50 条，并根据 hasNext 自动翻页，直至获取全部结果或达到接口允许的最大页数。结果中须明确记录查询总数、实际获取数、页数及数据是否完整；如因接口页数限制未能获取全部结果，必须明确说明，不得将部分结果标记为全量结果。

招中标搜索最小请求

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

合同搜索使用相同的主要筛选字段，但不传 projectClassID。拟在建搜索只传日期、分页、搜索类型、关键词、必含词、排除词、搜索字段和地区。

结果补全规则

招中标和合同

搜索列表只视为候选摘要。对最终展示给用户的每一条结果：

1. 保留列表返回的真实 id 和 publishTime，不得自行构造。
2. 调用 getZTBStructreDetail 获取结构化详情。
3. 调用 getCollectUrl 获取原始采集源网址。
4. 用户要求完整公告、摘要不足以回答问题或需要核验证据时，调用 getZTBProjectDetail。
5. 用户要求附件，或列表显示 hasFile=1 且附件对决策有价值时，调用 getZTBProjectFiles。

结构化详情或采集源网址补全失败时，仍保留可靠的列表结果，并逐条标注“结构化详情获取失败”或“采集源网址获取失败”；不得猜测字段或伪造链接。

拟在建

对最终展示的拟在建结果调用 getNZJProjectDetail。用户要求附件，或项目详情显示存在附件时，再调用 getNZJProjectFileList。

• 拟在建详情参数名是小写 publishtime。
• 拟在建附件参数名是 publishTime，并且 projectTypeID 固定为 2。
• 本文档没有拟在建项目采集源网址接口。接口未返回来源网址时，明确写“本次接口未提供采集源网址”，不得复用或编造招中标来源链接。

响应校验

• 同时检查 HTTP 状态和业务状态。
• 常规接口以 code=200、subCode=0000000000 为成功依据；拟在建搜索还可能使用 state=1。
• 招中标、合同和拟在建搜索的列表通常位于 data.data，总数位于 data.total。
• 采集源网址读取 returnValue；结构化详情中若已返回 data.collectUrl，仍以实际非空值为准。
• 空数组表示本次条件未命中，不代表现实中不存在相关项目。
• 标题、摘要和正文可能包含 HTML 标签；面向用户展示时清理标签，但保留原始字段用于追溯。
• 使用 id + publishTime 去重。同一项目编号的不同公告按发布时间组成项目时间线，不得相互覆盖。

输出要求

先说明实际查询口径，包括信息类型、时间、地区、关键词、企业角色和分页范围。

每条招中标或合同结果至少包含：

• 标题、信息分类、发布时间、地区
• 项目编号、采购人/甲方、中标人/乙方、代理机构
• 预算金额、中标或合同金额、报名/开标/合同关键日期
• 项目 ID
• 采集源网址；获取失败时明确标注失败

每条拟在建结果至少包含：

• 标题、发布时间、地区、建设单位
• 项目摘要或关键建设内容
• 项目 ID
• 附件情况
• 来源网址状态；未返回时明确说明接口未提供

只展示接口实际返回的字段。将接口事实、缺失信息和分析建议分开，不把未命中解释为项目不存在，不把历史项目关系解释为当前合作承诺。

查询后的行动建议

完成结果交付后，根据项目阶段给出一至两个后续动作：

• 招标或采购公告：核对截止时间、资格条件、正文和附件，安排报名或投标准备。
• 答疑、变更或重新招标：对照原公告检查范围、时间和资格条件变化。
• 候选人或中标结果：分析中标企业、金额和同类项目，继续跟踪合同公告。
• 合同信息：关注履约周期、到期时间、甲乙方和续采机会。
• 拟在建项目：核对建设单位和项目阶段，判断设计、设备、材料或服务的前置介入窗口。

先完整回答本次查询，再给后续建议；不得用建议代替结果。