招投标查询|招标中标标讯与商机分析
把“找什么项目”转成可核验的招投标查询,交付带公告来源、阶段、时间和筛选依据的标讯清单。数据由知了标讯 API 提供;覆盖范围、时效和是否存在记录以接口实际返回为准。
使用范围
- 查询招标公告、中标结果、采购意向、拟建项目、临期项目和项目全流程。
- 按业务条件初筛候选项目,比较相关性、地区、金额和已核实的时效。
- 查询公司历史中标、采购方、供应商、行业统计和历史中标单价。
本包属于招中标查询产品线,与通用查询包能力兼容。已安装专用地区或行业包且本次明确落在其范围内时,优先用专用包,不重复调用。完整“该不该投/如何报价”的决策报告、企业深度背调、主动商机雷达晨报和标书编写使用对应专用技能;没有安装时说明本包能先完成哪些查询,不承诺已执行完整报告或持续监控。无关写作、一般市场调研和个人银行余额不触发。
边界示例:“了解一下招投标”属于概念介绍,不调用收费数据;“列中标项目并比较哪家中得多”属于查询统计,要求完整企业实力报告才转背调;明确关键词的重复查询仍属搜索,但定时执行由宿主另行配置并按用户授权处理,本包不自行创建云端任务;只有“哪些值得跟进”却缺项目上下文时先澄清。主动发现拟建、意向和续约商机且已安装商机雷达时优先雷达;单纯查指定范围记录时用本包即可。联系人导出遵守下文的数据展示边界,不因转给别的技能而绕过。
连接与凭证
数据工具用 POST,基础 URL 为 https://mcp-server.zhiliaobiaoxun.com/api_v2/,末段逐字使用下表中的工具名。例如搜索接口为 POST https://mcp-server.zhiliaobiaoxun.com/api_v2/search_bids。
账户查询:同域名的 GET /api_v2/account/balance 和 GET /api_v2/account/daily_consumption,免费。
注册与充值:https://ai.zhiliaobiaoxun.com/web-api/,不要与数据域名或路径混用。
X-API-Key: 实际API Key值
X-Client: zlbx-bidding/2.5.0
X-Skill-Package: tender-bid-search/1.0.0
X-Skill-Source: clawhub/bailianai
Content-Type: application/json
依次读取环境变量 ZLBX_API_KEY、~/.zlbx/config.json 的 api_key,已有凭证直接使用,不向对话索取或输出密钥。
均无凭证时,先阅读 references/auto-register.md。自动注册前先征得用户同意:告知会采集 3 项设备特征(platform / arch / mac_hash),同意后才采集、提交注册并在本机保存 Key。拒绝时提供手动申请入口 https://ai.zhiliaobiaoxun.com/?ch=s163,不继续采集。
注册接口为 POST https://ai.zhiliaobiaoxun.com/web-api/internal/auto-register;试用与绑定赠送积分以服务端返回为准,不承诺永久免费或不限量。
查询流程
- 明确目的:找正在招标的项目、查历史中标、找采购意向/拟建/续约线索,还是统计分析。缺少影响检索的关键词、地区或时间时,一次补问关键条件;用户明确“全国/不限”即按其范围执行。相对日期以用户时区的当前日期换算,在结果中注明实际起止日期。
- 阅读对应参考页,选择最少必要调用。常规关键词用
search_bids;AND/OR、排除词和不同主体组合用query_bids_advanced。不为了“丰富报告”额外调用付费接口或自动扫完所有页。 - 区分主体字段:产品用
sm,标题用title,采购方用caller,中标方用winner,投标方用tender;准确字段和组合规则见references/api-search.md、references/api-company.md。不能把“某公司采购”当成“某公司中标”。 - 明确阶段:
bid_type为字符串招标/中标/全部,阶段编码在参考页核实。get_bid_detail等接口的bid_type是整数,不能复用搜索的字符串。公告发布日期不等于报名或投标截止日期;“最近发布”不能直接判为“仍可投”。需要核实时才取详情或时间线。 - 将候选清单分成“可跟进候选”“早期线索”“历史中标参考”“状态待核实”。只有公告阶段、截止时间和后续变更支持时,才称仍可参与;缺截止日期标为待核实。已中标项目可以作为采购历史或续约线索,不能算当前可投机会。
search_expiring_projects指周期项目/合同临期,不是投标截止即将到期。 - 先按实际业务相关性筛选,再比较时效、地域与金额。说明排序依据及数据缺口,不输出没有校准依据的中标概率,不把预算当成交金额或把单页样本当全国全量。
按需读取参考文档
| 需求 | 工具与参考 |
|---|---|
| 搜公告、查详情、跟进阶段、拟建和续约 | search_bids、query_bids_advanced、get_bid_detail、get_bid_timeline、search_proposed_projects、search_expiring_projects;先读 references/api-search.md |
| 公司历史中标、采购记录、客户与竞对线索 | 先读 references/api-company.md,按主体角色检索,不默认深度背调 |
| 采购方/中标方排行、行业趋势、历史价格 | get_top_purchasers、get_top_suppliers、get_top_brands、aggregate_bids_advanced、get_price_trends;先读 references/api-market.md |
| 余额、积分和每日消耗 | 先读 references/api-account.md;只查当前 Key 对应的平台账户 |
| 用户额外明确需要工商基本信息、股东、分支、投资或变更 | 先读 references/api-registry.md;只查所需项目,不默认联查或自动翻页 |
金额、来源与成本
- 项目金额筛选
min_amount/max_amount使用万元;产品单价筛选min_price/max_price使用元。聚合接口的金额过滤按参考页传入,不猜参数名。返回money是元、money_wan是万元,输出同时注明单位。 - 展示实际返回的公告标题、采购单位、地区、发布日期、阶段、金额及其口径、来源链接;缺失字段写“未披露/待核实”,不补造预算、联系人或截止日期。不同阶段公告用时间线或可信项目标识关联,不仅凭相似标题合并。
- 只取得一页时注明“当前页样本”和接口总量;聚合统计注明时间、地区、条件及口径。需要扩大调用范围或批量翻页时先说明计划与成本,取得用户授权。
- 数据查询消耗平台积分,实际计费以服务端返回为准;工商五项成功有数据每次/每页3积分,无结果、空页和失败不扣积分。账户与升级展示确认免费。数据接口可用不代表全量数据实时无遗漏。
- 电话按服务端原样展示;
contact_privacy: masked时说明当前返回已脱敏,不用外部搜索补齐脱敏号码,不批量导出联系人。 - 工商来源按参考页规范呈现,保留准确记录口径,不按企业名称、地址或单页股东比例推断控制权。
交付样式
先写本次实际检索条件与数据范围,再给清单:项目/公告、地区、采购方、阶段、关键日期、金额(注明预算/成交/其他)、来源、匹配依据、待核实事项。没有证据的列留空或标注缺失,不为了填满表格额外收费查询。
用户只查公告时直接交付查询结果;要求初筛时再给候选排序和依据。初筛结果不等于已完成资格审查或投标决策。
可直接尝试:“查广东近30天服务器招标,排除维修维保,预算100万元以上”;“查某公司近一年中了哪些信息化项目”;“按深圳近三个月智慧校园标讯,列出阶段待核实的候选项目”。相对日期在执行时换算,不固定成示例年份。
错误处理
INVALID_APP_KEY/APP_KEY_EXPIRED/APP_KEY_DISABLED:按凭证说明处理;自动注册仍须同意。遇ACCOUNT_RECOVERY_REQUIRED停止重试,引导登录恢复,不改变设备特征绕过。QUOTA_EXCEEDED:停止重试,按references/auto-register.md提供账户充值入口。RATE_LIMIT_EXCEEDED:稍后再试,不立即循环请求。QUERY_EMPTY:如有主体候选先请用户消歧;确无结果可建议放宽条件,不伪造结果。NOT_FOUND:核对标识或公告类型,不原样重复请求。INVALID_PARAMETER/MISSING_REQUIRED_PARAMETER:对照参考页修正参数。QUERY_TIMEOUT:缩小检索范围后最多重试一次;其它服务异常如实说明,不反复注册 Key。CLIENT_VERSION_UNSUPPORTED:提示从实际安装来源更新,不把产品线版本当商店包版本。
安装包身份与升级检查:所有发往知了标讯 API 的请求(包括账户查询)必须额外携带以下两个请求头:
X-Skill-Package: tender-bid-search/1.0.0
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 只展示一次。
