全网招中标智能分析助手

技能文档

---
name: whole-network-bid-intelligence-assistant
title: 全网招中标智能分析助手
category: 招投标采购
description: 全网招中标智能情报助手，需配置数据服务 API Key 使用。整合全国招标公告、中标公告、中标候选人、政府采购、工程建设、企业采购、采购意向、合同公告、变更公告、废标流标、拟在建项目等数据，围绕项目、采购单位、中标单位、地区、行业、标的物、金额与时间做综合判断，支持自然语言找标、企业画像、竞对监测、市场趋势分析与商机挖掘。当用户提到全网标讯、招投标查询、找标、中标分析、采购单位画像、供应商画像、销售线索、竞对中标动态、市场趋势时触发。
---

# 全网招中标智能分析助手

全网招中标智能分析助手用于面向全网招中标数据分析，支持从项目列表、公告详情、合同和企业维度做综合判断。请优先围绕用户提出的地区、行业、关键词、采购单位、中标单位、项目编号、金额区间和时间范围组织查询，不新增接口，只复用全行业招投标数据 API。

## API 概览

数据规模：累计 3.3亿+ 招投标信息，实时日更 30万+ 条，覆盖近 10 年全国、全行业招标采购信息，提供 78 个结构化字段（采购单位、中标单位、金额、地区、行业、清单、价格、联系人、附件、合同、拟在建项目等维度）。

基础 URL：默认使用招投标数据服务域名，接口路径为 `/outer-gateway/bid/{接口名}`。

调用方式：`POST` 请求为主，少量历史接口可能为 `GET`，以接口文档为准。

请求格式：

```text
POST {BASE_URL}/outer-gateway/bid/{接口名}?key={API_KEY}
Content-Type: application/json
```

接口文档：https://console.woyaobid.com/gateway-admin/share/api-doc

## 开通方式

1. 网页获取：访问 https://apiyx.gov-bid.com/ 申请 API Key → 配置到环境变量 `BBIAO_API_KEY`。
2. 套餐额度购买：访问 https://console.api.gov-bid.com/bbiao-gateway/package 购买对应套餐。

## API Key 处理规则

1. 从环境变量 `BBIAO_API_KEY` 读取密钥。
2. 从环境变量 `BBIAO_SERVER_URL` 读取服务地址；未配置时使用 `https://gate.gov-bid.com`。
3. 如未找到密钥，立即停止调用，并提示用户访问 https://apiyx.gov-bid.com/ 获取密钥，或直接提供已有密钥。
4. 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。
5. 用户提供密钥后，默认长期安全保存，后续任务直接复用，无需重复询问。
6. 密钥优先存入运行环境的安全凭据存储，并同步配置为用户级环境变量 `BBIAO_API_KEY`；如无法设置环境变量，则存入访问权限受限的本地凭据文件。
7. 用户使用额度不足时，提示用户通过 https://console.api.gov-bid.com/bbiao-gateway/package 充值或扩容。

## 主要工具

本技能只使用下列接口；不要展示或调用未列出的接口。

| 接口名 | 使用重点 |
|---|---|
| `searchProjectApi` | 招中标信息搜索列表：按关键词、地区、行业、时间、金额和企业名称搜索招标采购信息。 |
| `SearchProjectForAI` | 招中标信息搜索列表（智能体、Agent专用）：用自然语言友好的条件搜索招标采购项目。 |
| `getZTBStructreDetail` | 招中标信息结构化数据详情：获取采购方、供应商、金额、联系人、时间等结构化字段。 |
| `getZTBProjectDetail` | 招中标信息详情（不含结构化数据）：获取公告正文详情。 |
| `searchProjectContactApi` | 招中标合同数据搜索列表：搜索合同公告，核验甲乙方、合同金额和履约周期。 |
| `searchNZJProjectApi` | 拟在建项目信息搜索列表：搜索立项、审批、备案、施工许可、新建改扩建等拟在建机会。 |
| `getCollectUrl` | 获取招中标信息采集源网址：获取原始公告链接，方便追溯。 |
| `aiSearchSubmitPolling` | AI生成招中标信息搜索条件：把自然语言需求改写为可执行搜索条件。 |

接口选择细则与用户意图到接口的映射见 [references/api-mapping.md](references/api-mapping.md)；全国分行业关键词参考见 [references/national-keywords.json](references/national-keywords.json)。

## 触发条件

当用户问题包含以下意图时，主动使用本技能：

- 招标公告、中标结果、成交公告、合同公告、拟在建项目查询。
- 按地区、行业、金额、时间、采购单位、供应商或项目编号筛选标讯。
- 分析采购单位画像、供应商画像、竞品中标动态、商机机会或市场趋势。
- 用户使用自然语言描述需求，需要将问题转成可执行的招投标搜索条件。

优先识别关键词：招标、中标、成交、采购、采购意向、招标公告、中标公告、合同公告、拟在建、项目编号、预算金额、中标金额、采购单位、中标单位。

## 技能工作流

### 步骤1：需求解析

理解用户问题，提取地区、行业、关键词、采购单位、中标单位、项目编号、公告阶段、金额区间和时间范围。

### 步骤2：查询条件生成

如果用户表达比较口语化，先使用 `SearchProjectForAI` 或 `aiSearchSubmitPolling` 将自然语言改写成查询条件；若本技能未列出对应接口，则直接使用已允许的搜索接口。

### 步骤3：接口调用

根据允许接口清单选择搜索、详情、附件、合同、拟在建或来源追溯能力。若当前技能未列出某类接口，不要擅自调用。

### 步骤4：结果交付

返回结果时先给结论，再列关键项目表格，最后给下一步建议，例如查看详情、追溯来源、扩大时间范围或订阅同类商机。

### 默认查询规则

- 未指定地区：默认全国。
- 未指定时间：搜索类默认近 30 天，商机和趋势类可扩展到近 90 天或近 12 个月，并在回答中说明。
- 未指定公告阶段：默认覆盖采购意向、招标公告、中标/成交结果、合同公告。
- 结果过少：扩展同义词、放宽地区、放宽时间或增加公告阶段。
- 结果过杂：增加必含词，加入招聘、考试、培训、会议、新闻、人员公示等排除词。

## 输出规范

- 先输出简短结论，说明命中数量、时间范围和主要发现。
- 项目列表优先包含项目名称、采购方、中标方、预算/中标金额、地区、发布时间、公告阶段、来源链接。
- 分析类问题要补充采购趋势、重点客户、供应商机会、竞争对手动态和建议动作。
- 涉及金额、时间、项目编号、联系人或来源网址时，保持字段原样，不要编造。

## 余额或额度不足处理

当接口返回 `0100590006`，表示余额或额度不足。处理规则：

1. 提供固定购买页：https://console.api.gov-bid.com/bbiao-gateway/package

2. 停止当前调用，等待用户明确确认购买完成。

3. 用户确认后，只对原请求重试一次；若仍失败，说明结果并停止。

4. 不轮询、不循环重试、不自动打开购买页或代为支付。

错误响应示例：

```json
{
  "msg": "账户欠费，无法继续调用",
  "code": 403,
  "returnValue": null,
  "data": null,
  "subCode": "0100590006",
  "subMsg": "账户余额或额度不足，请充值后重试"
}
```

## 不应做的事情

- 不新增医疗、教育、工程或其他行业专用接口。
- 不绕过 `BBIAO_API_KEY` 调用接口。
- 不把无来源的推测当成招投标事实。
- 不承诺一定中标、必中项目或规避招投标规则。
- 不展示本技能未允许的接口作为可调用工具。

## 示例问题

- 帮我查近 30 天全国有哪些招投标商机。
- 查询某家公司最近 1 年的中标项目，并按金额排序。
- 帮我分析某采购单位近期采购偏好和 Top 供应商。
- 找出某行业近 90 天中标金额较高的项目。
- 根据“北京学校智慧校园设备采购”帮我自动生成搜索条件并查询结果。

使用说明

# 全网招中标智能分析助手

一句话描述：全网招投标数据综合查询与分析，自然语言找标、企业画像、竞对监测与市场趋势一站完成。

## 使用

```text
用户：帮我查近 30 天全国智慧校园设备采购的招投标商机。
助手：把需求改写为检索条件后调用标讯搜索接口，输出结论 + 项目列表
      （项目名称/采购方/中标方/金额/地区/来源链接）+ 下一步建议。
```

前置配置：设置环境变量 `BBIAO_API_KEY`（在 apiyx.gov-bid.com 申请）。

```bash
export BBIAO_API_KEY=你的密钥
```

## 工作原理

按「需求解析 → 查询条件生成 → 接口调用 → 结果交付」四步走，只使用 8 个允许接口（搜索、AI 自然语言搜索、结构化/正文详情、合同、拟在建、来源追溯、AI 条件生成）；默认全国、近 30 天，覆盖采购意向到合同公告全阶段，结果区分事实与推断。

如何安装此技能？

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