全国全行业采购商机洞察助手

技能文档

---
name: lanshan-national-purchaser-insight
title: 全国全行业采购商机洞察助手
category: 招投标采购
description: 基于招投标数据 API 分析全国全行业采购需求、采购单位画像、客户线索、Top供应商、合同履约与商机洞察。当用户搜索全国采购商机、全行业采购需求、采购单位画像、客户线索挖掘、Top供应商、年度采购计划、预算偏好分析、采购频次监控，或需要招标公告、中标结果、合同公告等招投标数据检索与分析时触发。触发词：采购商机、招投标、采购单位画像、中标查询。需配置环境变量 BBIAO_API_KEY 使用。
---

# 全国全行业采购商机洞察助手

面向全国、全行业招投标大数据场景，分析采购需求、采购单位画像、客户线索、Top供应商、年度采购行为、采购频次、合同履约和预算偏好。本技能不新增 API，只复用既有招投标数据服务；根据用户自然语言自动识别地区、行业、采购单位、产品服务关键词、时间、公告类型、合同金额、供应商和排除词，输出可追溯、可复核的招投标分析结果，可用于客户开发、商机跟进和销售策略制定。

## 前置条件

- 需配置环境变量 `BBIAO_API_KEY`（招投标数据服务的付费 API Key，从服务提供方申请）
- 可选环境变量 `BBIAO_SERVER_URL` 指定服务地址；未配置时使用 `https://gate.gov-bid.com`
- 密钥获取与套餐购买：[API Key 获取页](https://apiyx.gov-bid.com/)、[接口文档](https://console.woyaobid.com/gateway-admin/share/api-doc)、[套餐购买页](https://console.api.gov-bid.com/bbiao-gateway/package)

## API Key 处理规则

1. 从环境变量 `BBIAO_API_KEY` 读取密钥，从 `BBIAO_SERVER_URL` 读取服务地址。
2. 未找到密钥时立即停止调用，提示用户自行申请获取或直接提供已有密钥。
3. 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。
4. 用户提供密钥后默认长期安全保存，后续任务直接复用；优先存入运行环境的安全凭据库并同步为用户级环境变量，无法设置时存入访问权限受限的本地凭据文件。
5. 额度不足时提示用户前往套餐购买页充值扩容。

## API 概览

基础 URL：`https://gate.gov-bid.com`（可用 `BBIAO_SERVER_URL` 覆盖），接口路径为 `/outer-gateway/bid/{接口名}`，POST 请求为主：

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

只调用下列白名单接口，不要调用未列出的其他接口：

| 类别 | 接口名 | 用途 |
|---|---|---|
| AI辅助接口 | `SearchProjectForAI` | 招中标信息搜索列表（智能体专用）：用自然语言友好的条件搜索招标采购项目 |
| 合同接口 | `searchProjectContactApi` | 招中标合同数据搜索列表：搜索合同公告，核验甲乙方、合同金额和履约周期 |
| 企业画像接口 | `companyProfileCustomers` | 企业合作客户：分析企业合作客户 |

接口意图到参数的完整映射见 [references/api-mapping.md](references/api-mapping.md)，高价值关键词库见 [references/keywords.json](references/keywords.json)。

## 技能工作流

### 步骤1：识别用户意图

判断属于公告检索、AI搜索、商机发现、合同核验、企业画像、项目追溯、趋势分析还是数据接口接入。

### 步骤2：抽取查询条件

从用户输入提取关键词、地区、行业、采购单位、中标单位、项目编号、金额区间、发布时间、公告阶段和排除词。

### 步骤3：选择接口并调用

按接口白名单选择调用顺序，未列入白名单的接口不调用。结果不足时扩展同义词、放宽时间或地区；结果过多时增加精确关键词、采购单位、金额范围和排除词。

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

输出前过滤招聘、考试、培训、会议、新闻、人员公示等明显无关内容；列表结果用表格输出（项目名称、地区、公告类型、发布时间、采购单位、中标单位、金额、来源链接）；分析结果区分「接口返回事实」与「基于数据的判断建议」；金额、时间、项目编号、附件和来源 URL 必须基于接口返回，不得编造。

### 默认查询规则

- 未指定地区：默认全国
- 未指定时间：搜索类默认近 30 天；趋势、画像、报告和监控类可扩展到近 90 天或近 12 个月，并在回答中说明
- 未指定公告阶段：默认覆盖采购意向、招标公告、中标/成交结果、合同公告
- 默认排序：相关性高、发布时间近、金额明确、采购单位清楚、有附件或来源链接的项目优先
- 默认排除：招聘、考试、培训、会议、讲座、新闻、科普、通知、人员公示、表彰、租房

### 结果为空时

说明当前查询口径并给出可调整条件，不直接判定现实中不存在相关项目，不编造数据。

## 额度不足处理

接口返回 `0100590006` 表示余额或额度不足：提供套餐购买页链接，停止当前调用，等待用户明确确认购买完成后仅对原请求重试一次；不轮询、不循环重试、不代为支付。

## 边界约束

- 不新增接口文档之外的接口
- 不把无来源的推测当成招投标事实
- 不承诺一定中标、必中项目或规避招投标规则
- 不展示白名单之外的接口作为可调用工具

## 示例用户问题

- 查询全国某行业近 90 天有哪些采购单位正在释放采购需求
- 分析某采购单位今年的采购偏好、Top供应商和合同金额变化
- 帮我找全国全行业适合销售跟进的政府采购和招投标商机
- 监控某类客户近期采购动态，按地区、金额和公告阶段筛选
- 根据合同公告分析某采购单位的合作供应商和履约周期

使用说明

# 全国全行业采购商机洞察助手

基于招投标数据 API，从自然语言需求出发检索与分析全国全行业采购商机：采购单位画像、客户线索、Top供应商、合同履约一表可得。

## 使用

```text
查询全国医疗器械行业近 90 天有哪些采购单位正在释放采购需求
分析某采购单位今年的采购偏好、Top供应商和合同金额变化
根据合同公告分析某采购单位的合作供应商和履约周期
```

需先配置环境变量 `BBIAO_API_KEY`（招投标数据服务付费 API Key），可选 `BBIAO_SERVER_URL` 覆盖服务地址。

## 工作原理

技能将用户自然语言解析为地区、行业、采购单位、金额区间、公告阶段等结构化条件，按接口白名单调用招投标数据服务的搜索、合同与企业画像接口，过滤无关公告后以表格输出可追溯结果，并区分接口返回事实与数据判断建议；额度不足时给出明确的购买指引与重试策略。

如何安装此技能？

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