全行业竞争对手招投标分析助手

技能文档

---
name: lanshan-competitor-bid-analysis
title: 全行业竞争对手招投标分析助手
category: 招投标采购
description: 基于全国招投标数据 API 的竞争对手分析助手，覆盖竞品中标监控、客户覆盖、供应商关系、项目金额结构与区域布局对比。当用户分析竞争对手中标情况、对比企业投标轨迹、查找客户重叠与切入机会时触发。触发词：竞争对手分析、竞品中标监控、企业画像、客户重叠、中标记录。
---

# 全行业竞争对手招投标分析助手

面向全国、全行业招投标数据场景，用于竞争对手分析、中标监控、客户覆盖、供应商关系、项目金额结构、区域布局和行业趋势对比。本技能不新增 API，只复用全国全行业招投标数据 API；根据用户自然语言自动识别关键词、地区、行业、时间、公告类型、采购单位、中标单位、企业名称、项目编号、金额区间和排除词，输出可追溯、可复核、可行动的分析结果。

接口白名单与调用映射见 [references/api-mapping.md](references/api-mapping.md)。

## 技能工作流

### 步骤1：配置 API Key

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

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

判断用户是在查项目、找商机、看竞争、看合同关系、做中标复盘、分析文件还是生成投标准备材料。

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

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

### 步骤4：调用接口查询

按接口白名单选择调用顺序（企业画像 → 合作客户/供应商 → 标讯搜索 → 结构化详情，见参考文档的「用户意图到接口映射」）；白名单外的接口不要擅自调用。搜索结果不足时，扩展同义词、放宽时间或地区；结果过多时，增加精确关键词、采购单位、金额范围和排除词。

**请求格式**：

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

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

### 步骤5：过滤与整理

输出前过滤招聘、考试、培训、会议、新闻、人员公示等明显无关内容。

### 步骤6：输出竞争情报战报

分析型结论必须标明依据字段，区分接口返回事实、统计口径和基于数据的判断建议。默认输出「30 秒可读竞争情报战报」，重点帮助用户判断竞争对手在做什么、客户在哪里、我方如何切入：

1. 一句话结论：概括竞争对手近期中标强度、重点区域、重点客户和潜在威胁。
2. 你必须知道的 5 件事：列出中标项目、采购单位、金额、地区、时间、合作客户、供应商关系等关键事实。
3. 竞争态势：分析客户重叠、行业覆盖、区域布局、金额区间、项目类型和连续中标情况。
4. 我方机会：指出可切入客户、可避开的强势区域、可重点关注的采购单位和替代机会。
5. 下一步动作：建议继续查询对手历史合同、Top 客户、供应商网络、重点项目详情或原始公告。

涉及企业比较时，用表格列出企业、项目数、金额、地区、采购单位、代表项目和来源。结论必须注明数据口径和样本范围。

## 默认查询规则

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

## 余额或额度不足处理

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

1. 提供固定购买页：[API 套餐购买页](https://console.api.gov-bid.com/bbiao-gateway/package)。
2. 停止当前调用，等待用户明确确认购买完成。
3. 用户确认后，只对原请求重试一次；若仍失败，说明结果并停止。
4. 不轮询、不循环重试、不自动打开购买页或代为支付。

## 不应做的事情

- 不新增接口文档之外的接口。
- 不使用竞品 API 地址、Key 名称、请求头、工具名或文案。
- 不把无来源的推测当成招投标事实。
- 不承诺一定中标、必中项目或规避招投标规则。
- 不展示本技能未允许的接口作为可调用工具。

## 示例用户问题

- 分析某竞争对手近一年在哪些地区和行业中标最多，并给我竞争情报战报。
- 查询两家公司是否服务过相同采购单位，列出重叠客户和可能冲突项目。
- 帮我找某竞品企业近期中标项目、金额和采购单位。
- 判断某公司主要合作客户、供应商关系和可切入机会。
- 对比某行业 Top 竞争对手的项目类型、区域布局和金额区间。

使用说明

# 全行业竞争对手招投标分析助手

基于全国招投标数据 API 的竞争对手分析工具：监控竞品中标动态、分析客户覆盖与供应商关系、对比金额结构与区域布局，输出竞争情报战报。

## 使用

```text
分析某竞争对手近一年在哪些地区和行业中标最多
```

```text
查一下这两家公司有没有服务过相同的采购单位
```

首次使用需配置环境变量 `BBIAO_API_KEY`（数据服务按次计费）。

## 工作原理

从自然语言中抽取企业与查询条件，依次调用企业画像、合作客户/供应商关系、标讯搜索与结构化详情接口，输出「30 秒可读竞争情报战报」：一句话结论、必知关键事实、竞争态势（客户重叠/区域布局/连续中标）、我方切入机会与下一步动作，企业对比以表格呈现并注明数据口径。

如何安装此技能？

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