技能介绍

解决招投标信息搜集的工程化痛点

在招投标业务中，信息分散在各省市的政府采购网和企业招标平台上。开发一个招投标监控或查询应用时，往往需要耗费大量精力去处理反爬、多源数据清洗和页面结构变动。对于 AI 智能体开发者而言，直接对接一个结构化、标准化的招投标数据 API，远比自己写爬虫去各个站点抓取要可靠。本技能旨在为 Agent 提供全国招标公告、中标结果及采购信息的标准化查询能力，将繁琐的数据获取过程转化为简单的工具调用。

核心能力与调用机制

该技能封装了阳光标讯平台的 RESTful API（基础路径 https://www.sunbidinfo.com/api/v1），暴露了 6 个核心工具供 Agent 按需调用。

多维检索：通过 search_bids 工具，Agent 可以结合关键词、省份、城市、行业、招标方式及发布日期等十几个参数进行精准过滤。
实体与详情：使用 search_companies 和 list_buyer_companies 查找采购方或中标方背景；通过 get_bid_detail 获取单条标讯的完整结构，包括代理机构、时间节点和附件列表。
元数据与统计：get_bid_filters 返回当前可用的筛选项枚举值，get_bid_stats 则提供平台数据总量和日新增规模。

调用流程非常直接：开发者在阳光标讯官网注册并创建 API Key 后，将其配置到 Agent 环境中。当用户提出“查一下最近深圳医疗设备招标”等请求时，Agent 会自动解析语义，拼装参数并发起请求。

计费限制与工程避坑

接入第三方数据服务时，计费与限流是必须处理的工程问题。本技能采用按次扣减积分的模式（每次调用消耗 1 积分）。在代码实现层面，开发者需要特别注意以下响应处理：

余额不足（402）：API 会返回 402 Payment Required，并携带 X-Point-Balance 响应头。Agent 应捕获此状态并引导用户充值或签到。
双重限流（429）：为了防刷，服务端实施了两层限流。第一层是每用户每分钟 10 次（基于 X-RateLimit-Limit-User），所有 API Key 共享配额；第二层是每 Key 每小时限流（默认 500 次，基于 X-RateLimit-Limit）。触发限流时不扣积分，但 Agent 需具备重试退避机制。
IP 白名单（403）：如果服务端 IP 不在 Key 的配置白名单内，请求会被拒绝，需检查网络出口配置。