前言¶
銷售、售前和商務運營常要在招標網站之間切換：篩地區、跟採購意向、盯臨期續約，再單獨查某家公司的中標記錄和合作方。把同樣的問題交給大模型，若不走數據接口，很容易用「看起來像」的表述湊答案，金額、截止時間和聯繫人都會對不上。
下面介紹 SkillHub 上的「招投標情報助手【千里馬官方】」（技能 slug：qianlima-bidding-search，發佈者標識 user_92d9d745）。它把千里馬招標網側的能力封裝成 Agent Skill：標訊、採購意向、臨期項目、企業情報和賬號權益，都通過 scripts/qianlima_skill.py 調 API 取數；Skill 說明明確要求事實只來自腳本與接口響應，不要用模型記憶代替查詢。
這是什麼¶
一句話定位：面向招投標與企業情報查詢的官方 Skill 包，用 Python 腳本對接千里馬技能 API，供 Agent 在對話中按意圖選命令並回傳結構化結果。
維護與數據側歸屬千里馬體系（Skill 內賬號入口指向千里馬 AI 平臺；接口默認基址爲 https://skills.qianlima.com）。在 SkillHub 社區中，該技能分類爲 business-ops，公開評分約 99548，下載約 560 次（數據來自 SkillHub 頁面線索，以社區展示爲準）。
SkillHub 列表名稱可能顯示爲「招標信息查詢｜千里馬·乙方寶」等變體，與 slug qianlima-bidding-search 對應；安裝時需使用命名空間 indiv-qianlima。
核心功能¶
以下能力均來自已安裝的 Skill 包（SKILL.md、manifest.json 與能力參考文檔），按用戶意圖分路由。
標訊與普通項目¶
適用於招標公告、中標公告、中標結果、成交公告、成交結果、候選人公示、查標訊、招標項目等。支持按關鍵詞組、金額、時間、採購方式、資金性質、是否有附件等條件檢索；指定採購方、中標方或代理機構時走普通項目 search，不必先拿企業 ID。
追問單條時可拉取聯繫人、截止時間、標的物、金額、代理機構、詳情頁或原文鏈接；還可按需讀取正文（full-text）、附件（attachments）、招中標進展（timeline）。
採購意向¶
適用於採購意向、採購計劃類查詢。支持預算區間、預計採購時間、採購需求及詳情頁；詳情與列表協議與普通項目分開，需使用 search-purchase 及對應的 --result-type。
臨期項目與續約機會¶
適用於臨期項目、合同快到期、臨期續約機會。使用 search-expiring；詳情側支持臨期項目自身字段與來源鏈接。
企業情報¶
適用於某公司中標項目、合作供應商、合作甲方、採購/中標地區分佈、直接或潛在競爭對手、企業工商信息；在用戶明確索要聯繫方式時使用企業聯繫人、企業電話能力。公司簡稱或品牌名先 search-company 消歧，不自動替用戶選定排名第一的主體。
連續追問與權益¶
分頁與改條件：next、refine；已知公告 ID 可直接 detail。會話狀態依賴 follow_up.session_id / result_set_id，緩存失效時用 --context-json 恢復條件。
賬號側只讀查詢：當前可用積分、原文月度剩餘次數與重置時間等，走 entitlement（對應用戶關心的版本、服務地區、已開通權益、額度與重置時間類問題——具體字段以接口返回爲準，Skill 說明積分接口不能替代完整套餐清單）。
事實邊界（重要）¶
- 僅在需要調用項目、採購意向、臨期項目、企業情報或權益接口時使用本 Skill；不要憑模型記憶回答標訊事實。
- 正常零結果、空字段按「未公示」處理；權限、積分、地區受限時保留 API 返回原因，不編造項目。
- 註冊、API Key、充值入口固定爲：
https://ai.qianlima.com/?source=63f34880b4ff9d47269f7acc（須保留完整 URL 與source參數）。
安裝與啓用¶
運行環境要求 Python 3.10+（見 manifest.json）。
從 SkillHub 安裝技能包¶
在已安裝 SkillHub CLI 的機器上，執行：
skillhub install qianlima-bidding-search --namespace indiv-qianlima
默認會將技能目錄落到當前環境下的 Skill 存儲路徑；也可指定目錄，例如：
skillhub install qianlima-bidding-search --namespace indiv-qianlima --dir /path/to/your/skills
下載地址形如：https://api.skillhub.cn/api/v1/download?slug=qianlima-bidding-search&namespace=indiv-qianlima。
官方 Skill 頁（API 域名）：https://api.skillhub.cn/user_92d9d745/qianlima-bidding-search。
配置 API Key 與環境變量¶
在 千里馬賬號平臺 註冊並獲取 API Key 後，配置環境變量（Skill 運行時讀取，勿寫入對話或交付文檔）：
export QIANLIMA_API_KEY="你的密鑰"
可選變量（見 manifest.json）：
| 變量 | 作用 |
|---|---|
QIANLIMA_BASE_URL |
API 基址，默認 https://skills.qianlima.com |
QIANLIMA_SKILL_SESSION_ID |
會話標識，用於多輪狀態 |
QIANLIMA_SKILL_STATE_DIR |
本地狀態存儲目錄 |
接入 Agent / IDE¶
manifest.json 標明兼容 OpenClaw ClawHub 目錄、Agent Skills 的 SKILL.md 包及 SkillHub 風格目錄。將安裝後的整個技能文件夾掛到你所用 Agent 的 Skills 加載路徑即可；Cursor、Codex CLI、Claude Code 的具體目錄名因產品版本而異，以各產品當前「Skills / 技能」文檔爲準，本 Skill 包內未單獨維護分客戶端安裝腳本。
啓用後，Agent 應閱讀技能根目錄的 SKILL.md，在技能根目錄調用：
python3 scripts/qianlima_skill.py <子命令> [參數]
典型用法¶
用戶側用自然語言即可；Agent 側按 SKILL.md 中的「選路與最短調用」表映射到子命令。下面兩類示例均來自官方參考文檔，便於對照驗收。
自然語言 → 意圖（對話層）¶
| 用戶說法 | Agent 應選擇的路徑 |
|---|---|
| 查 500 萬以上物業招標項目 | search，業務關鍵詞組，金額下限 5000000 |
| 查深圳市城市服務有限公司中標項目 | search，中標方角色 + 結果階段類型 |
| 找騰訊相關公司 | search-company，展示候選供用戶確認 |
| 合同快到期的物業類項目 | search-expiring |
| 還能用多少積分、原文還能看幾次 | entitlement |
更完整的語義對照見技能內 references/usage-examples.md、references/nl_parsing_examples.md。
命令行（地區解析示例）¶
地區編號須通過腳本解析，禁止手寫猜測 areaIds：
cd /path/to/qianlima-bidding-search
python3 scripts/qianlima_skill.py area --name '北京、簡陽'
python3 scripts/qianlima_skill.py area --name '朝陽區' --parent '北京'
僅當返回 resolution_status=resolved 時，才把 effective_query.areaIds 帶入後續 search / search-purchase / search-expiring 請求。
多條件 search（JSON 查詢體）¶
平鋪 AND 條件可直接 search --query-json（摘自執行樣板）：
{"keywordGroups":[{"keywords":["空調","新風"],"matchScopes":[2]},{"keywords":["安裝","改造"],"matchScopes":[8]}],"fundsSources":[1],"hasAnnex":0}
嵌套 OR/AND 邏輯需先 preflight-complex 預檢，只執行 approved_operations 中的操作，避免 Agent 自行拆成錯誤的多輪計費請求。
適用場景與注意¶
適合誰
- 需要在對話裏查全國標訊、採購意向、臨期續約線索的團隊。
- 要做招投標視角競品與客戶分析（中標記錄、合作方、地區分佈、競爭對手、工商信息）。
- 已使用 SkillHub / Agent Skills 體系，希望把「查標訊」變成可複用技能而不是每次寫爬蟲或複製網頁。
限制與坑
- 必須配置有效
QIANLIMA_API_KEY，查詢按平臺積分與權益計費；失敗時看 API 與entitlement，不要重複自動重試計費請求。 - 北京、上海、天津、重慶、香港、澳門、臺灣暫不支持區縣級篩選；用戶限定區縣時要按 Skill 說明先確認是否接受全市範圍。
- 三類搜索（普通 / 採購意向 / 臨期）協議不同，不要混用詳情類型；已知公告 ID 時優先
detail --id，減少無謂列表翻頁。 - 企業簡稱必須先消歧；企業電話僅在用戶明確要聯繫方式時調用。
- SkillHub 商店版本（如 CLI 安裝的
1.1.2）與包內manifest.json版本號可能並存，以你本地安裝目錄文件爲準升級。
結尾¶
招投標情報助手【千里馬官方】把千里馬標訊與企業情報 API 收斂成一套 Agent 可執行的命令與參考文檔：查什麼走哪條子命令、多輪怎麼續、權益不足如何說明，都在 Skill 內寫死邊界，減少「模型幻覺式標訊」。
技能主頁：https://api.skillhub.cn/user_92d9d745/qianlima-bidding-search
賬號與 Key：https://ai.qianlima.com/?source=63f34880b4ff9d47269f7acc
