技能介绍

要解决什么问题

做招中标相关的自动化分析时，Agent 往往只能靠网页搜索拼凑信息，缺少可分页、可过滤的结构化标讯数据，也很难把「某公司发了哪些标」「谁和它抢过标」「某品牌历史中标价」串成一条分析链路。本技能把知了标讯的开放 API 封装成 16 个标准化工具，供 Claude Code、Cursor、Codex 等在对话里直接 POST 调用，适合多步任务编排和下游 JSON/图表消费。

技能如何工作

标讯搜索：search_bids、query_bids_advanced（支持 keyword_groups 与排除词）、get_bid_detail、search_expiring_projects 查临期周期性项目。
企业分析：search_company 匹配总部与分子公司后，可用 get_company_profile、get_company_business_keywords、get_company_partners、get_company_contacts，以及 find_competitors、find_potential_bidders。
市场分析：get_top_purchasers / get_top_suppliers / get_top_brands、aggregate_bids_advanced、get_price_trends。

鉴权按优先级读取环境变量 ZLBX_API_KEY 或 ~/.zlbx/config.json；均未配置时才走自动注册并写入本地配置。查询精度上，match_modes 决定关键词落在哪些字段——查采购单位招标用 caller，查中标/投标参与用 winner / tender，产品检索常用 sm。复杂条件用 keywords（OR）+ keyword_groups（AND，需高级接口）+ exclude_keywords 组合；公告阶段由 bid_process 控制，默认覆盖意向、预招标、招标、中标、合同等阶段。

典型编排：先 search_bids 拉项目 → 批量 get_company_profile → aggregate_bids_advanced 汇总；或定时跑 search_expiring_projects 做商机监控。

适用边界与注意点

数据以标讯库为准；趋势预测、公司战略、政策解读等宜结合 WebSearch，且 标讯数据优先、网页信息为辅。
分页默认 page_size 最大 50；遇 RATE_LIMITED 需降频重试。
额度用尽时：若 key 来自自动注册（config.json 中 source == "auto"），按技能说明走设备 sid 与充值链接；若为手动配置的 ZLBX_API_KEY，走官网手动充值流程，勿混用自动登录引导。
参数细节见技能内 references/api-search.md、api-company.md、api-market.md。