招标公告附件解析助手

技能文档

---
name: lanshan-bid-attachment-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：调用接口查询

按接口白名单选择调用顺序（附件列表 → 公告正文 → 采集源网址 → 项目编号追溯，见参考文档的「用户意图到接口映射」）；白名单外的接口不要擅自调用。搜索结果不足时，扩展同义词、放宽时间或地区；结果过多时，增加精确关键词、采购单位、金额范围和排除词。

**主要接口**：

| 类别 | 接口名 | 用途 |
|---|---|---|
| 附件接口 | `getZTBProjectFiles` | 招中标信息附件列表：获取招标文件、采购需求、合同附件等附件列表。 |
| 正文接口 | `getZTBProjectDetail` | 招中标信息详情（不含结构化数据）：获取公告正文详情。 |
| 溯源接口 | `getCollectUrl` | 获取招中标信息采集源网址：获取原始公告链接，方便追溯。 |
| 项目追溯接口 | `getProjectByProjectNumber` | 根据项目编号查询招中标信息列表：按项目编号或项目标号查询项目。 |

**请求格式**：

```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：输出解析结果

- 先说明识别出的查询条件和自动补全条件。
- 列表结果用表格输出：项目名称、地区、公告类型、发布时间、采购单位、中标单位、金额、来源链接。
- 分析结果要区分「接口返回事实」和「基于数据的判断建议」。
- 金额、时间、项目编号、附件和来源 URL 必须基于接口返回，不得编造。
- 结果为空时说明查询口径，并给出可调整条件。

## 默认查询规则

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

## 余额或额度不足处理

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

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

## 不应做的事情

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

## 示例用户问题

- 查某地区最近有哪些政府采购中标公告和合同公告。
- 帮我找某个行业近 90 天值得销售跟进的招投标商机。
- 查询某采购单位今年的采购需求和供应商变化。
- 把「广东学校智慧校园建设项目」转成可执行搜索条件并返回结果。
- 获取某个重点项目的附件列表和原始公告链接。

使用说明

# 招标公告附件解析助手

基于全国招投标数据 API 的附件解析工具：获取招标文件、采购需求附件与合同附件，解析公告正文，支持按项目编号追溯公告链路与原始公告溯源。

## 使用

```text
帮我拿一下某某智慧校园项目的招标文件附件
```

```text
按项目编号查这个项目的招标、变更、中标公告链路
```

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

## 工作原理

从自然语言中抽取项目与查询条件，依次调用附件列表、公告正文、采集源网址与项目编号追溯接口，以表格输出项目名称、公告类型、采购/中标单位、金额与来源链接；附件、金额与 URL 全部基于接口返回，结果为空时说明查询口径并给出可调整条件。

如何安装此技能？

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