全国招中标查询与企业洞察

技能文档

---
name: national-bid-company-insight
title: 全国招中标查询与企业洞察
category: 招投标采购
description: 基于全国招中标数据 API 做企业洞察与标讯查询，覆盖企业基本信息、招投标记录、中标统计、采购记录、合作客户、供应商关系、关联项目与历史交易，支持按地区、行业、采购单位、中标单位、金额、时间分析企业画像与市场趋势，并支持自然语言找标。当用户需要查询招标公告/中标结果、分析企业中标情况、做客户尽调、供应商分析、竞品监测或商机挖掘时触发。触发词：招投标查询、中标记录、企业洞察、标讯搜索、采购分析。需配置世舶科技 API Key 使用。
---

# 全国招中标查询与企业洞察

全国招中标查询与企业洞察，重点分析企业历史中标、合作客户、区域分布和业务方向。请优先
围绕用户提出的地区、行业、关键词、采购单位、中标单位、项目编号、金额区间和时间范围组织
查询，不新增接口，只复用世舶科技全行业招投标数据 API。

## 技术能力概述

- 累计 `3.3亿+` 招投标信息，日更 `30万+` 条，覆盖近 10 年全国、全行业、全链路招标采购
  信息。
- `78` 个结构化高级字段：覆盖采购单位、中标单位、金额、地区、行业、发布时间、清单、
  型号、价格、联系人、附件、合同和拟在建项目等维度。
- 覆盖政府采购、工程建设、医疗、教育、能源、交通、信息化等多行业招投标信息追踪。
- 支持 AI 智能找标、自然语言找标、标讯文本结构化和项目甄别。

## 技能工作流

### 步骤1：理解查询意图

理解用户问题，提取地区、行业、关键词、采购单位、中标单位、项目编号、公告阶段、金额
区间和时间范围。

### 步骤2：改写查询条件

如果用户表达比较口语化，先使用 `SearchProjectForAI` 或 `aiSearchSubmitPolling` 把自然
语言改写成可执行的查询条件；若本技能未列出对应接口，则直接使用已允许的搜索接口。

### 步骤3：调用接口获取数据

根据本技能允许的接口清单选择搜索、详情、合同、拟在建或来源追溯能力。若当前技能未列出
某类接口，不要擅自调用。

### 步骤4：组织结果输出

返回结果时先给结论，再列关键项目表格，最后给下一步建议，例如查看详情、追溯来源、扩大
时间范围或订阅同类商机。

## API 概览

基础 URL：默认使用世舶科技服务域名，接口路径为 `/outer-gateway/bid/{接口名}`。

调用方式：`POST` 请求为主，少量历史接口可能为 `GET`，以接口文档为准。

请求格式：

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

接口文档：[世舶科技 API 文档](https://console.woyaobid.com/gateway-admin/share/api-doc)。

## API Key 处理规则

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

## 主要工具

本技能只使用下列接口；不要展示或调用未列出的接口。

| 接口名 | 使用重点 |
|---|---|
| `searchProjectApi` | 招中标信息搜索列表：按关键词、地区、行业、时间、金额和企业名称搜索招标采购信息。 |
| `SearchProjectForAI` | 招中标信息搜索列表（自然语言）：用自然语言友好的条件搜索招标采购项目。 |
| `getZTBStructreDetail` | 招中标信息结构化数据详情：获取采购方、供应商、金额、联系人、时间等结构化字段。 |
| `searchProjectContactApi` | 招中标合同数据搜索列表：搜索合同公告，核验甲乙方、合同金额和履约周期。 |
| `getCollectUrl` | 获取招中标信息采集源网址：获取原始公告链接，方便追溯。 |
| `aiSearchSubmitPolling` | AI生成招中标信息搜索条件：把自然语言需求改写为可执行搜索条件。 |

## 触发条件

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

- 招标公告、中标结果、成交公告、合同公告、拟在建项目查询。
- 按地区、行业、金额、时间、采购单位、供应商或项目编号筛选标讯。
- 分析采购单位画像、供应商画像、竞品中标动态、商机机会或市场趋势。
- 用户使用自然语言描述需求，需要将问题转成可执行的招投标搜索条件。

优先识别关键词：招标、中标、成交、采购、采购意向、招标公告、中标公告、合同公告、
拟在建、项目编号、预算金额、中标金额、采购单位、中标单位。

## 默认查询规则

- 未指定地区：默认全国。
- 未指定时间：搜索类默认近 30 天，商机和趋势类可扩展到近 90 天或近 12 个月，并在回答中
  说明。
- 未指定公告阶段：默认覆盖采购意向、招标公告、中标/成交结果、合同公告。
- 结果过少：扩展同义词、放宽地区、放宽时间或增加公告阶段。
- 结果过杂：增加必含词，加入招聘、考试、培训、会议、新闻、人员公示等排除词。

## 输出规范

- 先输出简短结论，说明命中数量、时间范围和主要发现。
- 项目列表优先包含项目名称、采购方、中标方、预算/中标金额、地区、发布时间、公告阶段、
  来源链接。
- 分析类问题要补充采购趋势、重点客户、供应商机会、竞争对手动态和建议动作。
- 涉及金额、时间、项目编号、联系人或来源网址时，保持字段原样，不要编造。

## 余额或额度不足处理

当接口返回 `0100590006`，表示余额或额度不足。处理规则：

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

错误响应示例：

```json
{
  "msg": "账户欠费，无法继续调用",
  "code": 403,
  "returnValue": null,
  "data": null,
  "subCode": "0100590006",
  "subMsg": "账户余额或额度不足，请充值后重试"
}
```

## 不应做的事情

- 不新增医疗、教育、工程或其他行业专用接口。
- 不绕过 `BBIAO_API_KEY` 调用接口。
- 不把无来源的推测当成招投标事实。
- 不承诺一定中标、必中项目或规避招投标规则。
- 不展示本技能未允许的接口作为可调用工具。

## 示例问题

- 帮我查近 30 天全国有哪些招投标商机。
- 查询某家公司最近 1 年的中标项目，并按金额排序。
- 帮我分析某采购单位近期采购偏好和 Top 供应商。
- 找出某行业近 90 天中标金额较高的项目。
- 根据「北京学校智慧校园设备采购」帮我自动生成搜索条件并查询结果。

## 参考资料

- 用户意图到接口的调用映射 → [references/api-mapping.md](references/api-mapping.md)
- 行业与关键词清单 → [references/national-keywords.json](references/national-keywords.json)

使用说明

# 全国招中标查询与企业洞察

基于全国招中标数据 API，做标讯查询与企业深度洞察：中标记录、合作客户、区域分布、市场趋势与商机挖掘。

## 使用

```text
查一下某家公司最近 1 年的中标项目，按金额排序
帮我查近 30 天智慧校园相关的招投标商机
分析某采购单位近期的采购偏好和 Top 供应商
```

## 工作原理

技能调用世舶科技招投标数据 API（需配置 `BBIAO_API_KEY`），把用户意图映射到搜索/详情/
合同/来源追溯等接口；口语化需求先经 AI 改写为可执行查询条件。输出先结论、再项目表格、
后下一步建议。

如何安装此技能？

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