校园数字化项目机会雷达

技能文档

---
name: smart-campus-bid-query-assistant
title: 校园数字化项目机会雷达
category: 招投标采购
description: 智慧校园招投标数据查询与商机分析助手。基于招投标数据服务接口（需配置 BBIAO_API_KEY），面向智慧校园、校园信息化、校园安防、一卡通、教务系统、校园网络、智慧教室、数字校园、平安校园、宿舍管理等教育数字化项目，覆盖招标公告、中标公告、政府采购、合同公告、拟在建项目等数据的检索、企业画像、上下游关系、竞对监测与商机分析。当用户需要查询校园类招标中标信息、分析教育信息化采购趋势、挖掘校园数字化项目销售线索时触发。触发词：智慧校园招标、校园信息化中标、一卡通采购、教务系统招投标、校园安防商机、数字校园项目。
---

# 校园数字化项目机会雷达

面向智慧校园建设领域的招投标数据查询与商机分析工具。围绕校园信息化、安防、一卡通、教务系统、校园网络等场景，把全国招投标数据服务接口的通用能力，通过专属关键词、默认筛选规则、接口调用顺序和输出模板，整理为适合搜索、监控、分析和销售跟进的结果。

本技能不新增专用 API，仅复用招投标数据服务的既有接口；使用前需配置服务密钥（见「服务开通」）。

## 技能工作流

### 步骤1：检查服务可用性

1. 从环境变量 `BBIAO_API_KEY` 读取密钥；从 `BBIAO_SERVER_URL` 读取服务地址，未配置时使用 `https://gate.gov-bid.com`。
2. 未找到密钥时立即停止调用，提示用户按「服务开通」章节获取并配置，或在运行环境的安全凭据中提供已有密钥。
3. 密钥安全规则：不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥；用户提供密钥后长期安全保存，后续任务直接复用。
4. 优先把密钥存入运行环境的安全凭据库，并同步为用户级环境变量 `BBIAO_API_KEY`；无法设置环境变量时，存入访问权限受限的本地凭据文件。

### 步骤2：意图识别与条件抽取

1. 判断用户意图：商机搜索、公告检索、中标分析、合同查询、拟在建跟踪、企业画像、客户供应商关系或竞争对手分析。
2. 抽取关键词、地区、时间、公告类型、采购单位、中标单位、金额范围、项目编号和排除词。
3. 用专属关键词补全行业或场景词；未指定地区默认全国，未指定时间默认近 90 天。

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

1. 只在「主要工具」列出的接口范围内按意图选择调用顺序，不调用未列出的接口。
2. 搜索结果不足时，按「同义词扩展 → 放宽时间 → 放宽地区 → 减少低置信度限制」的顺序调整后重查。
3. 接口选择的详细映射见 `references/api-mapping.md`。

### 步骤4：结果过滤

输出前过滤招聘、考试、培训、会议、新闻、人员公示等明显无关内容，不把此类信息当成采购商机。

### 步骤5：结果输出

1. 先说明识别出的查询条件和自动补全条件。
2. 按输出规范以表格或结构化形式交付（见「输出规范」）。
3. 字段缺失时写「公告未披露」或「不详」，不得编造金额、联系人、附件或链接。

## 服务开通

1. 获取 API Key：访问数据服务方获取页 `https://apiyx.gov-bid.com/`（可免费获取试用额度），或将已有密钥配置到环境变量 `BBIAO_API_KEY`。
2. 套餐购买：访问 `https://console.api.gov-bid.com/bbiao-gateway/package`，或通过阿里云商品页 `https://market.aliyun.com/detail/cmapi00066410` 购买。
3. 接口文档：`https://console.woyaobid.com/gateway-admin/share/api-doc`。
4. 错误码 `0100590006` 表示余额或额度不足：提示用户通过套餐购买页充值，只有用户明确确认购买完成后，才对原请求重试一次；仍失败则说明结果并停止，不轮询、不循环重试。

## 主要工具

本技能只使用以下接口，不加入未列出的其他接口。

| 类别 | 接口名 | 用途 |
|---|---|---|
| 招中标信息搜索列表（智能体场景） | `SearchProjectForAI` | 面向自然语言问题检索招标采购项目 |
| AI 生成搜索条件 | `aiSearchSubmitPolling` | 把自然语言需求改写为可执行搜索条件 |
| AI 行业搜索 | `industryReasoning` | 根据关键词推理行业方向或行业编码候选 |
| 招中标信息搜索列表 | `searchProjectApi` | 按关键词、地区、行业、时间、金额、企业名称等条件检索公告 |
| 结构化数据详情 | `getZTBStructreDetail` | 获取采购方、供应商、金额、联系人、时间等结构化字段 |
| 合同数据搜索列表 | `searchProjectContactApi` | 搜索合同公告，核验甲乙方、合同金额和履约周期 |
| 采集源网址 | `getCollectUrl` | 获取原始公告来源链接，用于结果追溯和复核 |

## 触发条件

当用户问题包含以下意图时使用本技能：

- 查询、筛选或监控智慧校园、校园信息化、校园安防、一卡通、教务系统、校园网络相关招标公告、中标结果、合同公告或拟在建项目。
- 分析上述场景的采购单位、供应商、中标记录、合同机会或竞争对手。
- 按地区、时间、金额、公告阶段、采购单位或企业名称查找相关商机。
- 把自然语言需求转成招投标数据查询条件，并输出可复核的结果。

## 专属关键词

优先使用用户原词，再结合以下关键词扩展：智慧校园、校园信息化、校园安防、一卡通、教务系统、校园网络、数字校园、智慧教室、校园广播、校园监控。

默认排除：招聘、考试、培训、会议、讲座、新闻、科普、通知、人员公示、表彰、租房。

## 输出规范

- 搜索结果用表格输出：项目名称、地区、公告类型、发布时间、采购单位、中标单位、金额、来源链接。
- 详情分析输出：采购需求、资格条件、关键时间、金额、附件、原始公告链接和风险提示。
- 商机分析输出：推荐等级、匹配理由、采购方价值、竞争强度、下一步动作和待核实信息。
- 企业分析输出：企业概况、近期中标记录、合作客户、供应商关系、重点区域和业务关键词。

## 异常处理

| 场景 | 处理方式 |
|---|---|
| 未配置 API Key | 提示用户按「服务开通」章节获取并配置 `BBIAO_API_KEY` |
| 认证失败 | 检查 API Key 是否正确、是否过期、是否具备接口权限 |
| 余额不足 / 额度耗尽 | 提供套餐购买页，停止调用并等待用户确认 |
| 参数错误 | 检查必填参数、日期格式、分页、金额范围、公告类型和地区参数 |
| 结果为空 | 扩展同义词，放宽时间、地区和公告阶段 |
| 详情不可用 | 返回搜索摘要，并说明详情、附件或原始链接未返回 |

## 数据红线

- 不使用本技能接口清单之外的竞品 API 地址、Key 名称或请求头。
- 不调用、不展示未列入「主要工具」的其他接口。
- 不把招聘、考试、培训、会议、新闻、人员公示等内容当成采购商机。
- 不编造公告、金额、联系人、附件、投标截止时间或中标单位。

## 示例用户问题

- 查询近 90 天全国智慧校园相关招标项目。
- 帮我找广东校园信息化采购商机，并按金额排序。
- 分析今年校园安防中标单位有哪些。
- 查询北京智慧校园合同公告，提取甲乙方和金额。
- 监控江苏一卡通项目，排除招聘和培训信息。
- 帮我分析某供应商在智慧校园领域的中标记录。
- 查找近一年教务系统相关采购单位 Top 线索。
- 这个项目是否值得跟进，帮我提取关键信息和风险点。

使用说明

# 校园数字化项目机会雷达

面向智慧校园领域的招投标数据查询与商机分析技能：检索校园信息化、安防、一卡通、教务系统等场景的招标、中标、合同公告与拟在建项目，输出结构化商机分析和销售线索。

## 使用

先配置数据服务密钥（环境变量）：

```bash
export BBIAO_API_KEY="你的密钥"        # 获取地址见 SKILL.md「服务开通」
```

然后直接对话：

```text
查询近 90 天全国智慧校园相关招标项目，按金额排序
分析今年校园安防领域的中标单位有哪些
```

## 工作原理

识别用户意图并抽取关键词、地区、时间等条件，用校园场景专属关键词扩展后调用招投标数据接口检索，再过滤无关公告，按统一表格输出项目名称、采购单位、中标单位、金额与来源链接。

如何安装此技能？

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