前言¶
做區域市場或行業研究時，常見做法是在招標網站裏手工篩公告、導出表格再透視。口徑容易隨頁面篩選變化，全量翻頁也費時。若希望 Agent 按固定維度（行業、地區、時間、項目與採購分類、金額區間）拉齊統計，並把「只查到總數」和「分頁樣本」說清楚，需要一套寫進 Skill 的流程與接口約定。下面介紹世舶科技在 SkillHub 分發的「招投標行業情報分析」能力，以及安裝、配置和典型分析路徑。
這是什麼¶
招投標行業情報分析【世舶科技】 是世舶科技旗下保標招標網提供的招投標數據分析 Skill：按行業、地區、時間、項目分類、採購分類、項目金額等維度，對招標公告、中標公告、合同公告、政府採購、工程建設項目和企業採購數據做統計分析，用於觀察市場規模、採購趨勢、區域分佈、行業熱度、客戶結構和金額變化。
出品方爲世舶科技；官方分發地址爲 https://api.skillhub.cn/sbkj-bid/sbkj-official-en。在 SkillHub 社區中，該 Skill 歸類爲 data-analysis，SkillHub 評分 7861，下載量 38572 次（以上指標來自 SkillHub 列表信息）。
Skill 的目標是用統一口徑統計指定行業的招投標數量、金額、地區、信息類型、採購類型和參與企業，形成可複覈的市場分析，並明確區分完整統計、分頁彙總和樣本分析。
核心功能¶
結合 Skill 說明，已覈實的能力包括：
- 多維篩選與統計：行業、地區、時間、項目分類、採購分類、項目金額等維度下的數量與結構分析。
- 數據類型覆蓋：招標公告、中標公告、合同公告，以及政府採購、工程建設項目、企業採購等相關數據視角。
- 行業編碼推理：用戶只提供行業名稱或產品關鍵詞時，先通過 AI 行業搜索將短語映射爲一級、二級、三級行業編碼，再選定口徑。
- 招中標統計與明細：支持先查總量（
pageNumber=0僅返回total），再分頁拉取明細做金額、企業排行與項目結構分析。 - 合同分析：在合同視角下分析合同週期、金額及甲乙方關係，支持按合同結束時間、甲乙方名稱等條件篩選。
- 指標與報告規範：項目數按
id + publishTime去重；金額合計僅彙總可解析的明確金額並報告缺失率；同比/環比要求區間長度一致；未拉全量明細時須標註樣本分析，避免寫成完整市場份額。
對外部 HTTP 接口（經保標網關）主要包括：
POST /outer-gateway/bid/industryReasoning：行業編碼推理。POST /outer-gateway/bid/searchProjectApi：招中標數量與明細。POST /outer-gateway/bid/searchProjectContactApi：合同數據搜索。
調用約定：UTF-8 JSON POST；標訊搜索單頁明細不超過 50 條，合同搜索單頁不超過 100 條；需要全量時按 hasNext 翻頁並記錄實際條數。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式，通過 SkillHub CLI 安裝到當前 Agent 的 skills 目錄（裝錯目錄會導致 Agent 無法加載）。
1、安裝 SkillHub CLI（未安裝時）¶
先檢查是否已有 CLI：
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
說明見：https://skillhub.cn/install/skillhub.md
2、安裝本 Skill¶
官方安裝提示爲：根據 https://skillhub.cn/install/skillhub.md 安裝包 @sbkj-bid/sbkj-official-en（與官方路徑 sbkj-bid/sbkj-official-en 一致）。
安裝時必須用 --dir 指向當前環境的 skills 目錄，例如：
skillhub install @sbkj-bid/sbkj-official-en --dir ~/.cursor/skills/
其他常見 Agent 的 skills 路徑（摘自 SkillHub 安裝文檔）：
- Claude Code：
~/.claude/skills/ - Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝後按所用 Client 的要求重啓或刷新 Agent，使 Skill 生效。
3、配置 API Key¶
本 Skill 需配置世舶科技（保標）API Key，按 Skill 約定讀取環境變量：
| 變量 | 作用 |
|---|---|
BBIAO_API_KEY |
API 密鑰 |
BBIAO_SERVER_URL |
網關地址；未配置時默認 https://gate.gov-bid.com |
未配置密鑰時不應繼續調用接口。密鑰獲取入口（Skill 原文）：https://apiyx.gov-bid.com/?share=eyJjb2RlIjoic2Jrai1qaG5tdDF0NyJ9
額度不足時，Skill 指向充值頁：https://console.api.gov-bid.com/bbiao-gateway/package
注意：不要在日誌、報錯或完整請求 URL 中暴露真實密鑰；優先使用平臺憑據庫或用戶級環境變量保存。
典型用法¶
下面步驟對應 Skill 內建議的執行流程，可在 Agent 對話中用自然語言描述分析需求，由 Skill 驅動接口調用。
1、明確分析口徑¶
先收集或確認：行業名稱/產品關鍵詞、地區、開始與結束日期、比較週期、信息分類、採購分類、金額區間、企業範圍及期望指標。不同口徑的結果不宜直接對比。
2、行業映射（僅給行業名時）¶
請求行業推理接口，例如關鍵詞「醫療器械」：
POST /outer-gateway/bid/industryReasoning
Content-Type: application/json
{"keyword": "醫療器械"}
從返回中讀取候選的 fullTitle、minTitle、firstCodeList、secondCodeList、thirdCodeList，並說明最終採用的編碼層級。
3、數量統計¶
對招中標數據使用 searchProjectApi，將 pageNumber 設爲 0 僅獲取 total；篩選字段包括 startDate、endDate、pageId、searchType，以及 industryCode、areaCode、keyword、projectClassID、purchaseTypeID、projectMoneyMin、projectMoneyMax 等。
4、明細與聚合¶
需要金額結構、企業排行或項目結構時，將 pageNumber 設爲 1–50 分頁抓取，去除 HTML 標籤，按 id + publishTime 去重，再按時間、地區、分類、金額區間、甲乙方聚合。
5、合同視角（可選）¶
調用 searchProjectContactApi，可使用 contractEndMin、contractEndMax、partAName、partBName、companyName 等字段，結合合同起止與項目週期做補充分析。
6、輸出報告¶
按 Skill 約定依次給出：分析口徑、數據覆蓋、核心結論、趨勢表、地區結構、分類結構、金額結構、甲乙方排行、代表項目與風險提示；樣本分析須寫明樣本量、頁數與數據截止時間。
更細的字段與枚舉見 Skill 包內 references/ 下的參數說明文檔（如 Parameter-Description.md、search-project-api.md 等），執行前由 Agent 按需讀取。
適用場景與注意¶
適合誰
- 行業研究、區域市場分析、招採趨勢與市場容量觀察。
- 客戶結構、採購需求洞察、競爭格局判斷及企業經營決策前的數據摸底。
- 銷售拓客、投標決策、渠道佈局、採購尋源與市場規劃前的結構化統計。
使用注意
- 商業數據與 Key：依賴保標招標網數據與 API 額度，需自行申請並配置
BBIAO_API_KEY。 - 分頁與樣本：未翻頁拉全量時，結論應標註爲樣本分析；市場份額類指標僅在分母範圍明確且明細完整時計算。
- 金額缺失：部分公告無明確金額，合計時需同時報告有金額項目數與缺失率。
- 官方地址訪問：瀏覽器直接打開
https://api.skillhub.cn/sbkj-bid/sbkj-official-en可能返回 HTTP 405，屬接口分發地址；安裝與更新請以 SkillHub 包名@sbkj-bid/sbkj-official-en及skillhub.cn/install/skillhub.md爲準。 - 前臺頁面狀態：SkillHub 技能詳情頁
sbkj-official-en若顯示「不存在或已下線」，以官方分發包與 CLI 安裝結果爲準，必要時聯繫世舶科技商務支持（Skill 文檔載明聯繫人張瑛，電話 18986107388）。
結尾¶
「招投標行業情報分析【世舶科技】」把招採數據的篩選維度、網關接口調用順序和統計口徑寫進 Agent Skill，減少手工導錶帶來的口徑漂移，並在分頁未全覆蓋時強制區分樣本與全量結論。安裝與目錄配置遵循 SkillHub 官方文檔；數據側需自備保標 API Key。官方分發地址：https://api.skillhub.cn/sbkj-bid/sbkj-official-en
