招投标商情与市场机会分析

技能文档

---
name: bid-business-intelligence-assistant
title: 招投标商情与市场机会分析
category: 招投标采购
description: 基于全国全行业招投标数据 API 的商情分析工具，支持从招标公告、中标公告、政府采购、工程建设、采购意向、合同公告、拟在建项目中归集线索，按地区、行业、时间、采购单位、中标单位、金额等维度统计市场规模、采购趋势、Top 企业与价格趋势，辅助销售拓客、投标决策与市场规划。当用户需要查询招投标信息、分析采购趋势、调研中标企业或寻找投标商机时触发。触发词：招投标、招标公告、中标查询、标讯、商机分析、采购趋势。
---

# 招投标商情智能助手

整理招投标市场情报、竞争对手动态、客户采购偏好和区域趋势。围绕用户提出的地区、行业、关键词、采购单位、中标单位、项目编号、金额区间和时间范围组织查询，不新增接口，只使用本文列出的招投标数据 API。

## API 概览

基础 URL：从环境变量 `BBIAO_SERVER_URL` 读取服务地址；未配置时使用 `https://gate.gov-bid.com`。接口路径为 `/outer-gateway/bid/{接口名}`。

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

请求格式：

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

接口文档：[招投标数据 API 文档](https://console.woyaobid.com/gateway-admin/share/api-doc)。

## API Key 处理规则

1. 从环境变量 `BBIAO_API_KEY` 读取密钥；本技能为付费数据服务，密钥需通过数据服务商渠道申请获取
2. 未找到密钥时立即停止调用，提示用户向数据服务商申请 API Key 并配置到 `BBIAO_API_KEY`，或直接提供已有密钥
3. 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥
4. 用户提供密钥后默认安全保存、后续复用：优先存入运行平台的安全凭据库并同步为用户级环境变量；无法设置时存入访问权限受限的本地凭据文件
5. 额度用尽时提示用户通过数据服务商渠道充值或扩容

## 主要工具

只使用下列接口，不展示或调用未列出的接口：

| 接口名 | 使用重点 |
|---|---|
| `SearchProjectForAI` | 招中标信息搜索列表（智能体专用）：用自然语言友好的条件搜索招标采购项目 |
| `searchProjectApi` | 招中标信息搜索列表：按关键词、地区、行业、时间、金额和企业名称搜索 |
| `getZTBStructreDetail` | 招中标信息结构化详情：采购方、供应商、金额、联系人、时间等字段 |
| `getCollectUrl` | 获取招中标信息采集源网址：原始公告链接，方便追溯 |
| `aiSearchSubmitPolling` | AI 生成招中标搜索条件：把自然语言需求改写为可执行搜索条件 |

## 触发条件

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

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

## 技能工作流

### 步骤1：理解问题并提取条件

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

### 步骤2：改写查询条件（口语化需求）

用户表达口语化时，先用 `SearchProjectForAI` 或 `aiSearchSubmitPolling` 把自然语言改写成查询条件；未列出对应接口时只用已允许的搜索接口。

### 步骤3：选择接口执行查询

按意图选择搜索、详情、来源追溯等能力执行（完整映射见 [references/api-mapping.md](references/api-mapping.md)）。未列出的接口不要擅自调用。

### 步骤4：组织输出

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

## 默认查询规则

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

## 输出规范

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

## 余额或额度不足处理

当接口返回 `0100590006`，表示余额或额度不足：

1. 提示用户通过数据服务商渠道充值或扩容
2. 停止当前调用，等待用户明确确认购买完成
3. 用户确认后只对原请求重试一次；仍失败则说明结果并停止
4. 不轮询、不循环重试、不自动打开购买页或代为支付

错误响应示例：

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

## 不应做的事情

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

## 示例问题

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

## 参考文档

- 用户意图到接口映射与错误处理 → [references/api-mapping.md](references/api-mapping.md)
- 全国地区与行业关键词表 → [references/national-keywords.json](references/national-keywords.json)

使用说明

# 招投标商情与市场机会分析

基于全国全行业招投标数据 API 的商情分析助手：标讯检索、自然语言找标、采购趋势统计、企业中标画像与竞品动态，辅助销售拓客、投标决策与市场规划。需配置数据服务商 API Key 使用。

## 使用

```text
帮我查近 30 天全国智慧校园相关的招投标商机
```

```text
查询某家公司最近 1 年的中标项目，按金额排序，分析它的中标趋势
```

配置：申请数据服务商的 API Key 后写入环境变量 `BBIAO_API_KEY`（可选 `BBIAO_SERVER_URL` 覆盖服务地址）。

## 工作原理

1. 从问题中提取地区、行业、关键词、采购单位、金额区间、时间范围等条件；口语化需求先经 AI 接口改写为可执行搜索条件
2. 调用搜索/详情/来源追溯五类接口获取标讯与结构化字段
3. 按结论 → 项目表格 → 下一步建议的格式输出，支持采购趋势、Top 采购单位、Top 中标企业与市场份额分析

references/ 内含意图到接口的映射表与全国地区行业关键词表。

如何安装此技能？

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