知了标讯 · 全网招中标数据查询

SKILL.md 节选

# 知了标讯 · 全网招中标数据查询

知了标讯官方数据服务，覆盖全网招标与中标公告。用自然语言提问，直接拿到标讯、企业画像与市场分析结果。

> **计费方式**：不需要 API Key、不需要注册。
> 🎁 **新设备通常可获赠 100 积分**，第一次提问直接就能用，不必先付费。
> （赠送额度每日有限，发完为止；若已发完会正常进入购买流程。）
> 赠送额度用完后，通过微信支付购买「次数包」继续使用：
> ¥10=100 积分 / ¥50=600 / ¥100=1500 / ¥500=10000（¥0.10/积分起，档位越大越便宜）。
> 每次查询扣 **1~5 积分**（按工具），**即每次实际 ¥0.1~0.5** —— 别把「¥0.10/积分」当成「¥0.10/次」。
> 余额够就静默扣，不足以支付下一次调用时才弹支付。
> ✅ 余额**按设备保存**：同一台设备换对话、隔天再用都续得上，**积分不过期**。

## API 概览

**基础 URL**: `https://mcp-server.zhiliaobiaoxun.com/api_pay/{工具名}`

**调用方式**: POST 请求
```
Headers:
  Content-Type: application/json
  X-Device-Id: <设备号，见下方「设备号」章节，每次调用都带>
  X-Skill-Id: zlbx-bidding-payskill   # 固定值，用于来源归因，不要改
```

> ⚠️ 本版本**不使用** `X-API-Key`。计费与鉴权由微信支付 X402 次数包完成。

---

## 💳 付费前置检查（进入任何工具调用前必须先做）

调用本 Skill 的任何工具前，检查当前 Agent 是否已安装 `weixinpay` 插件（extension）：

- **已安装** → 可继续，按下方「付费工作流程」执行
- **未安装** → 向用户提示：「当前 Agent 暂不支持微信支付付费能力，无法使用本服务；你也可以改用配置 API Key 的 `zlbx-bidding` 版本。」然后终止流程

> 即使当前有赠送额度可用，也应先完成这项检查：赠送额度用完后必须走微信支付购买次数包，
> 在不支持支付的环境里提前告知用户，好过用完额度才发现付不了款。

---

## 🔑 设备号（进入付费流程前，必须先准备好）

余额靠设备号绑定，所以**每次接口调用都要带 `X-Device-Id`**。设备号按以下步骤获取（一次生成、长期复用）：

1. 读文件 `~/.zlbx_pay/device.json`：
   - 若存在且含 `device_id` → 直接用它。
2. 若不存在：
   - `mkdir -p ~/.zlbx_pay`
   - 生成一个 32 位十六进制随机串作为 `device_id`（如用 uuid4 去掉横杠）
   - 写入 `~/.zlbx_pay/device.json`：`{"device_id": "<刚生成的>", "created_at": "<ISO时间>"}`
3. 之后所有 `/api_pay/*` 请求都带 Header `X-Device-Id: <device_id>`。

> 设备号只是本机稳定标识，不含隐私信息。文件被删则余额无法关联到旧包，属正常。

---

## 💳 计费模型：次数包（预付积分，用完再充）

**不是每个问题都付费。** 新设备首次调用通常会获得 100 积分赠送额度，直接开始用即可（每日额度有限，发完为止）。额度用完后，用户付一次买一个次数包（如 ¥10=100 积分），之后每次调用按工具单价扣几个积分（1~5），**余额够就静默扣、不打断**；余额不足以支付下一次调用时才再弹一次微信支付。体验等同"先免费试用→再充值→用完再充"。

## 💳 工作流程

### 第一步：发起数据请求
按用户意图选择工具，构造请求体，POST 到 `https://mcp-server.zhiliaobiaoxun.com/api_pay/{工具名}`，**始终带 Header `X-Device-Id`**。

### 第二步：处理 402（余额不足/首次，需购买）
收到 **HTTP 402** 说明该设备的赠送额度已用完、且没有可用次数包余额。**新设备第一次调用通常不会走到这里**（会先拿到赠送额度）。响应返回：
- Header `WeixinPay-Required`（payment_code）、`X-Out-Trade-No`
- Body 含 `amount`、`description`（档位说明）

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 5 个文件，合计 35.9 KiB