前言¶

做政企銷售、解決方案或市場研究時，常見需求不是「全國掃一遍關鍵詞」，而是盯住某個省、市甚至區縣：最近有哪些採購意向、招標公告，預算大概多少。自己在瀏覽器裏翻各地公共資源交易中心，或用通用搜索拼站點名，往往慢、漏、難按時間排序。

下面介紹 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 的定位是「地方標訊極速檢索」，與包內完整的知了標訊能力說明一致，核心檢索能力包括：

1. search_bids：按關鍵詞、省份 / 城市 / 區縣、金額區間、公告時間等檢索招/中標列表；列表默認按 pub_time 倒序（用戶未指定排序時，Skill 規範默認近 90 天、全國；做地方檢索時應顯式傳入地域，而不是依賴默認全國）。
2. query_bids_advanced：在常規參數基礎上支持關鍵詞分組、排除詞；地域參數與 search_bids 相同（provinces、cities、counties）。
3. 詳情與時間線：get_bid_detail、get_bid_timeline 用於單條公告正文與項目全階段進展。
4. 商機延伸：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 不會加載）。常見路徑如下：

示例（將目錄換成你環境對應的路徑）：

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（或使用包內文檔允許的自動註冊流程）的用戶。

使用注意

1. 地域參數是硬約束：本 Skill 簡介明確要求「必須嚴格應用地域過濾器參數」。用戶說了「廣東」「深圳」時，應在請求裏體現爲 provinces / cities（及必要的 counties），避免 silently 落到默認「全國」。
2. 域名不要混用：查數據只用 mcp-server.zhiliaobiaoxun.com 的 /api_v2/；註冊、充值相關接口在 ai.zhiliaobiaoxun.com 的 /web-api/ 下，拼錯前綴會直接 404。
3. 金額單位：篩選參數 min_amount / max_amount 爲萬元；響應裏同時有 money（元）和 money_wan（萬元），對外展示建議直接用 money_wan。
4. 額度與隱私：查詢消耗賬戶積分；免費/試用賬戶聯繫人電話可能脫敏（contact_privacy: "masked"），包內禁止用其他渠道補全號碼。
5. 能力邊界：針對單條公告的投標決策、長期商機雷達、企業盡調報告、寫標書等，包內文檔指向同系列其他 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