前言¶
接入招投標數據時，常見路徑是先讀接口文檔，再手工拼 UTF-8 JSON 的 POST 請求體：地區、時間窗、公告類型、關鍵詞往往要拆成多個字段。業務同事更習慣用一句話描述需求，開發側卻要反覆對照參數表改寫。若還要串聯招標、中標、合同、附件等多個接口，出錯點和溝通成本都會上去。
下面介紹 SkillHub 上的「招投標自然語言搜索助手」，讓 Agent 在對話裏理解查標意圖，按技能說明選擇並調用對應接口，並處理請求體與響應解析。
這是什麼¶
招投標自然語言搜索助手（座標 @org-mbvufw6y/bid-natural-language-search-assistant，當前版本 1.0.4）是面向 business-ops 的企業級 Skill，發佈者爲 精英量界，來源標註爲 enterprise。
官方簡介將其定位爲招投標數據 API 調用助手：覆蓋招標、中標、採購意向、合同公告、項目詳情與附件、擬在建項目、企業畫像及 自然語言查標 等 20 個接口；按需求選擇或串聯接口，生成 UTF-8 JSON POST 請求體，並解析響應與錯誤碼。標籤 requires_api_key=true，使用前需準備招投標數據 API 的密鑰（具體申請方式以數據服務方文檔爲準）。
SkillHub 頁面：https://www.skillhub.cn/skills/org-mbvufw6y/bid-natural-language-search-assistant
API 座標頁：https://api.skillhub.cn/org-mbvufw6y/bid-natural-language-search-assistant
核心功能¶
以下能力均來自 SkillHub 官方頁面與抓取元數據，不展開未在資料中出現的字段數量或第三方品牌歸屬。
-
自然語言查標
在 Agent 對話中用業務語言描述檢索目標，由 Skill 引導改寫爲可執行的 API 條件併發起查詢（與手工對照文檔拼 JSON 相比，條件生成由 Agent 按技能規範完成）。 -
多類公告與項目數據
技能說明覆蓋招標、中標、採購意向、合同公告、擬在建項目等類型，並支持項目詳情、附件及企業畫像相關接口。 -
接口編排與請求構造
按場景選擇單個接口或串聯多個接口，輸出符合要求的 POST 請求體（UTF-8 JSON），並說明如何解讀返回與錯誤碼。 -
面向 API 不熟的用戶
目標用戶包括需要快速完成招投標數據查詢與接入、但不熟悉底層 HTTP 細節的開發者或實施人員。
安裝與啓用¶
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查本機是否已有 skillhub：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝本 Skill 到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能無法被 Agent 加載。
skillhub install @org-mbvufw6y/bid-natural-language-search-assistant --dir <你的 skills 目錄>
常用路徑示例（以 SkillHub 安裝文檔爲準）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
也可將下面提示詞發給已支持 Skill 安裝的 AI，讓其按官方安裝說明拉取本技能：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@org-mbvufw6y/bid-natural-language-search-assistant`。
3、配置 API Key¶
技能標記爲需要 API Key。在 Agent 或環境變量中按你所用招投標數據服務的說明配置密鑰後，再在對話中發起查標請求。
典型用法¶
經過上面的安裝與密鑰配置，可在 Cursor、Claude Code 等客戶端中直接用自然語言描述檢索需求，由 Agent 加載本 Skill 後完成接口選擇與請求構造。官方資料未給出固定「示例響應」文本，下列爲與技能定位一致的 對話式提問方式（需已配置有效 API Key）：
- 說明時間與地域、品類，例如希望查詢某一時間段、某一省份的教育類設備採購 中標 信息。
- 說明主體維度，例如查詢某公司名稱關聯的弱電類 招標 / 中標 記錄。
- 說明行業與地區，例如某地醫院的 信息化招標 公告。
Agent 應依據 SKILL 內對接口與參數的定義，生成 POST 請求並回傳結構化結果或錯誤碼說明。若返回鑑權失敗，先覈對 Key 與接口權限，再縮小查詢條件重試。
適用場景與注意¶
適合誰
- 需要把招投標數據 API 接到內部系統、報表或商機流程，但不想每次手寫 JSON 的開發者。
- 政府採購網、全行業招投標檢索類產品中，負責對接數據層、又希望用對話快速試條件的實施人員。
- 希望在同一對話裏串聯「查公告 → 看詳情 → 拉附件」等多步接口的場景。
使用注意
- 企業級與密鑰：
enterprise來源且requires_api_key=true，無 Key 無法完成真實查詢。 - 版本：撰寫時 SkillHub 顯示版本爲 1.0.4；升級可用
skillhub對同一座標執行更新，並確認--dir與當前 Agent 一致。 - 數據與合規：檢索範圍、字段含義以所對接的招投標數據 API 文檔爲準；本 Skill 負責調用方式與解析指引，不替代數據源的使用協議。
- 社區指標：SkillHub 頁面顯示評分 100000、下載約 3059 次（隨平臺更新變化），選型時可結合自身 API 合約與試查結果判斷。
結尾¶
招投標自然語言搜索助手把「口語化查標」和「20 個招投標相關 API 的選型、拼包、解析」收斂進一套 Agent Skill，減少反覆翻文檔和手工拼 JSON 的時間。若你要在 Cursor 等環境裏試裝，可從官方 Skill 頁與安裝文檔入手：
https://www.skillhub.cn/skills/org-mbvufw6y/bid-natural-language-search-assistant
