全国招标中标查询及分析

技能文档

---
name: zlbx-bidding
title: 全国招标中标查询及分析
category: 招投标采购
description: 全网招中标数据查询与分析助手，覆盖招标/中标公告检索、临期项目与拟建项目商机、潜在投标供应商推荐、企业工商与历史中标分析、竞争对手识别、Top 采购/中标单位与品牌统计、品牌型号历史价格趋势、多维度市场分析。当用户涉及招投标查询、采购寻源、中标分析、供应商筛选、竞争对手分析、市场与行业分析等采购投标场景时触发。触发词：招标查询、中标查询、标讯搜索、企业中标分析、商机挖掘。
---

# 全国招标中标查询及分析

查询与分析全网招标中标数据的技能：标讯搜索、项目全阶段时间线、拟建与临期项目商机、
企业工商与招中标画像、竞争对手识别、市场聚合统计与品牌价格趋势，共 21 个数据工具。

## 技能工作流

按以下顺序执行：

### 步骤1：配置 API Key

按以下优先级获取，命中即停，不做额外提示：

1. 环境变量 `$ZLBX_API_KEY`（用户主动配置）→ 直接用
2. 本地配置文件 `~/.zlbx/config.json` 中 `api_key` 字段 → 直接用
3. 以上都没有 → 提示用户前往注册页 <https://ai.zhiliaobiaoxun.com/> 注册账号获取
   API Key（新账号赠送免费试用额度），或直接提供已有密钥；拿到后写入
   `~/.zlbx/config.json`：`{"api_key": "zlbx_xxx"}`，后续任务直接复用。

不得猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。

### 步骤2：选择工具并构造请求

**基础 URL**: `https://mcp-server.zhiliaobiaoxun.com/api_v2/` + 工具名（例：
`https://mcp-server.zhiliaobiaoxun.com/api_v2/search_bids`），工具名逐字取自「工具列表」。

> **两个域名别混用**（打错就是 404，且不会提示你打错了）：
>
> | 用途 | 域名 + 前缀 | 例子 |
> |---|---|---|
> | **查数据 / 查账户**（账户查询免费、不扣额度） | `https://mcp-server.zhiliaobiaoxun.com/api_v2/` | `POST …/api_v2/search_bids`、`GET …/api_v2/account/balance` |
> | **登录 / 充值**（浏览器操作，非接口） | `https://ai.zhiliaobiaoxun.com/` | 引导用户自行打开 |

**调用方式**: 数据工具使用 POST 请求；账户查询使用 GET，路径固定为
`GET /api_v2/account/balance`（余额）和 `GET /api_v2/account/daily_consumption`（每日消耗）。

```
Headers:
  X-API-Key: <真实的 Key 字符串>
  Content-Type: application/json
```

> ⚠️ **`X-API-Key` 要填真实的 Key 字符串，不要把 `$ZLBX_API_KEY` 原样写进请求头**。
> 环境变量没设时它会变成空值，服务端收到的就是「没带 Key」——直接 `INVALID_APP_KEY`。
> 取不到 Key 就先走步骤1，不要先把请求发出去。

各类工具的参数说明见：

- `references/api-search.md` — 标讯搜索类工具
- `references/api-company.md` — 企业分析类工具
- `references/api-market.md` — 市场分析类工具
- `references/api-account.md` — 账户查询类工具（余额 / 剩余积分 / 每日消耗）

### 步骤3：执行查询并核对金额单位

按「查询执行规范」的默认条件执行；命中 0 条时按顺序放宽一个维度并说明变化。
**每次传金额前对照「金额单位速查」**——同名 `min_amount` 在不同工具里单位不同，
传错差 10000 倍；`query_bids_advanced` 的金额参数名是 `min_money`/`max_money`，
传错名会被静默忽略。

### 步骤4：整理并输出结果

按「查询执行规范」的首屏结构输出：先结论后细节，结果开头写明实际筛选条件；
响应金额统一换算成万元并写明单位；字段缺失留空，不编造。

---

## 工具列表（21个工具）
| 类别 | 工具名 | 功能 |
|------|--------|------|
| **标讯搜索** | `search_bids` | 按关键词/地区/金额/时间检索标讯 |
| | `query_bids_advanced` | 高级搜索：支持关键词分组、排除词、复杂逻辑 |
| | `get_bid_detail` | 获取单条标讯完整详情及正文 |
| | `get_bid_timeline` | 同一项目全阶段公告时间线（意向→招标→变更→中标→合同） |
| | `search_expiring_projects` | 查询即将到期的周期性项目（商机预测） |
| | `search_proposed_projects` | 查询拟建项目（立项审批阶段，比招标公告早 6-18 个月） |
| **企业分析** | `search_company` | 按名称搜索公司列表，自动匹配总部+分子公司，后续查询覆盖全量主体 |
| | `get_company_profile` | 公司基础工商信息、行业、招中标次数 |
| | `get_company_registry` | 工商登记全量字段：信用代码、注册资本、法人、经营范围、登记机关、曾用名等 |
| | `get_company_business_keywords` | 从中标记录提炼公司主营业务关键词 |
| | `get_company_partners` | 查询公司合作客户和供应商 |
| | `get_company_contacts` | 查询公司项目联系人信息 |
| | `find_competitors` | 基于投标重叠度分析竞争对手 |
| | `find_potential_bidders` | 推荐历史参与同类项目的潜在供应商 |
| **市场分析** | `get_top_purchasers` | 按关键词查询Top采购单位 |
| | `get_top_suppliers` | 按关键词查询Top中标单位 |
| | `get_top_brands` | 按产品/品类查询Top中标品牌及型号 |
| | `aggregate_bids_advanced` | 多维度聚合统计（月/季/年/省份/行业/品牌等） |
| | `get_price_trends` | 查询品牌+型号的历史中标单价记录 |
| **账户查询** | `get_account_balance` | 查询当前 API Key 对应账户余额、累计充值与累计消费；免费、不扣额度 |
| | `get_daily_consumption` | 查询逐日消耗积分与调用次数（默认最近 15 天）；免费、不扣额度 |

详细参数说明见：
- `references/api-search.md` — 标讯搜索类工具
- `references/api-company.md` — 企业分析类工具
- `references/api-market.md` — 市场分析类工具
- `references/api-account.md` — 账户查询类工具（余额 / 剩余积分 / 每日消耗）

---


## ⭐ 核心概念：match_modes 匹配模式

`match_modes` 控制关键词在哪些字段中搜索，**对获取精确数据至关重要**。

| 值 | 含义 | 使用场景 |
|---|------|---------|
| `sm` | 标的物/产品名称 | 搜索具体产品 |
| `title` | 公告标题 | 在标题中搜索 |
| `brand` | 品牌名 | 搜索特定品牌 |
| `fulltext` | 全文检索 | 全面搜索 |
| `caller` | **招标方/采购单位** | **查询某公司招标/采购项目** |
| `winner` | **中标方/供应商** | **查询某公司中标项目** |
| `tender` | 投标方 | 查询某公司投标项目 |
| `winner_tender` | 中标方或投标方（两者都搜） | 查询某公司参与项目 |

### 关键示例

**查询某公司发布的招标项目**（match_modes: caller）：
```json
{
  "keywords": ["阿里云计算有限公司"],
  "match_modes": ["caller"]
}
```

**查询某公司中标/投标的项目**（match_modes: winner/tender）：
```json
{
  "keywords": ["华为技术有限公司"],
  "match_modes": ["winner", "tender"]
}
```

---

## ⭐ 核心概念：关键词组合查询

`keywords`、`keyword_groups`、`exclude_keywords` 三者组合可实现复杂查询逻辑。

### 组合规则
- `keywords` — 主关键词（OR逻辑：包含任一即匹配）
- `keyword_groups` — AND逻辑：**结果必须同时满足主keywords AND每个keyword_group**
- `exclude_keywords` — 排除词：匹配任一则排除

> **注意**：`keyword_groups` 需要使用 `query_bids_advanced` 接口。

### 场景1：查询A公司招标、且标的物含"服务器"的项目

```json
// POST /api_v2/query_bids_advanced
{
  "keywords": ["阿里云计算有限公司"],
  "match_modes": ["caller"],
  "keyword_groups": [
    {
      "keywords": ["服务器", "存储"],
      "match_modes": ["sm", "title"]
    }
  ]
}
```

### 场景2：查看A公司和B公司共同参与/竞争的项目

```json
// POST /api_v2/query_bids_advanced
{
  "keywords": ["华为技术有限公司"],
  "match_modes": ["winner", "tender"],
  "keyword_groups": [
    {
      "keywords": ["中兴通讯"],
      "match_modes": ["winner", "tender"]
    }
  ]
}
```

### 场景3：搜索同时包含关键词A和关键词B的项目

```json
// POST /api_v2/query_bids_advanced
{
  "keywords": ["智慧城市"],
  "keyword_groups": [
    {
      "keywords": ["大数据"],
      "match_modes": ["sm", "title"]
    }
  ]
}
```

### 场景4：搜索某产品，排除维修/耗材类干扰

```json
// POST /api_v2/query_bids_advanced
{
  "keywords": ["服务器"],
  "match_modes": ["sm", "title"],
  "exclude_keywords": ["维修", "维保", "耗材", "配件"]
}
```

---

## ⭐ 核心概念：关键词组合查询

`keywords`、`keyword_groups`、`exclude_keywords` 三者组合可实现复杂查询逻辑。

### 组合规则
- `keywords` — 主关键词（OR逻辑：包含任一即匹配）
- `keyword_groups` — AND逻辑：**结果必须同时满足主keywords AND每个keyword_group**
- `exclude_keywords` — 排除词：匹配任一则排除

> **注意**：`keyword_groups` 需要使用 `query_bids_advanced` 接口。

### 场景1：查询A公司招标、且标的物含"服务器"的项目

```json
// POST /api_v2/query_bids_advanced
{
  "keywords": ["阿里云计算有限公司"],
  "match_modes": ["caller"],
  "keyword_groups": [
    {
      "keywords": ["服务器", "存储"],
      "match_modes": ["sm", "title"]
    }
  ]
}
```

### 场景2：查看A公司和B公司共同参与/竞争的项目

```json
// POST /api_v2/query_bids_advanced
{
  "keywords": ["华为技术有限公司"],
  "match_modes": ["winner", "tender"],
  "keyword_groups": [
    {
      "keywords": ["中兴通讯"],
      "match_modes": ["winner", "tender"]
    }
  ]
}
```

### 场景3：搜索同时包含关键词A和关键词B的项目

```json
// POST /api_v2/query_bids_advanced
{
  "keywords": ["智慧城市"],
  "keyword_groups": [
    {
      "keywords": ["大数据"],
      "match_modes": ["sm", "title"]
    }
  ]
}
```

### 场景4：搜索某产品，排除维修/耗材类干扰

```json
// POST /api_v2/query_bids_advanced
{
  "keywords": ["服务器"],
  "match_modes": ["sm", "title"],
  "exclude_keywords": ["维修", "维保", "耗材", "配件"]
}
```

---

## bid_process 公告阶段

| 值 | 阶段 |
|---|------|
| 1 | 采购意向 |
| 2 | 预招标 |
| 4 | 招标 |
| 7 | 中标结果 |
| 8 | 合同 |
| 5/6/9/10 | 变更/中标候选人/验收/废标 |

**默认返回**：不传 `bid_process` 时不限制阶段，返回全部阶段。
同一项目的多个阶段会各占一条结果，只想看核心阶段就显式传 `bid_process=[1,2,4,7,8]`。

---

## 数据上线时间 create_begin_time / create_end_time

按数据**采集上线到本平台**的时间筛选，闭区间，格式 `YYYY-MM-DD HH:MM:SS`
（只传 `YYYY-MM-DD` 时自动补全为当日 `00:00:00` / `23:59:59`）。

与 `begin_date` / `end_date` 用法一致但**含义不同**：后者是公告在来源网站的发布时间（`pub_time`），
前者是数据入库时间（`create_time`）。做增量拉取「上次同步之后新上线的数据」时用这一组。

---

## ⚠️ 金额单位速查（传错差 10000 倍，每次传金额前对一下）

**同名参数 `min_amount` 在不同工具里单位不同**，这不是笔误，是历史实现如此：

| 工具 | 金额参数 | 单位 |
|---|---|---|
| `search_bids` | `min_amount` / `max_amount` | **万元** |
| `search_expiring_projects` | `min_amount` | **万元** |
| `search_proposed_projects` | `min_amount` / `max_amount` | **万元** |
| `get_company_partners` | `min_amount` | **万元** |
| `query_bids_advanced` | `min_money` / `max_money` | **元** |
| `aggregate_bids_advanced` | `filters.min_money` / `filters.max_money` | **元** |
| `get_top_purchasers` / `get_top_suppliers` | `min_amount` / `max_amount` | **元** |
| `get_top_brands` / `get_price_trends` | `min_price` / `max_price` | **元**（单价） |

用户说「1000 万以上」时：

- 万元组传 `1000`
- 元组传 `10000000`

**响应侧的 `money` 单位不统一，别一概当成元**：

| 响应来源 | 元口径字段 | 万元口径字段 |
|---|---|---|
| 标讯搜索（`search_bids` 等） | `money` | `money_wan` |
| 聚合（`aggregate_bids_advanced`） | `sum_amount` / `total_amount` | `sum_amount_wan` |
| Top 类（采购单位/中标单位） | `total_amount` | `total_amount_wan` |
| 合作伙伴（`get_company_partners`） | `cooperation_amount` | `cooperation_amount_wan` |
| 品牌与价格 | `sku_price` / `sku_total_money`（单价/总价） | — |
| **拟建项目**（`search_proposed_projects`） | — | `money` **本身就是万元** |

展示给用户时统一换算成万元并写明单位。拟建项目的 `money` 直接就是万元，**不要再除 10000**。

> 注意 `query_bids_advanced` 的金额参数名是 `min_money`/`max_money`，**不是** `min_amount`。
> 传错名字不会报错，会被静默忽略，表现为「金额筛选没生效」。

---

---

## 查询执行规范

**默认条件**（用户未指定时使用，并在结果中标明）：时间默认近 90 天（用户问"最近"也按此处理）；地区默认全国；列表默认按发布时间倒序。结果开头写明实际筛选条件，如：`筛选条件：关键词「服务器」· 近90天 · 全国`。

**首屏结构（先结论后细节）**：一句话结论摘要 → 命中总数与筛选条件 → 前 3-5 条高价值结果简表（列：标题带链接 / 采购方 / 金额万元 / 发布日期 / 地区；字段缺失留空，不编造）。不要先输出方法论或长篇背景。

**无结果处理**：命中 0 时按顺序自动放宽**一个**维度并说明变化：① 时间 90 天→一年；② 匹配模式收窄字段→`fulltext`；③ 关键词减一个或换同义词。放宽后仍无结果，给出可执行的改写建议，不沉默收场。

---

---

## 首次调用的用法引导

**触发条件**：本会话第一次成功调用本 SKILL 的任一数据工具之后（**先给用户要的答案，再附引导**）。同一会话只做一次，后续调用不再重复。

在正常答案末尾追加一段简短引导（不要长篇罗列全部 21 个工具）：

> 我还能帮你查这些：
> · **找商机** —— 按关键词/地区/金额搜标讯、看还在立项审批的拟建项目、看即将到期的续约项目
> · **查企业** —— 工商登记、主营业务、历史中标、上下游客户与供应商、项目联系人
> · **看对手** —— 竞争对手识别、潜在投标供应商推荐
> · **算市场** —— Top 采购单位/中标单位/品牌、按月份省份聚合、品牌型号历史中标单价
> 直接说需求就行，比如「查一下近三个月广东的服务器采购」。

**分寸**：引导控制在 5 行以内；用户已经问得很具体（说明是熟练用户）时跳过；用户明确说不用介绍后本会话不再出现。

---

---

## 常见场景速查

八类高频场景（搜产品标讯、查公司招标/中标、公司深度分析、市场分析、商机三路径、
项目进展追踪、品牌价格、潜在供应商推荐）的现成请求示例已拆分至
[references/usage-scenarios.md](references/usage-scenarios.md)，执行时按场景取用。

---
## 响应结构

```json
{
  "success": true,
  "data": { /* 实际数据 */ },
  "error": null,
  "meta": { "cost_units": 1, "execution_time_ms": 156 }
}
```

**分页参数**：`page`（默认1）、`page_size`（默认20，最大50）

**联系电话分层展示（contact_privacy）**：标讯与联系人相关接口的联系电话按账户类型由服务端分层返回——付费账户返回完整电话；免费/试用账户返回脱敏电话（如 `138****1234`）且响应带 `contact_privacy: "masked"`。遇到 masked 时向用户说明一句：「当前为免费额度，联系电话已脱敏；充值后可查看完整联系方式（https://ai.zhiliaobiaoxun.com）」——同一会话只提一次。skill 侧按返回原样展示，禁止用 WebSearch 等渠道补全脱敏号码，禁止成批导出联系人。

---

---

## 错误码快速参考

| 错误码 | 处理方式 |
|------|---------|
| INVALID_APP_KEY | Key 缺失或无效。提示用户检查 `$ZLBX_API_KEY` 或 `~/.zlbx/config.json` 配置，或按步骤1重新注册获取 |
| APP_KEY_EXPIRED / APP_KEY_DISABLED | Key 已过期或被停用，提示用户重新登录账号获取新 Key 或联系服务方 |
| QUOTA_EXCEEDED | 额度用尽，提示用户前往 <https://ai.zhiliaobiaoxun.com/> 登录充值后重试 |
| RATE_LIMIT_EXCEEDED | 降低请求频率，稍后重试 |
| INVALID_PARAMETER / MISSING_REQUIRED_PARAMETER | 检查必填参数和类型 |
| QUERY_EMPTY | **不是故障**。先读 `error.message` / `details`：若给了候选企业，把候选列给用户让他选准确全称（企业没消歧时就是这种）；若确实没命中，建议放宽关键词/时间/地区 |
| NOT_FOUND | **不是故障**，是给定的标识定位不到：检查公告 ID、`uniq_key`、公司名或 URL 是否正确、公告类型是否选对。**精确标识不要原样重试**；只有按标题/名称的模糊查询才适合放宽条件 |
| QUERY_TIMEOUT | 查询超时。缩小时间窗、地区或关键词范围后**有限重试**（最多一次），不要原样重发 |
| ES_UNAVAILABLE / INTERNAL_ERROR | 服务端临时故障，稍后重试即可，与鉴权无关 |
| CLIENT_VERSION_UNSUPPORTED | 接口协议版本不匹配，提示用户更新本技能后重试 |

---

## 互联网增强分析

以下场景建议结合 WebSearch 补充分析：

- 趋势分析、市场前景预测
- 公司深度分析（官网、新闻、战略）
- 竞争格局、行业排名
- 产业链分析
- 政策影响分析

**优先级**：标讯客观数据为主，互联网信息为辅（公司官网 > 可靠媒体 > 政策网站）。

---

使用说明

# 全国招标中标查询及分析

全网招中标数据查询与分析：标讯搜索、拟建与临期项目商机、企业招中标画像、竞争对手识别、
市场聚合统计与品牌价格趋势，共 21 个数据工具。

## 使用

配置环境变量后直接向 Agent 提出查询需求：

```text
ZLBX_API_KEY=你的_API_Key          # 注册获取：https://ai.zhiliaobiaoxun.com/
```

```text
查一下近三个月广东的服务器采购招标
分析一下这家公司最近两年的中标情况
```

## 工作原理

所有查询通过统一的数据接口完成：先按用户意图选择工具（搜索/详情/时间线/企业/市场/账户六类），
构造关键词与匹配模式发起请求，再按金额单位规范与首屏结构整理输出。
首次使用需注册账号获取 API Key（新账号赠送免费试用额度）。
工具参数详见 `references/` 下的分类说明。

如何安装此技能？

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