招投标智能搜索助手

技能文档

---
name: shibo-smart-bid-search
title: 招投标智能搜索助手
category: 招投标采购
description: 招投标智能搜索助手。用于根据用户输入的行业、产品、地区、采购单位、供应商、预算金额、发布时间或一句自然语言描述，自动补全招投标检索条件并调用全国全行业招投标数据 API，查询招标公告、中标结果、合同公告、拟在建项目、附件和原始采集链接。适合招投标数据查询、招投标数据 API 接入、商机筛选、项目跟进和多字段结构化检索场景。触发词：招投标搜索、标讯查询、招标公告、中标结果、查商机、拟在建项目、招投标数据接口。
---

# 招投标智能搜索助手

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

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

## 服务开通

1. 网页获取：访问数据服务商的 API Key 获取页申请密钥，配置到环境变量 `BBIAO_API_KEY`。
2. 未配置密钥时技能无法调用接口，会提示用户先完成开通。
3. 也可通过服务商提供的阿里云商品页购买套餐后按接口文档配置。

## API Key 处理规则

1. 从环境变量 `BBIAO_API_KEY` 读取密钥。
2. 从环境变量 `BBIAO_SERVER_URL` 读取服务地址；未配置时使用 `https://gate.gov-bid.com`。
3. 未找到密钥时立即停止调用，并提示用户获取密钥后在运行环境的安全凭据或用户级环境变量中配置。
4. 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。
5. 用户提供密钥后，默认长期安全保存，后续任务直接复用，无需重复询问。
6. 用户使用额度不足时，提示用户通过服务商的套餐购买页充值或扩容，并等待用户确认后再按规则重试。

## 引用文件

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

- `references/api-mapping.md`：本技能允许展示和调用的接口清单、用户意图映射、参数补全和错误处理。
- `references/ai-search-keywords.json`：AI 搜索触发词、排除词、公告类型、默认时间范围和输出字段。

## 主要工具

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

| 类别 | 接口名 | 用途 |
|---|---|---|
| 招中标接口 | `SearchProjectForAI` | 招中标信息搜索列表：用自然语言友好的条件搜索招标采购项目 |
| 招中标接口 | `searchProjectApi` | 招中标信息搜索列表：按关键词、地区、行业、时间、金额和企业名称搜索 |
| 招中标接口 | `getProjectByProjectNumber` | 根据项目编号或标号查询招中标信息列表 |
| 招中标接口 | `getZTBStructreDetail` | 招中标信息结构化数据详情：采购方、供应商、金额、联系人、时间等 |
| 招中标接口 | `getZTBProjectFiles` | 招中标信息附件列表：招标文件、采购需求、合同附件等 |
| 招中标接口 | `getCollectUrl` | 获取招中标信息采集源网址，方便追溯原始公告 |

## 技能工作流

### 步骤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. AI 改写结果过窄导致结果为空时，保留核心词，放宽地区、时间、公告类型或删除低置信度限制。
3. AI 改写结果过宽导致噪声较多时，增加排除词、金额区间、采购类型、公告阶段或精确采购单位。

### 步骤5：结构化输出

展示「识别出的条件」和「自动补全的条件」，再按输出规范呈现项目列表、重点字段和后续建议。

## 默认查询规则

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

## 接口调用顺序

| 用户意图 | 首选接口 | 二次接口 | 输出重点 |
|---|---|---|---|
| 自然语言搜索 | `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 是否正确、是否过期、是否具备接口权限 |
| 额度不足 | 提示用户通过套餐购买页充值或扩容，确认后再重试一次 |
| 参数错误 | 检查必填参数、日期格式、分页、金额范围、地区和公告类型 |
| 结果为空 | 扩展同义词，放宽时间、地区、公告阶段或删除低置信度限制 |
| 结果过多 | 增加行业、地区、金额、采购单位、公告类型和排除词 |
| 详情接口无返回 | 保留搜索摘要，并说明详情、附件或原始链接未返回 |

## 注意事项

- 不新增接口；只复用本技能列出的接口白名单。
- 不使用竞品 API 地址、Key 名称、请求头、工具名或文案。
- 不把招聘、考试、培训、会议、新闻、人员公示等内容当作招投标商机。
- 不编造公告、金额、联系人、附件、投标截止时间或中标单位。
- 不承诺数据百分百无遗漏；输出应基于接口返回结果和可追溯来源。
- 不轮询、不循环重试、不自动打开购买页或代为支付。

## 示例用户问题

- 帮我查近 30 天北京人工智能相关招标项目。
- 查全国最近一周中标金额 500 万以上的软件开发项目。
- 我想找「医院智慧病房建设」相关商机，帮我自动识别条件搜索。
- 查询项目编号 HNXW-202605028 对应的公告。
- 帮我找广东近三个月学校空调采购招标和中标结果。
- 搜索湖北物业服务合同公告，并按金额排序。
- 查最近 90 天全国拟在建数据中心项目。
- 找近半年水利工程中标公告，排除招聘和培训信息。

使用说明

# 招投标智能搜索助手

一句话自然语言搜索全国招标、中标、合同、拟在建项目：自动识别并补全行业、地区、时间、金额等检索条件，调用招投标数据接口返回结构化结果，附原始公告链接可追溯。

## 使用

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

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

然后直接对话：

```text
帮我查近 30 天北京人工智能相关招标项目
我想找"医院智慧病房建设"商机，帮我自动识别条件搜索
查全国最近一周中标金额 500 万以上的软件开发项目
```

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

如何安装此技能？

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