前言¶
做政企销售、解决方案或市场研究时,常见需求不是「全国扫一遍关键词」,而是盯住某个省、市甚至区县:最近有哪些采购意向、招标公告,预算大概多少。自己在浏览器里翻各地公共资源交易中心,或用通用搜索拼站点名,往往慢、漏、难按时间排序。
下面介绍 SkillHub 上的社区 Skill「地方标讯极速检索-比地招标」。它把 Agent 的调用约束在地域过滤器上,对接知了标讯(比地招标)的招中标数据 API,按发布时间倒序返回地方采购类公告,并带上预算金额字段,适合在对话里做「下沉地域」的标讯检索。
这是什么¶
一句话定位:当用户明确指定省份、城市或更细地域时,由 Agent 调用本 Skill,通过知了标讯 search_bids 等接口检索标讯,必须带上 provinces / cities / counties 等地域参数,结果默认按发布时间倒序,金额以响应中的 money(元)及 money_wan(万元)展示。
出品与托管:数据与 API 来自知了标讯开放平台(基础 URL 为 https://mcp-server.zhiliaobiaoxun.com/api_v2/);Skill 包由 SkillHub 社区用户 user_c2c676b2 发布,坐标 @user_c2c676b2/local-tender-express-search-bidizhaobiao,当前版本 2.1.10,分类 business-ops,来源 community。SkillHub 页面显示作者为 Wangp。
在 SkillHub 上的概况(以页面与 API 元数据为准):评分 100000,下载 2484,安装 29;标签标明 requires_api_key=true。
核心功能¶
本 Skill 的定位是「地方标讯极速检索」,与包内完整的知了标讯能力说明一致,核心检索能力包括:
search_bids:按关键词、省份 / 城市 / 区县、金额区间、公告时间等检索招/中标列表;列表默认按pub_time倒序(用户未指定排序时,Skill 规范默认近 90 天、全国;做地方检索时应显式传入地域,而不是依赖默认全国)。query_bids_advanced:在常规参数基础上支持关键词分组、排除词;地域参数与search_bids相同(provinces、cities、counties)。- 详情与时间线:
get_bid_detail、get_bid_timeline用于单条公告正文与项目全阶段进展。 - 商机延伸:
search_proposed_projects(拟建)、search_expiring_projects(临期)等,均可配合provinces等地域参数做区域商机扫描。
包内还定义企业分析、市场聚合、账户余额查询等共 25 个工具;本 Skill 名称强调的场景是地域下沉的标讯列表检索,企业画像、竞对分析等由同一包内的其他工具承接,需要时再在对话中说明即可。
鉴权与环境:调用数据接口需 ZLBX_API_KEY(请求头 X-API-Key),并携带固定客户端头 X-Client: zlbx-bidding/2.5.0 以及包身份头 X-Skill-Package: local-tender-express-search-bidizhaobiao/2.1.10、X-Skill-Source: skillhub/user_c2c676b2。Key 优先读环境变量,其次 ~/.zlbx/config.json;均未配置时,包内文档说明可在用户同意后走自动注册流程(详见包内 references/auto-register.md),手动申请入口为 https://ai.zhiliaobiaoxun.com/?ch=s08 。
安装与启用¶
1. 安装 SkillHub CLI(若尚未安装)¶
先检查是否已有 CLI:
command -v skillhub && skillhub --version
未安装时,按 SkillHub 官方安装文档执行完整安装(推荐):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI、不装默认 Skill 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装本 Skill 到当前 Agent 的 skills 目录¶
官方页面给出的安装提示为:根据 https://skillhub.cn/install/skillhub.md ,安装 @user_c2c676b2/local-tender-express-search-bidizhaobiao。
命令行安装时需用 --dir 指向当前 Agent 实际读取的 skills 目录(装到错误目录 Agent 不会加载)。常见路径如下:
| Agent / 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
示例(将目录换成你环境对应的路径):
skillhub install @user_c2c676b2/local-tender-express-search-bidizhaobiao --dir ~/.cursor/skills/
安装完成后,按你所用客户端的要求重启或刷新 Agent,使 Skill 生效。
3. 配置 API Key¶
在 shell 或 Agent 环境中设置:
export ZLBX_API_KEY="你的知了标讯 API Key"
或将 Key 写入 ~/.zlbx/config.json:
{"api_key": "zlbx_xxx", "source": "manual"}
注意:请求头里应填写真实 Key 字符串,不要把字面量 $ZLBX_API_KEY 发给服务端,否则会得到 INVALID_APP_KEY。
典型用法¶
在对话里触发(推荐)¶
用户侧用自然语言说明地域 + 主题 + 时间即可,例如:「查近三个月广东省、深圳市与人工智能相关的招标公告,按时间从新到旧,带上预算。」Agent 应选用本 Skill,并在调用 search_bids 时严格传入地域过滤器,例如 provinces: ["广东"]、cities: ["深圳"],而不是只搜关键词却默认全国。
Skill 规范要求首屏先给结论:命中总数、实际筛选条件,再列前几条简表(标题、采购方、金额万元、发布日期、地区);金额展示优先使用响应字段 money_wan。
直接调用 search_bids(HTTP 示例)¶
数据接口为 POST,完整 URL 示例:
POST https://mcp-server.zhiliaobiaoxun.com/api_v2/search_bids
请求头(Key 替换为真实值):
X-API-Key: zlbx_xxxxxxxx
X-Client: zlbx-bidding/2.5.0
X-Skill-Package: local-tender-express-search-bidizhaobiao/2.1.10
X-Skill-Source: skillhub/user_c2c676b2
Content-Type: application/json
地方检索示例(包内「常见场景」中与地域相关的写法):指定省份与时间窗,检索多关键词招标信息:
{
"keywords": ["人工智能", "大模型"],
"bid_type": "全部",
"provinces": ["北京", "广东"],
"begin_date": "2025-01-01"
}
下沉到省 + 城市 + 金额下限(拟建项目场景,金额单位万元):
{
"keywords": ["智慧校园"],
"provinces": ["广东"],
"cities": ["深圳"],
"approval_status_code": 3,
"min_amount": 100
}
对应接口为 POST /api_v2/search_proposed_projects;常规已发布公告仍用 search_bids,地域字段为 provinces / cities / counties,项目金额筛选统一用 min_amount / max_amount,单位万元(用户说「1000 万以上」传 1000)。
高级检索需要「主关键词 AND 分组关键词」或排除词时,改用 query_bids_advanced,地域参数与 search_bids 一致。
账户与额度(不扣积分)¶
会话首次使用本 Skill 时,包内建议用免费 GET 查询余额与升级提醒:
GET https://mcp-server.zhiliaobiaoxun.com/api_v2/account/balance
同样携带 X-API-Key 与上述 X-Client、X-Skill-Package、X-Skill-Source 头。
适用场景与注意¶
适合谁
- 需要在对话中快速拉取指定省市区的采购/招标公告列表,并按时间看最新动态的团队。
- 已使用 Cursor、Claude Code、Codex 等支持 SkillHub 安装方式的 Agent 环境,并愿意配置知了标讯 API Key(或使用包内文档允许的自动注册流程)的用户。
使用注意
- 地域参数是硬约束:本 Skill 简介明确要求「必须严格应用地域过滤器参数」。用户说了「广东」「深圳」时,应在请求里体现为
provinces/cities(及必要的counties),避免 silently 落到默认「全国」。 - 域名不要混用:查数据只用
mcp-server.zhiliaobiaoxun.com的/api_v2/;注册、充值相关接口在ai.zhiliaobiaoxun.com的/web-api/下,拼错前缀会直接 404。 - 金额单位:筛选参数
min_amount/max_amount为万元;响应里同时有money(元)和money_wan(万元),对外展示建议直接用money_wan。 - 额度与隐私:查询消耗账户积分;免费/试用账户联系人电话可能脱敏(
contact_privacy: "masked"),包内禁止用其他渠道补全号码。 - 能力边界:针对单条公告的投标决策、长期商机雷达、企业尽调报告、写标书等,包内文档指向同系列其他 Skill 或知了商机大师 Agent;本 Skill 侧重数据查询,尤其是地域维度的标讯检索。
结尾¶
「地方标讯极速检索-比地招标」把 Agent 的地方采购检索接到知了标讯 API 上,用省、市、区县过滤器收窄范围,按时间倒序查看公告与预算。安装走 SkillHub 坐标 @user_c2c676b2/local-tender-express-search-bidizhaobiao,配置 ZLBX_API_KEY 后即可在对话或 HTTP 层复现上述检索。
官方 Skill 页面:https://www.skillhub.cn/skills/user_c2c676b2/local-tender-express-search-bidizhaobiao
API 元数据地址:https://api.skillhub.cn/user_c2c676b2/local-tender-express-search-bidizhaobiao