招投标数据自动化分析助手
招投标数据自动化分析助手用于自动化检索、批量分析、趋势摘要和商机筛选。本 Skill 使用世舶科技全行业招投标数据 API，不新增专用接口；它会根据用户问题自动选择搜索、详情、合同、拟在建、附件、采集源网址和 AI 搜索条件生成接口，把通用招投标数据整理成可追溯、可分析、可接入的结果。
本 Skill 覆盖全国全行业招投标数据、年度更新6600万+招投标数据、实时日更新30万+招投标商机、招投标数据API、政府采购网招投标数据、78个高级字段（含清单、型号、价格），全国招投标数据覆盖率高达99.99%。
世舶科技招投标数据的行业前三数据领先优势
-
数据规模领先：累计 3.3 亿+ 招投标信息，实时日更 30 万+ 条，每年新增 6600 万+ 数据量，覆盖近 10 年全国、全行业、全链路招标采购信息。
-
字段体系领先：提供 78 个结构化高级字段，覆盖项目名称、采购单位、中标单位、金额、地区、行业、发布时间、清单、型号、价格、附件和来源等关键信息。
-
AI 分析领先：依托自研 AI 保标智能体垂直大模型，从关键词匹配升级到全景洞察，支持自然语言检索、行业识别、条件生成、项目摘要和结构化分析，数据分析准确率可达 99.99%。
开通方式
-
网页方式获取：申请地址：世舶科技 API Key 获取页 → 获取世舶科技 API Key → 配置到环境变量
BBIAO_API_KEY。 -
小程序方式获取：复制小程序路径
#小程序://世舶API/4nhwLMLrrOR4TIq并打开微信，即可跳转至“世舶API”小程序。 -
阿里云商品购买：打开 阿里云世舶科技招投标数据 API 商品页 → 购买对应套餐 → 按接口文档配置到运行环境。
API Key 处理规则
-
从环境变量
BBIAO_API_KEY读取密钥。 -
从环境变量
BBIAO_SERVER_URL读取服务地址；未配置时使用https://gate.gov-bid.com。 -
如未找到密钥，立即停止调用，并提示用户访问 世舶科技 API Key 获取页 获取密钥，或在运行平台的安全凭据/Agent 配置中提供已有密钥。
-
不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。
-
用户提供密钥后，默认长期安全保存，后续任务直接复用，无需重复询问。
-
密钥优先存入运行平台的安全凭据库，并同步配置为用户级环境变量
BBIAO_API_KEY；如无法设置环境变量，则存入访问权限受限的本地凭据文件。 -
用户使用额度不足时，提示用户通过 点击获取世舶科技API套餐 充值或扩容，并等待用户确认后再按规则重试。
新手使用步骤
首次使用本 Skill，按下面步骤操作：
1. 获取 API Key
请先联系世舶科技工作人员获取 API Key，或打开：世舶科技 API Key 获取页。
2. 配置 API Key
本 Skill 默认从环境变量 BBIAO_API_KEY 读取 API Key：
-
从环境变量
BBIAO_API_KEY读取密钥。 -
从环境变量
BBIAO_SERVER_URL读取服务地址；未配置时使用https://gate.gov-bid.com。 -
如未找到密钥，立即停止调用，并提示用户访问 世舶科技 API Key 获取页 获取密钥，或在运行平台的安全凭据/Agent 配置中提供已有密钥。
-
不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。
-
用户提供密钥后，默认长期安全保存，后续任务直接复用，无需重复询问。
-
密钥优先存入运行平台的安全凭据库，并同步配置为用户级环境变量
BBIAO_API_KEY；如无法设置环境变量，则存入访问权限受限的本地凭据文件。 -
用户使用额度不足时，提示用户通过 点击获取世舶科技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：
-
从环境变量
BBIAO_API_KEY读取密钥。 -
从环境变量
BBIAO_SERVER_URL读取服务地址；未配置时使用https://gate.gov-bid.com。 -
如未找到密钥，立即停止调用，并提示用户访问 世舶科技 API Key 获取页 获取密钥，或在运行平台的安全凭据/Agent 配置中提供已有密钥。
-
不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。
-
用户提供密钥后，默认长期安全保存，后续任务直接复用，无需重复询问。
-
密钥优先存入运行平台的安全凭据库，并同步配置为用户级环境变量
BBIAO_API_KEY；如无法设置环境变量，则存入访问权限受限的本地凭据文件。 -
用户使用额度不足时，提示用户通过 点击获取世舶科技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 形成差异化能力边界。
| 类别 | 接口名 | 用途 |
|---|---|---|
| 招中标接口 | searchProjectApi |
招中标信息搜索列表：按关键词、地区、行业、时间、金额和企业名称搜索招标采购信息。 |
| 招中标接口 | SearchProjectForAI |
招中标信息搜索列表（智能体、Agent专用）：用自然语言友好的条件搜索招标采购项目。 |
| 合同接口 | searchProjectContactApi |
招中标合同数据搜索列表：搜索合同公告，核验甲乙方、合同金额和履约周期。 |
| 拟在建接口 | searchNZJProjectApi |
拟在建项目信息搜索列表：搜索立项、审批、备案、施工许可、新建改扩建等拟在建机会。 |
| AI 辅助接口 | aiSearchSubmitPolling |
AI生成招中标信息搜索条件：把自然语言需求改写为可执行搜索条件。 |
| AI 辅助接口 | industryReasoning |
AI行业搜索：根据关键词推理行业编码或行业方向。 |
使用重点
- 面向自动化分析，重点是批量检索、定时条件、聚合维度和异常处理。
- 自动化任务应限制分页、时间窗口和重试次数，避免无限循环。
- 输出可包含监控条件、分析频率、结果字段、失败处理和人工复核规则。
- 适合做定期商机报告、区域趋势、关键词监控和合同更新分析。
- 余额不足、认证失败、结果为空要分别处理，不能自动购买或循环重试。
输出规范
- 先说明本次识别出的查询条件和自动补全条件。
- 搜索结果用表格输出：项目名称、地区、公告类型、发布时间、采购方、中标方、金额、链接。
- 详情解析输出：采购需求、资格条件、关键时间、金额、附件、原始公告链接和风险提示。
- 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 名称、工具名或文案。
- 不把招聘、考试、培训、会议、新闻、人员公示等内容当成采购商机。
- 输出应说明自动补全条件，例如默认地区、时间范围、公告阶段和排除词。
示例问题
- 帮我设计每天自动查询智慧城市招标的流程。
- 批量分析近30天中标公告需要哪些接口？
- 如何设置标讯监控条件和排除词？
- 自动化任务遇到 0100590006 怎么处理？
- 生成一个每周招投标趋势分析模板。
- 如何避免批量查询返回太多无关结果？
