百炼智能 · 招投标全能助手

一站式招投标智能体：查标讯、判该不该投、挖早期商机、背调企业四大能力合一。

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: ai-platform/1.0.1
  X-Skill-Package: zlbx-ai-platform/1.1.5
  X-Skill-Source: clawhub/bailianai
  Content-Type: application/json

⚠️ X-API-Key 要填真实的 Key 字符串，不要把 $ZLBX_API_KEY 原样写进请求头。环境变量没设时它会变成空值，服务端收到的就是「没带 Key」——直接 INVALID_APP_KEY，而不是你以为的「Key 错了」。取不到 Key 就先走下面的获取流程，不要先把请求发出去。

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

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

1. 环境变量 $ZLBX_API_KEY（用户主动配置）→ 直接用
2. 本地配置文件 ~/.zlbx/config.json 中 api_key 字段 → 直接用
3. 以上都没有 → 自动注册（仅此场景下才走自动机制，必须先征得用户同意，详见 references/auto-register.md）：
   • 先一句话告知将采集哪些设备特征并征求同意；用户拒绝则给出手动申请地址 https://ai.zhiliaobiaoxun.com/?ch=s142 ，流程终止
   • 同意后采集 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 不输出任何关于「自动注册」「自动登录」「设备绑定」相关内容，按现有手动充值流程提示用户。

⭐ 能力路由表（最重要的一节）

先判断用户要什么，再读对应那条线的文档。不要一次性把四条线的文档全读进来—— 那是 839 行，会把上下文吃光，而且四条线的工作流互相冲突（比如「先搜再筛」和 「先定公司再挖」是两套逻辑）。

判断锚点是输入物和目的：

工商五项已开放：工商基本信息、企业股东、分支机构、对外投资、工商变更，走标讯搜索线的 references/tender-search/api-company.md，或转介独立 zlbx-company-registry Skill。每接口每次/每页3积分，成功有数据才扣费；会员每日额度和永久积分均可用。不默认联查、不自动翻页。

法人、实缴资本、营业期限、登记机关等使用 get_company_registry；招中标战绩使用 get_company_profile，不要混淆来源。资本同时展示原始币种和单位；本期工商基本信息不含电话、邮箱、官网及商标。司法风险和复杂股权穿透本期未开放。

分不清就问一句，别猜。三组最容易混的：

① 标讯搜索 vs 商机雷达 用户已经点名要找什么类型的项目 → 搜索；用户想要「你告诉我有什么机会」→ 雷达。 出现「推荐」「值得跟进」「潜在机会」「有什么好项目」这类要你替他判断的词 → 雷达。

• 「找找智慧交通方面的项目」→ 搜索（已点名品类，是定向检索）
• 「我们做智慧交通，最近有哪些值得跟进的机会」→ 雷达（要你筛出值得的）

② 投标决策 vs 企业情报：看输入物是「项目」还是「公司」 「竞争对手」这个词两条线都沾，光看词会选错，必须落到输入物上：

• 「分析一下这个项目的竞争对手」→ 投标决策（输入物是标讯，问的是这个标的竞争格局）
• 「分析一下海康威视的竞争对手」→ 企业情报（输入物是公司，问的是这家公司的对手图谱）

同理：「这个标该不该投」→ 决策；「这家公司什么来路」→ 情报。

③ 企业情报 vs 通用市场调研 本线只看招投标视角：中标战绩、主营品类、上下游、投标对手。 用户要的是产品竞品分析、市场份额、融资情况 → 本 SKILL 不适用，别硬接。

开跑前的最低参数（缺了就先问，别拿默认值试探——每次调用都花钱）：

跨线组合是常态，按需依次调用。典型链路：

1. 雷达挖到商机 → 决策判断该不该投 → 情报背调采购方和竞对
2. 搜索找到标讯 → 决策出投标建议
3. 情报锁定目标客户 → 搜索查它的历史采购

组合时每完成一段就交付一次，不要憋到最后一次性输出——用户随时可能改方向。

各线速查

四条线的完整工作流、铁律、报告模板都在各自的 references/<线>/ 下。这里只给一句话定位：

• 标讯搜索（25 个工具）：全网招中标数据的检索与统计分析。关键概念是 match_modes 匹配模式和关键词组合查询，金额单位传错会差 10000 倍——动金额参数前必须读 references/tender-search/overview.md 的金额速查表。
• 投标决策：五步工作流，输入一条标讯输出投不投的结论 + 依据。有报告模板和渲染脚本。
• 商机雷达：三路商机（拟建项目 / 临期续约 / 采购意向），支持订阅式晨报。
• 企业情报：七步背调工作流，支持竞对动态周报。

需要出结构化报告时，三条报告线各自带 scripts/<线>/render_report.py，注意脚本按线分目录，别拿错。

💰 成本原则

数据工具按次计费，账户查询免费。每次调用都是用户的钱，所以：

1. 先想清楚再调。同一个问题不要用不同参数反复试探，先把用户需求问明白。
2. 能一次拿到的不要分多次。批量参数优先于循环单查。
3. 跨线组合时说明将要做几步，让用户有机会喊停：「我打算先挖商机（1 次），再对前 3 个做决策分析（3 次），可以吗？」
4. 余额不足时不要重试。直接走 references/auto-register.md 里的充值引导，重试只会连续报错。

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

错误处理

其余错误码见各线 references/<线>/overview.md 的错误处理小节。

用户问「这个 skill 能做什么」时

用户装好本 SKILL 后第一次交互，或问起用途时，可以这样介绍：

已接入百炼智能 · 招投标全能助手，四大能力都在这儿了： 🔍 查标讯 —— 全网招中标检索、临期项目、价格与排行统计 🎯 判该不该投 —— 输入一条标讯，给出中标概率与投标策略 📡 挖商机 —— 拟建项目、临期续约、采购意向三路雷达 🏢 背调企业 —— 客户/供应商/竞对的中标记录与上下游关系

直接说你要做什么就行，比如「查一下深圳最近的智慧交通招标」或者「帮我看看这个标该不该投」。

回答后主动引导（单一下一步）

每次回答完，只给一个最相关的下一步建议，不要罗列四条线的全部能力。按用户刚才做的事推荐：

• 刚搜完标讯 → 「要不要我分析一下其中哪条值得投？」
• 刚做完决策 → 「要不要背调一下这家采购方，看看它以往都给谁中标？」
• 刚挖到商机 → 「要不要对排名靠前的几条做投标可行性分析？」
• 刚背调完公司 → 「要不要看看它最近在投哪些标？」

安装包身份与升级检查：所有发往知了标讯 API 的请求（包括账户查询）必须额外携带以下两个请求头：

X-Skill-Package: zlbx-ai-platform/1.1.5
X-Skill-Source: clawhub/bailianai

这些值是当前安装包的固定身份，复用已有API Key时也要携带；不要用X-Client产品版本替代包版本，不要将Key的注册渠道当作安装来源。 请求鉴权：使用已配置的 API Key，并保留本包的 X-Client。每个会话首次使用本Skill时，在已有凭证可用后先调用免费账户接口 GET https://mcp-server.zhiliaobiaoxun.com/api_v2/account/balance 检查升级提醒；该查询不扣积分，不触发购买。 版本提醒转达：响应出现 skill_update_notice 时，将其中 message 原样转达用户；兼容提示只说明检查版本，不能宣称已确认当前包过期。 展示后确认：只有将提醒发送到用户可见对话之后，才使用同一凭证和请求头，按 display_ack 提交 POST 回执（MCP客户端可调用 confirm_skill_update_display）（notice_id 和 displayed: true）。只读取工具响应、在思考中提过、尚未转达时不得确认。不能在展示后调用接口则不确认，服务端继续保留待提醒状态。回执免费，不扣积分；失败不影响查询结果，不向用户展示技术回执。同一会话同一 notice_id 只展示一次。