全国招中标查询与企业画像

技能文档

---
name: national-bid-company-profile
title: 全国招中标查询与企业画像
category: 招投标采购
description: 招投标数据查询总入口，覆盖招标公告、中标标讯、采购意向、合同公告、项目详情与附件、拟在建项目、企业画像（工商信息/联系方式/客户/供应商）、自然语言查标与行业分析等 20 个接口。根据需求自动选择并调用对应接口，适合不熟悉 API 的用户快速完成招投标数据查询与竞对企业分析。当用户提到查标、找标、招投标查询、中标信息、招标公告、拟在建项目、企业中标画像、竞对分析时触发。
---

# 全国招中标查询与企业画像

## API 概览

招投标数据 API 提供招中标搜索、项目详情、合同、拟在建项目、企业画像及 AI 文本处理等能力。本技能根据用户需求选择并调用对应接口，每次仅读取当前接口的独立文档及必要的公共参数。

**直接 API 基础地址**：`https://gate.gov-bid.com/outer-gateway`

**请求方式**：除 MCP 外，本文接口均使用 UTF-8 JSON `POST` 请求。

```text
POST https://gate.gov-bid.com/outer-gateway/bid/{接口名}?key={API_KEY}
Content-Type: application/json
```

## 密钥获取与使用

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

---

## 技能工作流

### 步骤1：确认密钥与服务地址

检查 `BBIAO_API_KEY`（必要时 `BBIAO_SERVER_URL`）；缺失时按「密钥获取与使用」提示用户，不编造密钥。

### 步骤2：需求分析与接口选择

从用户需求中提取：查什么（标讯/合同/拟在建/企业/行业分析）、关键词、地区、时间范围、企业角色；对照下方「接口清单」选择 1 个主接口，只读取该接口的独立文档；需要编码表时读取 `reference/common-parameters.md`。

### 步骤3：构造并调用请求

按接口文档构造 JSON `POST` 请求（关键词组合、搜索模式、地区/行业编码见下方「核心概念」），遵守分页上限；AI 类接口先提交再轮询。

### 步骤4：结果交付与后续引导

区分「接口返回事实」与「分析判断」；空结果写「未命中」；按「回答后引导」建议一至两个自然的后续动作，不替代本次结果交付。

---

## 接口清单（20 个）

每个接口对应一份独立文档。确定调用接口后，只读取该接口文档；需要信息分类、采购分类、行业或地区编码时，再读取 `reference/common-parameters.md`。以下文档路径均为普通文本，不使用本地 Markdown 锚点。

### 一、招中标与合同数据（9 个）

| 接口 | 地址 | 接口文档 | 主要用途 |
| --- | --- | --- | --- |
| 招中标信息搜索列表 | `/bid/searchProjectApi` | `reference/searchProjectApi.md` | 按关键词、地区、行业、时间、金额和企业角色搜索标讯 |
| 根据项目编号查询列表 | `/bid/getProjectByProjectNumber` | `reference/getProjectByProjectNumber.md` | 串联同一项目编号的招标、变更、中标、合同等公告 |
| 招中标结构化详情 | `/bid/getZTBStructreDetail` | `reference/getZTBStructreDetail.md` | 获取项目编号、预算、中标金额、甲乙方、代理机构和联系方式、投标企业等 |
| 招中标正文详情 | `/bid/getZTBProjectDetail` | `reference/getZTBProjectDetail.md` | 获取完整公告正文，不含结构化字段 |
| 招中标附件列表 | `/bid/getZTBProjectFiles` | `reference/getZTBProjectFiles.md` | 获取附件名称、状态和下载地址 |
| AI/Agent 专用搜索 | `/bid/SearchProjectForAI` | `reference/SearchProjectForAI.md` | 使用地区名称、类别名称和企业名称进行自然语言友好搜索 |
| 合同数据搜索 | `/bid/searchProjectContactApi` | `reference/searchProjectContactApi.md` | 搜索合同公告、合同周期、甲乙方和合同期限 |
| 获取采集源网址 | `/bid/getCollectUrl` | `reference/getCollectUrl.md` | 获取公告原始发布网页 |
| AI 搜索条件重写 | `/bid/aiSearchSubmitPolling` | `reference/aiSearchSubmitPolling.md` | 将自然语言需求改写为时间、关键词、企业、行业和地区条件 |

### 二、企业画像（4 个）

| 接口 | 地址 | 接口文档 | 主要用途 |
| --- | --- | --- | --- |
| 企业基本信息 | `/bid/companyProfileSummary` | `reference/companyProfileSummary.md` | 查询工商基础、经营信息、招投标统计和关系汇总 |
| 企业联系电话 | `/bid/companyProfileContacts` | `reference/companyProfileContacts.md` | 分页获取联系人和电话，每页最多 5 条 |
| 企业合作客户 | `/bid/companyProfileCustomers` | `reference/companyProfileCustomers.md` | 获取客户企业及关联项目，每页最多 20 条 |
| 企业供应商 | `/bid/companyProfileSuppliers` | `reference/companyProfileSuppliers.md` | 获取供应商企业及关联项目，每页最多 20 条 |

### 三、拟在建项目（3 个）

| 接口 | 地址 | 接口文档 | 主要用途 |
| --- | --- | --- | --- |
| 拟在建项目搜索 | `/bid/searchNZJProjectApi` | `reference/searchNZJProjectApi.md` | 按关键词、地区和时间搜索拟在建信息 |
| 拟在建项目详情 | `/bid/getNZJProjectDetail` | `reference/getNZJProjectDetail.md` | 获取建设单位、完整正文、地区和附件摘要 |
| 拟在建附件列表 | `/bid/getNZJProjectFileList` | `reference/getNZJProjectFileList.md` | 获取拟在建项目附件名称、格式、状态和下载地址 |

### 四、AI 推理与结构化（4 个）

| 接口 | 地址 | 接口文档 | 主要用途 |
| --- | --- | --- | --- |
| AI 行业搜索 | `/bid/industryReasoning` | `reference/industryReasoning.md` | 将行业短语映射为国家统计局行业编码候选 |
| LLM 标讯结构化 | `/bid/ztbAiStructureInfo` | `reference/ztbAiStructureInfo.md` | 兼容 Chat Completions 消息格式，抽取招中标结构化字段 |
| 招中标分类推理 | `/bid/categoryReasoning` | `reference/categoryReasoning.md` | 根据标题和正文推理招中标信息分类 |
| 项目信息甄别 | `/bid/projectDiscrimination` | `reference/projectDiscrimination.md` | 判断文本属于标讯、拟在建、非项目或异常信息 |

---

## 核心概念：关键词组合

搜索接口中的关键词使用以下规则：

| 字段 | 规则 | 示例 |
| --- | --- | --- |
| `keyword` | 空格表示同时出现，`\|` 表示任一出现 | `医院 病床`、`病床\|医疗床` |
| `inCludeKW` | 结果必须包含，多个词使用 `\|` | `采购\|招标` |
| `excludeKW` | 排除包含任一关键词的结果 | `维修\|维保\|配件` |

不要让 `inCludeKW` 与 `keyword` 包含相同关键词。关键词条件必须来自用户需求或明确标注的同义词扩展。

### 示例：搜索医疗床采购并排除维修

```json
{
  "keyword": "病床|医疗床",
  "inCludeKW": "采购|招标",
  "excludeKW": "维修|维保|配件"
}
```

---

## 核心概念：搜索模式

### searchType 搜索类型

| 值 | 含义 |
| --- | --- |
| `1` | 智能模糊搜索 |
| `2` | 精准搜索 |
| `3` | 高级搜索 |

### searchMode 搜索字段

| 值 | 含义 |
| --- | --- |
| `1` | 标题和内容 |
| `2` | 仅标题 |
| `3` | 仅内容 |

无特殊要求时使用接口默认搜索类型和 `searchMode=1`；需要组合关键词、必含词和排除词时使用高级搜索，用户要求精确名称时使用精准搜索。

---

## 核心概念：企业角色

| 字段 | 企业角色 | 使用场景 |
| --- | --- | --- |
| `partAName` | 甲方、采购人、招标人 | 查询某单位采购或招标的项目 |
| `partBName` | 乙方、中标人、供应商 | 查询某企业中标或签约项目 |
| `agentName` | 招标代理机构 | 查询代理机构经办项目 |
| `companyName` | 参与投标的企业 | 查询企业参与的全部相关项目 |

不得把 `companyName` 命中结果直接认定为甲方或乙方。需要确认角色时调用结构化详情。

---

## 核心概念：地区与行业

### 地区筛选

标准搜索使用 6 位地区编码：

```json
{
  "areaCode": {
    "proviceCodeList": ["420000"],
    "cityCodeList": ["420100"],
    "countyCodeList": []
  }
}
```

`proviceCodeList` 传 `["0"]` 表示全国。AI 专用搜索可直接使用 `areaName`。

### 行业筛选

行业编码分为一级、二级、三级：

```json
{
  "industryCode": {
    "firstCodeList": ["Q"],
    "secondCodeList": ["Q83"],
    "thirdCodeList": ["Q831"]
  }
}
```

行业不明确时先调用 `/bid/industryReasoning`，展示候选行业路径后再选择编码。

---

## 信息分类与采购分类

### 招中标信息分类

常用分类包括：公开招标 `1`、成交结果 `2`、合同公告 `3`、意向公开 `4`、答疑变更 `5`、候选人公示 `6`、开标公示 `7`、重新招标 `8`、流标废标 `11`、结果变更 `18`、拍租公告 `26`、竞争性谈判 `28`、竞争性磋商 `29`、单一来源采购 `30`、其它 `31`。

通过 `projectClassID` 传递，多个分类使用英文逗号分隔；`-100` 表示全部分类。

### 采购分类

| ID | 分类 |
| --- | --- |
| `0` | 其它类 |
| `1` | 服务类 |
| `2` | 工程类 |
| `3` | 货物类 |

通过 `purchaseTypeID` 传递；`-100` 表示全部分类。

---

## 分页与数量规则

| 接口 | 分页字段 | 单页上限 | 仅查数量 |
| --- | --- | --- | --- |
| 招中标搜索 | `pageId`、`pageNumber` | 50 | `pageNumber=0` |
| AI 专用搜索 | `pageId`、`pageNumber` | 100 | `pageNumber=0` |
| 合同搜索 | `pageId`、`pageNumber` | 100 | `pageNumber=0` |
| 拟在建搜索 | `pageId`、`pageNumber` | 50 | `pageNumber=0` |
| 企业联系人 | `pageNo`、`pageSize` | 5 | 不支持 |
| 企业客户/供应商 | `pageNo`、`pageSize` | 20 | 不支持 |

需要全量结果时根据 `hasNext` 或分页信息逐页读取，并记录实际获取条数。没有获取全量明细时，不得把样本统计写成完整市场数据。

---

## 常见场景速查

### 1. 自然语言智能查标

先调用 `/bid/aiSearchSubmitPolling` 重写条件，再调用 `/bid/SearchProjectForAI` 搜索。

```json
{
  "userQuery": "最近一个月武汉医院采购的病床项目，排除维修"
}
```

### 2. 搜索特定产品的招中标信息

调用 `/bid/searchProjectApi`：

```json
{
  "startDate": "2026-06-28 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",
  "fileFlag": -1
}
```

### 3. 查询某单位采购项目

调用 `/bid/searchProjectApi`，将企业全称放入 `partAName`。角色不确定时使用 `companyName`，再用结构化详情核验。

### 4. 查询某企业中标与合同

先使用 `partBName` 搜索中标及合同公告，再调用 `/bid/searchProjectContactApi` 获取合同周期和甲乙方信息。

### 5. 查看项目完整时间线

调用 `/bid/getProjectByProjectNumber` 获取同一项目编号的公告列表，再按项目 ID 获取结构化详情、正文、附件和原始来源。

```json
{
  "projectNumber": "HNXW-202605028",
  "publishTime": "2026-06-08 14:30:30"
}
```

### 6. 企业深度分析

依次调用：

1. `/bid/companyProfileSummary`
2. `/bid/companyProfileContacts`
3. `/bid/companyProfileCustomers`
4. `/bid/companyProfileSuppliers`
5. `/bid/searchProjectApi` 或 `/bid/searchProjectContactApi`

客户与供应商接口返回的是项目关系，不代表股权、控制或长期排他合作关系。

### 7. 提前发现拟在建项目

先调用 `/bid/searchNZJProjectApi`，再调用 `/bid/getNZJProjectDetail` 和 `/bid/getNZJProjectFileList`。

注意：拟在建详情使用参数 `publishtime`，附件接口使用 `publishTime`；附件接口的 `projectTypeID` 固定为 `2`。

### 8. 行业市场分析

先调用 `/bid/industryReasoning` 确认行业编码，再使用搜索接口按时间、地区、分类和金额分组查询数量或明细。计算增长率、排行和市场份额时说明数据覆盖范围。

### 9. 文本甄别、分类与结构化

按以下顺序处理：

1. `/bid/projectDiscrimination`：判断标讯、拟在建、非项目或异常信息。
2. `/bid/categoryReasoning`：仅对标讯文本推理招中标分类。
3. `/bid/ztbAiStructureInfo`：抽取项目、主体、金额、时间、联系人等结构化字段。

非项目或异常文本不要强行结构化。

---

## 详情调用链

搜索接口只返回摘要字段。用户要求完整内容时按需追加调用：

```text
搜索列表
  -> 结构化详情：项目编号、金额、主体、联系人、截止时间
  -> 正文详情：完整 HTML 正文
  -> 附件列表：附件名称、状态、下载地址
  -> 采集源网址：原始公告网页
```

使用列表结果中的 `id` 与 `publishTime`，不要自行构造项目 ID 或发布时间。

---

## 响应结构

多数接口使用以下结构：

```json
{
  "code": 200,
  "msg": "success",
  "subCode": "0000000000",
  "subMsg": "success",
  "data": {}
}
```

特殊情况：

- 拟在建搜索可能使用 `state=1` 表示成功。
- 原始采集网址主要读取 `returnValue`。
- LLM 结构化接口使用 OpenAI Chat Completions 风格，结果位于 `choices[].message.content`。
- 搜索列表位于 `data.data`，总数位于 `data.total`。

同时检查 HTTP 状态、接口状态和业务状态。接口返回空数组时写“未命中”，不要解释为现实中不存在相关项目或企业关系。

---

## 错误处理

| 情况 | 处理方式 |
| --- | --- |
| 缺少 API Key | 停止调用，提示配置 `BBIAO_API_KEY` 并按「密钥获取与使用」获取 |
| 鉴权失败 | 检查密钥是否正确、是否过期和请求地址是否携带 `key` |
| 日期格式错误 | 使用 `yyyy-MM-dd` 或 `yyyy-MM-dd HH:mm:ss` |
| 页码或页大小错误 | 使用正整数并遵守各接口上限；仅查数量时使用允许的 `pageNumber=0` |
| 参数名错误 | 区分 `pageId/pageNumber`、`pageNo/pageSize`、`publishtime/publishTime` |
| 业务状态失败 | 返回 `code/state`、`subCode`、`msg/subMsg`，不要生成模拟数据 |
| AI 处理超时 | 返回 `requestKey` 和当前 `status`，允许稍后重试，不猜测结果 |
| 附件不可用 | 保留附件状态，不声称文件可下载 |

---

## 数据与分析边界

- 把接口返回事实与模型分析判断分开标注。
- 不补写接口未返回的公司角色、金额、联系人、日期、项目阶段或合作关系。
- 标题和摘要可能包含 HTML 高亮标签，展示时可清理标签，但保留原始数据用于追溯。
- 项目关系不等于股权关系，历史关系不等于当前合作关系。
- 未获取全量分页数据时，不计算或宣称完整市场份额。
- 使用企业联系方式时，提醒用户遵守适用的隐私、营销和通信规则。

---

## 回答后引导

完成查询后，根据结果建议一至两个自然的后续动作：

- 搜索到项目：建议查看结构化详情、正文、附件或原始来源。
- 搜索到企业：建议查看企业画像、联系人、客户和供应商。
- 得到中标结果：建议跟踪合同公告、同项目编号后续信息或竞争企业。
- 得到行业数据：建议按时间、地区、采购分类或企业角色继续拆分。
- 得到拟在建项目：建议查看建设单位、正文和附件，判断前置介入节点。
- 得到文本分类：建议继续结构化并执行字段证据校验。

不要用后续引导替代本次用户请求；先完整交付当前结果。

使用说明

# 全国招中标查询与企业画像

一句话描述：招投标数据查询总入口，覆盖找标、查企业、盯拟在建项目与行业分析，自然语言即可查标。

## 使用

```text
用户：最近一个月武汉医院采购的病床项目有哪些？排除维修类。
助手：重写检索条件后调用标讯搜索接口，返回项目列表，
      可继续下钻结构化详情、正文、附件与原始公告来源。
```

前置配置：设置环境变量 `BBIAO_API_KEY`（在 apiyx.gov-bid.com 获取密钥）。

```bash
export BBIAO_API_KEY=你的密钥
```

## 工作原理

内置 20 个接口的调用路由：招中标/合同搜索（9 个）、企业画像（4 个）、拟在建项目（3 个）、AI 推理与结构化（4 个）。按需求选择接口 → 只读对应接口文档 → 构造 JSON 请求 → 交付结果并区分事实与推断，支持关键词组合、地区/行业编码与企业角色过滤。

如何安装此技能？

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