拟在建项目商机预判助手

技能文档

---
name: lanshan-planned-project-opportunity
title: 拟在建项目商机预判助手
category: 招投标采购
description: 基于招投标数据 API 预判拟在建、立项审批、备案许可、施工前阶段的采购商机，识别近期有采购需求的单位，支持按地区、行业、项目分类、金额、时间过滤并输出跟进线索。当用户需要查找拟在建项目、立项审批信息、施工许可线索、项目前期商机、业主单位线索、区域项目筛选时触发。触发词：拟在建项目、立项审批、施工许可、项目商机。需配置环境变量 BBIAO_API_KEY 使用。
---

# 拟在建项目商机预判助手

面向拟在建、立项审批、备案许可、施工前机会和前置信息监控场景。本技能不新增 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
```

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

| 类别 | 接口名 | 用途 |
|---|---|---|
| 拟在建接口 | `searchNZJProjectApi` | 拟在建项目信息搜索列表：搜索立项、审批、备案、施工许可、新建改扩建等拟在建机会 |
| 拟在建接口 | `getNZJProjectDetail` | 拟在建项目详情：获取项目建设内容、建设单位、阶段和正文信息 |
| 拟在建接口 | `getNZJProjectFileList` | 拟在建项目信息附件列表：获取拟在建项目附件 |

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

## 技能工作流

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

判断属于拟在建查询、公告检索、商机发现、项目追溯、趋势分析还是数据接口接入。

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

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

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

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

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

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

### 默认查询规则

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

### 结果为空时

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

## 额度不足处理

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

## 边界约束

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

## 示例用户问题

- 帮我找某省近 90 天立项审批的新建改扩建项目
- 查某地区最近有哪些施工许可阶段的项目机会
- 帮我找某个行业近 90 天值得销售跟进的拟在建商机
- 查询某业主单位近一年的项目储备和建设动态
- 把「广东学校智慧校园建设项目」转成可执行搜索条件并返回结果

使用说明

# 拟在建项目商机预判助手

基于招投标数据 API，在项目立项、审批、备案、施工许可阶段提前锁定采购商机，识别近期有采购需求的业主单位并输出可跟进线索。

## 使用

```text
帮我找某省近 90 天立项审批的新建改扩建项目
查某地区最近有哪些施工许可阶段的项目机会
查询某业主单位近一年的项目储备和建设动态
```

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

## 工作原理

技能将用户自然语言解析为地区、行业、项目分类、金额区间、时间等结构化条件，按接口白名单调用拟在建项目的搜索、详情与附件接口，过滤无关公告后以表格输出可追溯结果，并区分接口返回事实与数据判断建议；额度不足时给出明确的购买指引与重试策略。

如何安装此技能？

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