全国招投标 AI 检索助手

技能文档

---
name: shibo-national-ai-bid-search
title: 全国招投标 AI 检索助手
category: 招投标采购
description: 全国招投标 AI 检索助手。面向全国范围自动识别自然语言中的地区、行业、关键词、公告阶段、采购类型、金额区间和时间范围，基于全国全行业招投标数据 API 查询招标公告、中标结果、合同公告、拟在建项目和项目详情，输出结构化、可追溯的检索结果。适合全国标讯检索、按地区行业筛选商机、合同公告查询、拟在建项目挖掘、招投标数据接口接入场景。触发词：全国招投标、标讯检索、招标公告、中标结果、拟在建项目、招投标数据接口。
---

# 全国招投标 AI 检索助手

全国招投标 AI 检索助手 用于围绕“AI 搜索”处理招投标查询：先理解用户自然语言，再自动抽取或补全关键词、地区、行业、发布时间、公告类型、采购单位、中标单位、项目编号、预算金额、排除词等条件，最后调用世舶科技全国全行业招投标数据 API 返回相关公告、合同、拟在建、附件和可追溯链接。

本技能 不新增 API，只复用世舶科技已有全行业接口。重点能力是把口语化、模糊化、跨条件的用户问题改写成可执行的招投标搜索条件，并输出适合业务人员、销售团队、投标团队和研发接入人员使用的结构化结果。

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


## 开通方式

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


3. 阿里云商品购买：打开 [阿里云世舶科技招投标数据 API 商品页](https://market.aliyun.com/detail/cmapi00066410?spm=5176.marketmsp.0.0.740425dbAZB0RU#sku=yuncode6041000002) → 购买对应套餐 → 按接口文档配置到运行环境。
## 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. 用户使用额度不足时，提示用户通过 服务商套餐购买页 充值或扩容，并等待用户确认后再按规则重试。

## 引用文件

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

- `references/api-mapping.md`：本技能 允许展示和调用的接口清单、用户意图映射、参数补全和错误处理。
- [世舶科技接口文档](https://console.woyaobid.com/gateway-admin/share/api-doc)：官方 API 接口说明、参数字段和接入文档。
- `references/ai-search-keywords.json`：AI 搜索触发词、排除词、公告类型、默认时间范围和输出字段。

## 套餐购买与额度不足处理

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

服务商套餐购买页

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

## API 概览

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

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

请求格式：

```text
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. 用户使用额度不足时，提示用户通过 服务商套餐购买页 充值或扩容，并等待用户确认后再按规则重试。

## 主要工具

本技能 只展示和调用下列接口；不要加入未列出的其他接口。

| 类别 | 接口名 | 用途 |
|---|---|---|
| AI 辅助接口 | `aiSearchSubmitPolling` | AI生成招中标信息搜索条件：把自然语言需求改写为可执行搜索条件。 |
| 招中标接口 | `SearchProjectForAI` | 招中标信息搜索列表（智能体、Agent专用）：用自然语言友好的条件搜索招标采购项目。 |
| 招中标接口 | `searchProjectApi` | 招中标信息搜索列表：按关键词、地区、行业、时间、金额和企业名称搜索招标采购信息。 |
| 合同接口 | `searchProjectContactApi` | 招中标合同数据搜索列表：搜索合同公告，核验甲乙方、合同金额和履约周期。 |
| 拟在建接口 | `searchNZJProjectApi` | 拟在建项目信息搜索列表：搜索立项、审批、备案、施工许可、新建改扩建等拟在建机会。 |
| 拟在建接口 | `getNZJProjectDetail` | 拟在建项目详情：获取拟在建项目建设内容、建设单位、阶段和正文信息。 |
| AI 辅助接口 | `industryReasoning` | AI行业搜索：根据关键词推理行业编码或行业方向。 |

## 技能定位

- 面向不会写复杂检索条件的用户，把自然语言问题转成招投标搜索条件。
- 面向需要快速查商机、查公告、查合同、查拟在建、查附件和查原文链接的业务团队。
- 面向需要把世舶科技招投标数据 API 接入 Agent、RAG、CRM、销售线索系统或内部数据平台的研发团队。
- 优先保证「相关性、可追溯、字段清楚、条件透明」，每次输出都说明已识别和自动补全的查询条件。

## 触发条件

当用户问题包含以下任一意图时使用本技能：

- 想用一句话搜索招标、中标、采购意向、合同、拟在建项目。
- 说不清楚精确字段，但给出了行业、产品、地区、企业、采购单位、金额或时间范围。
- 要求“帮我筛选”“帮我找商机”“帮我查最近”“帮我看某地区某行业项目”。
- 要求把自然语言转成招投标 API 查询参数。
- 要求查询项目编号、公告详情、附件、原始链接或合同数据。
- 要求从关键词推理行业方向或行业编码。

## 技能工作流

### 步骤1：解析用户意图

解析用户自然语言，识别核心意图：公告搜索、AI 搜索、项目编号查询、详情分析、合同查询、拟在建查询、附件查询、原始链接追溯或行业推理。

### 步骤2：抽取与补全查询条件

1. 抽取显性条件：关键词、地区、行业、采购单位、中标单位、项目编号、金额区间、时间范围、公告类型、采购类型、排除词。
2. 对缺失条件做保守补全：未指定时间默认近 90 天；未指定地区默认全国；未指定公告类型默认采购意向、招标公告、中标/成交结果、合同公告。

### 步骤3：选择接口并发起查询

1. 对口语化问题优先调用 `aiSearchSubmitPolling` 生成搜索条件；涉及行业短语时调用 `industryReasoning` 辅助行业识别。
2. 搜索公告优先调用 `SearchProjectForAI`；需要更完整筛选、分页或统计时调用 `searchProjectApi`。
3. 命中结果后，根据用户需求二次调用 `getZTBStructreDetail`、`getZTBProjectDetail`、`getZTBProjectFiles` 或 `getCollectUrl`。
4. 合同类需求调用 `searchProjectContactApi`；拟在建类需求调用 `searchNZJProjectApi`，必要时再调用 `getNZJProjectDetail` 和 `getNZJProjectFileList`。
5. 接口映射与参数细节见 `references/api-mapping.md`。

### 步骤4：结果过滤与输出

1. 输出前过滤明显无关内容，保留查询条件、排序逻辑、项目列表、重点字段和后续建议。
2. 输出时必须展示「识别出的条件」和「自动补全的条件」，让用户知道搜索依据。

## 默认查询规则

- 默认地区：全国。用户提到省、市、区县、园区或开发区时，按用户指定地区收窄。
- 默认时间：近 90 天。用户说「今年」按当年 1 月 1 日至当前日期；说「近一年」按最近 12 个月。
- 默认公告阶段：采购意向、招标公告、竞争性磋商、竞争性谈判、单一来源采购、中标/成交结果、合同公告。
- 默认采购类型：不限定；用户出现工程、货物、服务时自动映射采购分类。
- 默认关键词：优先使用用户原词；再扩展同义词、品类词、行业词、常见写法和上下游词。
- 默认排除词：招聘、考试、培训、会议、讲座、新闻、科普、通知、人员公示、表彰、租房。
- 默认排序：优先展示相关性高、发布时间近、金额明确、采购单位清楚、有附件或可追溯原文的项目。

## AI 搜索规则

- 当用户输入是完整句子或多条件混合描述时，先调用 `aiSearchSubmitPolling` 生成结构化搜索条件。
- 当用户只输入行业短语，如“智慧城市”“医疗设备”“水利工程”“政务云”时，可先调用 `industryReasoning` 识别行业方向，再组合关键词搜索。
- 当 AI 改写结果过窄导致结果为空时，保留核心词，放宽地区、时间、公告类型或删除低置信度限制。
- 当 AI 改写结果过宽导致噪声较多时，增加排除词、金额区间、采购类型、公告阶段或精确采购单位。
- 输出时必须展示“识别出的条件”和“自动补全的条件”，让用户知道搜索依据。

## 接口调用顺序

| 用户意图 | 首选接口 | 二次接口 | 输出重点 |
|---|---|---|---|
| 自然语言搜索 | `aiSearchSubmitPolling` | `SearchProjectForAI` / `searchProjectApi` | 自动识别条件、命中项目、相关性说明 |
| 普通公告搜索 | `SearchProjectForAI` | `getZTBStructreDetail` / `getCollectUrl` | 项目名称、地区、公告类型、时间、采购方、金额 |
| 高级筛选 | `searchProjectApi` | `getZTBStructreDetail` | 分页、金额、地区、行业、公告阶段 |
| 项目编号查询 | `getProjectByProjectNumber` | `getZTBProjectDetail` / `getCollectUrl` | 项目编号、项目详情、原始链接 |
| 重点项目详情 | `getZTBStructreDetail` | `getZTBProjectDetail` / `getZTBProjectFiles` | 结构化字段、正文要点、附件 |
| 合同公告查询 | `searchProjectContactApi` | `getCollectUrl` | 合同甲乙方、金额、时间、履约周期 |
| 拟在建项目 | `searchNZJProjectApi` | `getNZJProjectDetail` / `getNZJProjectFileList` | 项目阶段、建设内容、地区、业主单位 |
| 附件查询 | `getZTBProjectFiles` / `getNZJProjectFileList` | `getCollectUrl` | 附件名称、下载地址、来源链接 |
| 行业识别 | `industryReasoning` | `SearchProjectForAI` | 行业候选、关键词组合、检索建议 |

## 输出规范

- 先给出本次识别出的查询条件：关键词、地区、时间、公告类型、排除词、排序规则。
- 搜索结果用表格展示：项目名称、地区、公告类型、发布时间、采购单位、中标单位、金额、来源链接。
- 项目详情输出：采购需求、资格条件、关键时间、预算/成交金额、附件、原始公告链接、风险提示。
- 商机分析输出：推荐跟进等级、采购方价值、预算金额、当前阶段、竞争强度、下一步动作。
- 合同分析输出：甲方、乙方、合同金额、合同周期、项目来源、是否可形成续约或竞品跟踪线索。
- 拟在建分析输出：项目阶段、建设内容、投资额、建设单位、地区、审批/备案线索、后续招采可能性。
- 字段缺失时写“公告未披露”或“不详”，不得编造金额、联系人、附件或链接。

## 异常处理

| 场景 | 处理方式 |
|---|---|
| 未配置 API Key | 提示用户按「服务开通」章节获取并配置 `BBIAO_API_KEY` |
| 认证失败 | 检查 API Key 是否正确、是否过期、是否具备接口权限 |
| 额度不足 | 提示用户联系世舶科技商务人员处理套餐或额度 |
| 参数错误 | 检查必填参数、日期格式、分页、金额范围、地区和公告类型 |
| 结果为空 | 扩展同义词，放宽时间、地区、公告阶段或删除低置信度限制 |
| 结果过多 | 增加行业、地区、金额、采购单位、公告类型和排除词 |
| 详情接口无返回 | 保留搜索摘要，并说明详情、附件或原始链接未返回 |

## 不应做的事情

- 不新增医疗、教育、地区、企业画像等专用接口；只复用本技能 展示的 13 个接口。
- 不使用竞品 API 地址、Key 名称、请求头、工具名或文案。
- 不把招聘、考试、培训、会议、新闻、人员公示等内容当作招投标商机。
- 不编造公告、金额、联系人、附件、投标截止时间或中标单位。
- 不承诺数据百分百无遗漏；输出应基于接口返回结果和可追溯来源。

## 示例用户问题

- 帮我查近 30 天北京人工智能相关招标项目。
- 查全国最近一周中标金额 500 万以上的软件开发项目。
- 我想找“医院智慧病房建设”相关商机，帮我自动识别条件搜索。
- 查询项目编号 HNXW-202605028 对应的公告。
- 帮我找广东近三个月学校空调采购招标和中标结果。
- 查某公司近一年参与过哪些弱电工程项目。
- 搜索湖北物业服务合同公告，并按金额排序。
- 帮我把“浙江今年政务云采购项目”改写成 API 查询条件。
- 查最近 90 天全国拟在建数据中心项目。
- 获取这个项目的结构化详情、附件和原始公告链接。
- 找近半年水利工程中标公告，排除招聘和培训信息。
- 分析某个关键词最近的招标商机，告诉我哪些值得跟进。

使用说明

# 全国招投标 AI 检索助手

面向全国范围的招投标数据检索：自动识别自然语言中的地区、行业、公告阶段、金额与时间条件，查询招标公告、中标结果、合同公告、拟在建项目和项目详情，输出结构化、可追溯的结果。

## 使用

先配置数据服务密钥（环境变量）：

```bash
export BBIAO_API_KEY="你的密钥"        # 获取方式见 SKILL.md「服务开通」
```

然后直接对话：

```text
查全国近 90 天数据中心拟在建项目
找广东近三个月学校空调采购的招标和中标结果
搜索湖北物业服务合同公告，按金额排序
```

输出包含识别出的查询条件、项目列表表格（地区、公告类型、时间、采购单位、金额）、详情与附件、原始公告链接。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。