招投标搜索与标讯订阅

技能文档

---
name: lskj-official-subscribe
title: 招投标搜索与标讯订阅
category: 招投标采购
description: 把业务描述转成可执行的标讯检索条件，搜索、筛选、去重并整理招标、中标、采购意向、合同等标讯，生成可重复执行的订阅条件与增量清单。当用户需要查标讯、订阅标讯、每日商机监测、招标公告跟踪、按关键词或地区持续监测时触发。触发词：标讯搜索、招标查询、中标查询、标讯订阅、商机监测。
---

# 招投标搜索与标讯订阅

把用户的业务描述转成可执行的标讯检索条件，返回本次命中结果，并生成下次可复用的订阅规则。订阅代表可重复执行的查询配置；只有运行环境具备定时任务或消息推送能力时，才执行自动推送。

## 技能工作流

### 步骤1：API Key 检查与配置

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

### 步骤2：收集输入

优先提取以下条件：关键词、排除词、必含词、地区、开始与结束日期、信息分类、采购分类、行业、甲方、乙方、代理机构、金额区间、是否有附件、推送频率和每次返回数量。

关键词规则：同时出现用空格分隔，任一出现用 `|` 分隔。不要让 `inCludeKW` 与 `keyword` 重复。

### 步骤3：执行检索与去重

1. 把自然语言需求整理为搜索条件；存在明显歧义时列出已采用的解释。
2. 调用「招中标信息搜索列表」获取列表。首次查询使用 `pageId=1`，`pageNumber` 不得超过 50。
3. 以 `id + publishTime` 作为稳定去重键。用户提供历史结果时，标记新增、已存在和内容状态变化。

### 步骤4：按需补充详情

需要完整字段时，对高相关结果调用结构化详情；需要正文、附件或原始出处时再调用对应详情接口。

### 步骤5：输出结果与订阅条件

按相关度、发布时间、金额匹配、地区匹配和截止时间给出优先级并解释原因，输出本次结果和可复用订阅条件。不要声称已经创建后台定时任务，除非确实调用了相应工具并验证成功。

## 调用约定

- 统一发送 UTF-8 JSON `POST` 请求，请求地址末尾增加 `?key=<BBIAO_API_KEY>`。
- 同时检查 HTTP 状态、`code` 或 `state`、`subCode`。接口失败时输出错误信息和可重试建议，不得伪造结果。
- 日期按用户时区解释；用户未指定时区时使用 `Asia/Shanghai`。用户未给时间范围时，默认查询最近 7 天并明确说明。
- 展示前清理标题和摘要中的 HTML 高亮标签，但保留项目 ID、发布时间和原始链接用于追溯。

## 接口

### 搜索列表

`POST /outer-gateway/bid/searchProjectApi`

必填：`startDate`、`endDate`、`pageId`、`pageNumber`、`searchType`。常用可选字段：`keyword`、`excludeKW`、`inCludeKW`、`projectClassID`、`searchMode`、`areaCode`、`industryCode`、`purchaseTypeID`、`partAName`、`partBName`、`agentName`、`companyName`、`projectMoneyMin`、`projectMoneyMax`、`fileFlag`。

```json
{
  "startDate": "2026-07-21 00:00:00",
  "endDate": "2026-07-28 23:59:59",
  "pageId": 1,
  "pageNumber": 20,
  "searchType": 3,
  "keyword": "医疗设备|病床",
  "excludeKW": "维修",
  "inCludeKW": "采购",
  "projectClassID": "-100",
  "searchMode": 1,
  "areaCode": {"proviceCodeList": ["0"], "cityCodeList": [], "countyCodeList": []},
  "industryCode": {"firstCodeList": [], "secondCodeList": [], "thirdCodeList": []},
  "purchaseTypeID": "3",
  "partAName": "",
  "partBName": "",
  "agentName": "",
  "companyName": "",
  "fileFlag": -1
}
```

### 按需补充

- `POST /outer-gateway/bid/getZTBStructreDetail`：传 `id`、`publishTime`，获取项目编号、金额、截止时间、甲乙方、代理机构和联系方式。
- `POST /outer-gateway/bid/getZTBProjectDetail`：传 `id`、`publishTime`，获取完整正文。
- `POST /outer-gateway/bid/getZTBProjectFiles`：传 `projectId`、`publishTime`，获取附件。
- `POST /outer-gateway/bid/getCollectUrl`：传 `id`、`publishTime`，获取原始采集网址。

## 详细接口参数

执行对应接口前按需读取：

- 完整接口总说明（references/Parameter-Description.md）
- 招中标信息搜索列表（references/search-project-api.md）
- 招中标信息结构化数据详情（references/get-ztb-structure-detail.md）
- 招中标信息正文详情（references/get-ztb-project-detail.md）
- 招中标信息附件列表（references/get-ztb-project-files.md）
- 获取招中标信息采集源网址（references/get-collect-url.md）
- 枚举值与码表（references/enums-and-code-tables.md）

## 输出格式

先输出「订阅条件」，包含查询周期、关键词逻辑、地区、分类、金额、企业条件和去重键。再输出结果表：优先级、标题、信息类型、地区、金额、发布时间、报名或开标截止时间、甲方、乙方、项目 ID、附件、来源链接、推荐理由。最后列出数据缺失、接口限制和下次执行建议。

不得把相关性判断写成确定事实；不得补写接口未返回的联系人、金额、截止日期或企业角色。

## 余额或额度不足处理

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

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

使用说明

# 招投标搜索与标讯订阅

把业务描述转成可执行的标讯检索条件：搜索、筛选、去重并整理招标/中标/采购意向/合同等标讯，生成可重复执行的订阅条件与增量清单。

## 使用

配置环境变量后对 Agent 说：

```text
BBIAO_API_KEY=你的_API_Key
帮我按关键词「医疗设备」订阅广东省的招标公告，每天汇总一次
```

技能会整理检索条件 → 调用标讯数据接口 → 去重分级 → 输出结果表与可复用的订阅条件。

## 工作原理

- 调用全国招投标数据 API 的搜索与详情接口，按 `id + publishTime` 稳定去重；
- 自动补全默认时间范围（近 7 天）并说明，支持地区、行业、金额、企业等多维筛选；
- 输出含优先级推荐理由的结果表，附数据缺失与下次执行建议。

如何安装此技能？

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