全国招投标数据自动化分析助手

技能文档

---
name: shibo-auto-bid-analysis
title: 全国招投标数据自动化分析助手
category: 招投标采购
description: 全国招投标数据自动化分析助手。基于招投标数据服务接口（需配置 BBIAO_API_KEY），用于自动化检索、批量分析、趋势摘要、商机筛选与关键词监控，支持招标公告、中标结果、合同公告、拟在建项目等数据的定时任务规划、聚合维度设计与结构化输出。当用户需要搭建招投标自动化分析流程、批量查询标讯、生成定期商机报告或设置标讯监控条件时触发。触发词：招投标自动化分析、批量标讯查询、中标趋势分析、商机监控、招标数据接口、定期商机报告。
---

# 全国招投标数据自动化分析助手

面向自动化场景的招投标数据分析工具：自动化检索、批量分析、趋势摘要和商机筛选。本技能基于招投标数据服务的通用接口，自动选择搜索、合同、拟在建、AI 条件生成等接口，把通用标讯数据整理成可追溯、可分析、可接入的结果。

## 技能工作流

### 步骤1：检查服务可用性

1. 从环境变量 `BBIAO_API_KEY` 读取密钥；从 `BBIAO_SERVER_URL` 读取服务地址，未配置时使用 `https://gate.gov-bid.com`。
2. 未找到密钥时立即停止调用，提示用户按「服务开通」章节获取并配置，或在运行环境的安全凭据中提供已有密钥。
3. 密钥安全规则：不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥；用户提供密钥后长期安全保存，后续任务直接复用。

### 步骤2：意图识别与接口选择

1. 判断用户意图属于哪类：招中标列表检索、合同公告查询、拟在建项目搜索、自然语言条件生成或行业方向识别。
2. 抽取关键词、地区、时间、公告类型、采购单位、中标单位、金额范围和排除词；未指定地区默认全国，未指定时间默认近 30 天。
3. 只在「主要工具」列出的接口范围内选择调用顺序，不调用未列出的接口。
4. 接口映射与参数补全细节见 `references/api-mapping.md`。

### 步骤3：批量与自动化执行

1. 自动化任务应限制分页、时间窗口和重试次数，避免无限循环。
2. 搜索结果不足时按「同义词扩展 → 放宽时间 → 放宽地区 → 减少排除词」顺序调整后重查。
3. 输出监控条件、分析频率、结果字段、失败处理和人工复核规则，便于接入定时任务。

### 步骤4：结果整理与输出

1. 先说明本次识别出的查询条件和自动补全条件。
2. 按「输出规范」以表格或结构化形式交付。
3. 字段缺失时写「公告未披露」或「不详」，不得编造公告、金额、联系人、附件或链接。

## 服务开通

1. 获取 API Key：访问数据服务方获取页 `https://apiyx.gov-bid.com/`（可免费获取试用额度），或将已有密钥配置到环境变量 `BBIAO_API_KEY`。
2. 套餐购买：访问 `https://console.api.gov-bid.com/bbiao-gateway/package`，或通过阿里云商品页 `https://market.aliyun.com/detail/cmapi00066410` 购买。
3. 接口文档：`https://console.woyaobid.com/gateway-admin/share/api-doc`。
4. 错误码 `0100590006` 表示余额或额度不足：提示用户通过套餐购买页充值，只有用户明确确认购买完成后，才对原请求重试一次；仍失败则说明结果并停止，不轮询、不循环重试、不自动打开购买页或代为支付。

## 接入方式

### 1. 直接 HTTP API

```text
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 Server 的 AI 客户端

### 3. CLI

运行环境已安装 `bbiao-search` 时，可使用 CLI 调用通用能力：

```text
bbiao-search <command> [options]
```

### 4. Agent 环境

在各类支持技能的 Agent 环境中使用时，优先配置环境变量 `BBIAO_API_KEY`。

## 主要工具

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

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

## 使用重点

- 面向自动化分析，重点是批量检索、定时条件、聚合维度和异常处理。
- 适合做定期商机报告、区域趋势、关键词监控和合同更新分析。
- 余额不足、认证失败、结果为空要分别处理，不能自动购买或循环重试。

## 输出规范

- 搜索结果用表格输出：项目名称、地区、公告类型、发布时间、采购方、中标方、金额、链接。
- 详情解析输出：采购需求、资格条件、关键时间、金额、附件、原始公告链接和风险提示。
- API 接入类输出：推荐接口、必要参数、自动补全参数、调用顺序、错误处理和示例请求体。
- 数据入库 / RAG 类输出：字段映射、去噪规则、唯一键建议、原文链接、附件链接和可追溯信息。

## 错误处理

| 场景 | 处理方式 |
|---|---|
| 未配置 API Key | 提示用户先获取并配置 `BBIAO_API_KEY` |
| 认证失败 | 检查 API Key 是否正确、是否过期、是否有接口权限 |
| 余额不足 / 额度耗尽 | 提供套餐购买页，停止调用并等待用户确认 |
| 参数错误 | 检查必填参数、日期格式、分页、金额范围、公告类型和地区参数 |
| 结果为空 | 扩展同义词，再扩大时间、地区和公告阶段 |
| 详情不可用 | 返回搜索摘要，并说明详情接口未返回可用正文或附件 |

错误响应示例（`0100590006` 余额或额度不足）：

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

## 执行规则

- 调用接口前必须检查 `BBIAO_API_KEY`。
- 只使用本技能接口清单内的接口，不使用竞品 API 地址、请求头或 Key 名称。
- 不把招聘、考试、培训、会议、新闻、人员公示等内容当成采购商机。
- 输出应说明自动补全条件，例如默认地区、时间范围、公告阶段和排除词。

## 示例问题

- 帮我设计每天自动查询智慧城市招标的流程。
- 批量分析近 30 天中标公告需要哪些接口？
- 如何设置标讯监控条件和排除词？
- 自动化任务遇到 0100590006 怎么处理？
- 生成一个每周招投标趋势分析模板。
- 如何避免批量查询返回太多无关结果？

使用说明

# 全国招投标数据自动化分析助手

面向自动化场景的招投标数据分析技能：批量检索全国招标、中标、合同、拟在建数据，设计关键词监控条件与定时分析流程，输出结构化商机报告和趋势摘要。

## 使用

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

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

然后直接对话：

```text
帮我设计每天自动查询智慧城市招标的流程
批量分析近 30 天中标公告，按地区和行业聚合
生成一个每周招投标趋势分析模板
```

## 工作原理

识别分析意图后从接口白名单中选择搜索、合同、拟在建或 AI 条件生成接口，按默认参数补全（全国、近 30 天）批量调用，限制分页与重试次数，最终按统一表格输出可追溯的结构化结果。

如何安装此技能？

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