知了标讯官方招投标助手

SKILL.md 节选

# 知了标讯 - 全网招中标数据平台

## API 概览

**基础 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`（余额）、`GET …/api_v2/account/daily_consumption`（每日消耗） |
> | **注册取 Key / 取充值链接** | `https://ai.zhiliaobiaoxun.com/web-api/` | `POST …/web-api/internal/auto-register`、`POST …/web-api/auth/generate-device-sid` |
>
> 下文出现的相对路径（如 `/api_v2/search_bids`）一律拼**第一行**那个域名；
> 只有注册与充值链接相关的接口才用第二行。**绝不要把 `/web-api/` 拼到 mcp-server 上，
> 也不要把 `/api_v2/` 拼到 ai 域名上。**

**调用方式**: 数据工具使用 POST 请求；账户查询使用 GET，路径固定为 `GET /api_v2/account/balance`（余额）和 `GET /api_v2/account/daily_consumption`（每日消耗），免费、不扣额度。
```
Headers:
  X-API-Key: $ZLBX_API_KEY
  X-Client: zlbx-bidding/2.5.0
  Content-Type: application/json
```
> ⚠️ **`X-API-Key` 要填真实的 Key 字符串，不要把 `$ZLBX_API_KEY` 原样写进请求头**。环境变量没设时它会变成空值，服务端收到的就是「没带 Key」——直接 `INVALID_APP_KEY`，而不是你以为的「Key 错了」。**取不到 Key 就先走下面的获取流程，不要先把请求发出去。**


> **X-Client 头必须携带**（值固定为 `zlbx-bidding/2.5.0`，账户查询 GET 请求同样携带），用于服务端区分调用来源，缺失不影响功能但请始终带上。

**API Key 获取**（按以下优先级，命中即停，不要做任何额外提示）：

1. 环境变量 `$ZLBX_API_KEY`（用户主动配置）→ 直接用
2. 本地配置文件 `~/.zlbx/config.json` 中 `api_key` 字段 → 直接用
3. **以上都没有 → 自动注册**（仅此场景下才走自动机制，**必须先征得用户同意**，详见 `references/auto-register.md`）：
   - 先一句话告知将采集哪些设备特征并征求同意；用户拒绝则给出手动申请地址 https://ai.zhiliaobiaoxun.com/?ch=s59 ，流程终止
   - 同意后采集 3 项设备特征（platform / arch / mac_hash），任何采集失败都用空串代替，**不要中断**
   - POST `https://ai.zhiliaobiaoxun.com/web-api/internal/auto-register`
   - 返回的 `api_key` 写入 `~/.zlbx/config.json`：`{"api_key": "zlbx_xxx", "source": "auto", "registered_at": "<ISO 时间>"}`
   - 当前会话立即用该 key 继续工作；新设备账号赠送 100 次免费调用，绑定手机号再送 100

> **重要**：若 `$ZLBX_API_KEY` 已配置或 config.json 中 `source` 不是 `"auto"`，本 SKILL 不输出任何关于「自动注册」「自动登录」「设备绑定」相关内容，按现有手动充值流程提示用户。


---

## 工具列表（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` | 公司基础工商信息、行业、招中标次数 |

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

技能包内容

共 7 个文件，合计 69.7 KiB