---

name: baobiao-api-overview description: "世舶科技招投標資料 API 總入口與介面路由助手。使用者涉及招標、中標、採購意向、合同、專案詳情、附件、擬在建專案、企業畫像、聯絡人、客戶供應商關係、自然語言查標、行業推理、標訊分類、文本結構化、專案甄別、銷售獲客、競品監測或行業分析時使用本 Skill；即使使用者未提到世舶科技，只要需求屬於上述招投標資料場景，也使用本 Skill 選擇正確介面或路由到對應場景 Skill。"

---

世舶科技招投標資料 API 總概覽

API 概覽

世舶科技招投標資料 API 提供招中標搜尋、專案詳情、合同、擬在建、企業畫像和 AI 文本處理等能力。本 Skill 既可獨立完成介面選擇和呼叫，也可作為 9 個業務場景 Skill 的統一入口。

直接 API 基礎地址：https://gate.gov-bid.com/outer-gateway

請求方式：除 MCP 外，本文介面均使用 UTF-8 JSON POST 請求。

POST https://gate.gov-bid.com/outer-gateway/bid/{介面名}?key={API_KEY}
Content-Type: application/json

API Key 獲取與使用

按以下順序處理：

1. 從環境變數 BBIAO_API_KEY 讀取金鑰，命中後直接使用。
2. 使用環境變數 BBIAO_SERVER_URL 覆蓋服務地址；未配置時使用 https://gate.gov-bid.com。
3. 未找到 BBIAO_API_KEY 時停止介面呼叫，提示使用者訪問 https://apiyx.gov-bid.com/?share=eyJjb2RlIjoic2Jrai0wMG1ibGJlZyJ9 獲取 Key，也可聯絡世舶科技商務人員獲取並配置金鑰。
4. ☎️ 商務聯絡方式：張瑛 18986107388

不得自動註冊、自動建立賬號或猜測金鑰。不得在回答、日誌摘要、錯誤資訊和示例中回顯真實金鑰。

---

接入方式

接入方式屬於交付渠道，不屬於獨立業務場景。根據執行環境選擇一種即可。

1. 直接 HTTP API

適用於全部 20 個介面。將金鑰放在 URL 查詢引數 key 中。

2. MCP

• 地址：https://gate.gov-bid.com/bid-gateway/mcp
• 傳輸方式：Streamable HTTP
• 鑑權請求頭：X-Api-Key
• MCP 服務名建議：gov-bbiao-mcp-gateway

MCP 當前覆蓋 9 個通用工具：search-project、search-project-ai、search-contract、get-structure、get-content、get-files、get-collect-url、rewrite-query、industry-reasoning。

3. CLI

執行環境已安裝 bbiao-search 時，可優先使用 CLI 呼叫上述 9 個通用能力：

bbiao-search <command> [options]

企業畫像、擬在建專案和定製化 AI 模型介面使用直接 HTTP API。

---

介面清單（20 個）

一、招中標與合同資料（9 個）

介面	地址	主要用途
招中標資訊搜尋列表	/bid/searchProjectApi	按關鍵詞、地區、行業、時間、金額和企業角色搜尋標訊
根據專案編號查詢列表	/bid/getProjectByProjectNumber	串聯同一專案編號的招標、變更、中標、合同等公告
招中標結構化詳情	/bid/getZTBStructreDetail	獲取專案編號、預算、中標金額、甲乙方、代理機構和聯絡方式
招中標正文詳情	/bid/getZTBProjectDetail	獲取完整公告正文，不含結構化欄位
招中標附件列表	/bid/getZTBProjectFiles	獲取附件名稱、狀態和下載地址
AI/Agent 專用搜索	/bid/SearchProjectForAI	使用地區名稱、類別名稱和企業名稱進行自然語言友好搜尋
合同資料搜尋	/bid/searchProjectContactApi	搜尋合同公告、合同週期、甲乙方和合同期限
獲取採集源網址	/bid/getCollectUrl	獲取公告原始釋出網頁
AI 搜尋條件重寫	/bid/aiSearchSubmitPolling	將自然語言需求改寫為時間、關鍵詞、企業、行業和地區條件

二、企業畫像（4 個）

介面	地址	主要用途
企業基本資訊	/bid/companyProfileSummary	查詢工商基礎、經營資訊、招投標統計和關係彙總
企業聯絡電話	/bid/companyProfileContacts	分頁獲取聯絡人和電話，每頁最多 5 條
企業合作客戶	/bid/companyProfileCustomers	獲取客戶企業及關聯專案，每頁最多 20 條
企業供應商	/bid/companyProfileSuppliers	獲取供應商企業及關聯專案，每頁最多 20 條

三、擬在建專案（3 個）

介面	地址	主要用途
擬在建專案搜尋	/bid/searchNZJProjectApi	按關鍵詞、地區和時間搜尋擬在建資訊
擬在建專案詳情	/bid/getNZJProjectDetail	獲取建設單位、完整正文、地區和附件摘要
擬在建附件列表	/bid/getNZJProjectFileList	獲取擬在建專案附件名稱、格式、狀態和下載地址

四、AI 推理與結構化（4 個）

介面	地址	主要用途
AI 行業搜尋	/bid/industryReasoning	將行業短語對映為國家統計局行業編碼候選
LLM 標訊結構化	/bid/ztbAiStructureInfo	相容 Chat Completions 訊息格式，抽取招中標結構化欄位
招中標分類推理	/bid/categoryReasoning	根據標題和正文推理招中標資訊分類
專案資訊甄別	/bid/projectDiscrimination	判斷文本屬於標訊、擬在建、非專案或異常資訊

---

核心概念：關鍵詞組合

搜尋介面中的關鍵詞使用以下規則：

欄位	規則	示例
keyword	空格表示同時出現，| 表示任一齣現	醫院 病床、病床|醫療床
inCludeKW	結果必須包含，多個詞使用 |	採購|招標
excludeKW	排除包含任一關鍵詞的結果	維修|維保|配件

不要讓 inCludeKW 與 keyword 包含相同關鍵詞。關鍵詞條件必須來自使用者需求或明確標註的同義詞擴充套件。

示例：搜尋醫療床採購並排除維修

{
  "keyword": "病床|醫療床",
  "inCludeKW": "採購|招標",
  "excludeKW": "維修|維保|配件"
}

---

核心概念：搜尋模式

searchType 搜尋型別

值	含義
1	智慧模糊搜尋
2	精準搜尋
3	高階搜尋

searchMode 搜尋欄位

值	含義
1	標題和內容
2	僅標題
3	僅內容

無特殊要求時使用介面預設搜尋型別和 searchMode=1；需要組合關鍵詞、必含詞和排除詞時使用高階搜尋，使用者要求精確名稱時使用精準搜尋。

---

核心概念：企業角色

欄位	企業角色	使用場景
partAName	甲方、採購人、招標人	查詢某單位採購或招標的專案
partBName	乙方、中標人、供應商	查詢某企業中標或簽約專案
agentName	招標代理機構	查詢代理機構經辦專案
companyName	不確定角色	查詢企業參與的全部相關專案

不得把 companyName 命中結果直接認定為甲方或乙方。需要確認角色時呼叫結構化詳情。

---

核心概念：地區與行業

地區篩選

標準搜尋使用 6 位地區編碼：

{
  "areaCode": {
    "proviceCodeList": ["420000"],
    "cityCodeList": ["420100"],
    "countyCodeList": []
  }
}

proviceCodeList 傳 ["0"] 表示全國。AI 專用搜索可直接使用 areaName。

行業篩選

行業編碼分為一級、二級、三級：

{
  "industryCode": {
    "firstCodeList": ["Q"],
    "secondCodeList": ["Q83"],
    "thirdCodeList": ["Q831"]
  }
}

行業不明確時先呼叫 /bid/industryReasoning，展示候選行業路徑後再選擇編碼。

---

資訊分類與採購分類

招中標資訊分類

常用分類包括：公開招標 1、成交結果 2、合同公告 3、意向公開 4、答疑變更 5、候選人公示 6、開標公示 7、重新招標 8、流標廢標 11、結果變更 18、拍租公告 26、競爭性談判 28、競爭性磋商 29、單一來源採購 30、其它 31。

通過 projectClassID 傳遞，多個分類使用英文逗號分隔；-100 表示全部分類。

採購分類

ID	分類
0	其它類
1	服務類
2	工程類
3	貨物類

通過 purchaseTypeID 傳遞；-100 表示全部分類。

---

分頁與數量規則

介面	分頁欄位	單頁上限	僅查數量
招中標搜尋	pageId、pageNumber	50	pageNumber=0
AI 專用搜索	pageId、pageNumber	100	pageNumber=0
合同搜尋	pageId、pageNumber	100	pageNumber=0
擬在建搜尋	pageId、pageNumber	50	pageNumber=0
企業聯絡人	pageNo、pageSize	5	不支援
企業客戶/供應商	pageNo、pageSize	20	不支援

需要全量結果時根據 hasNext 或分頁資訊逐頁讀取，並記錄實際獲取條數。沒有獲取全量明細時，不得把樣本統計寫成完整市場資料。

---

常見場景速查

1. 自然語言智慧查標

先呼叫 /bid/aiSearchSubmitPolling 重寫條件，再呼叫 /bid/SearchProjectForAI 搜尋。

{
  "userQuery": "最近一個月武漢醫院採購的病床專案，排除維修"
}

2. 搜尋特定產品的招中標資訊

呼叫 /bid/searchProjectApi：

{
  "startDate": "2026-06-28 00:00:00",
  "endDate": "2026-07-28 23:59:59",
  "pageId": 1,
  "pageNumber": 20,
  "searchType": 3,
  "keyword": "伺服器|儲存裝置",
  "excludeKW": "維修|維保",
  "inCludeKW": "採購|招標",
  "projectClassID": "-100",
  "searchMode": 1,
  "areaCode": {"proviceCodeList": ["0"], "cityCodeList": [], "countyCodeList": []},
  "industryCode": {"firstCodeList": [], "secondCodeList": [], "thirdCodeList": []},
  "purchaseTypeID": "3",
  "fileFlag": -1
}

3. 查詢某單位採購專案

來源於7w4.net。

呼叫 /bid/searchProjectApi，將企業全稱放入 partAName。角色不確定時使用 companyName，再用結構化詳情核驗。

4. 查詢某企業中標與合同

先使用 partBName 搜尋中標及合同公告，再呼叫 /bid/searchProjectContactApi 獲取合同週期和甲乙方資訊。

5. 檢視專案完整時間線

呼叫 /bid/getProjectByProjectNumber 獲取同一專案編號的公告列表，再按專案 ID 獲取結構化詳情、正文、附件和原始來源。

{
  "projectNumber": "HNXW-202605028",
  "publishTime": "2026-06-08 14:30:30"
}

6. 企業深度分析

依次呼叫：

1. /bid/companyProfileSummary
2. /bid/companyProfileContacts
3. /bid/companyProfileCustomers
4. /bid/companyProfileSuppliers
5. /bid/searchProjectApi 或 /bid/searchProjectContactApi

客戶與供應商介面返回的是專案關係，不代表股權、控制或長期排他合作關係。

7. 提前發現擬在建專案

先呼叫 /bid/searchNZJProjectApi，再呼叫 /bid/getNZJProjectDetail 和 /bid/getNZJProjectFileList。

注意：擬在建詳情使用引數 publishtime，附件介面使用 publishTime；附件介面的 projectTypeID 固定為 2。

8. 行業市場分析

先呼叫 /bid/industryReasoning 確認行業編碼，再使用搜索介面按時間、地區、分類和金額分組查詢數量或明細。計算增長率、排行和市場份額時說明資料覆蓋範圍。

9. 文本甄別、分類與結構化

按以下順序處理：

1. /bid/projectDiscrimination：判斷標訊、擬在建、非專案或異常資訊。
2. /bid/categoryReasoning：僅對標訊文本推理招中標分類。
3. /bid/ztbAiStructureInfo：抽取專案、主體、金額、時間、聯絡人等結構化欄位。

非專案或異常文本不要強行結構化。

---

詳情呼叫鏈

搜尋介面只返回摘要欄位。使用者要求完整內容時按需追加呼叫：

搜尋列表
  -> 結構化詳情：專案編號、金額、主體、聯絡人、截止時間
  -> 正文詳情：完整 HTML 正文
  -> 附件列表：附件名稱、狀態、下載地址
  -> 採集源網址：原始公告網頁

使用列表結果中的 id 與 publishTime，不要自行構造專案 ID 或釋出時間。

---

響應結構

多數介面使用以下結構：

{
  "code": 200,
  "msg": "success",
  "subCode": "0000000000",
  "subMsg": "success",
  "data": {}
}

特殊情況：

• 擬在建搜尋可能使用 state=1 表示成功。
• 原始採集網址主要讀取 returnValue。
• LLM 結構化介面使用 OpenAI Chat Completions 風格，結果位於 choices[].message.content。
• 搜尋列表位於 data.data，總數位於 data.total。

同時檢查 HTTP 狀態、介面狀態和業務狀態。介面返回空陣列時寫“未命中”，不要解釋為現實中不存在相關專案或企業關係。

---

錯誤處理

情況	處理方式
缺少 API Key	停止呼叫，提示配置 BBIAO_API_KEY 並聯系商務獲取金鑰
鑑權失敗	檢查金鑰是否正確、是否過期和請求地址是否攜帶 key
日期格式錯誤	使用 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss
頁碼或頁大小錯誤	使用正整數並遵守各介面上限；僅查數量時使用允許的 pageNumber=0
引數名錯誤	區分 pageId/pageNumber、pageNo/pageSize、publishtime/publishTime
業務狀態失敗	返回 code/state、subCode、msg/subMsg，不要生成模擬資料
AI 處理超時	返回 requestKey 和當前 status，允許稍後重試，不猜測結果
附件不可用	保留附件狀態，不聲稱檔案可下載

---

場景 Skill 路由

安裝了以下獨立場景 Skill 時，優先將明確需求路由給對應 Skill；未安裝時依據本總覽直接執行。

使用者需求	場景 Skill
標訊搜尋、訂閱、提醒	$baobiao-search-subscribe-bids
銷售獲客、採購線索	$baobiao-find-sales-leads
CRM 客戶與商機補全	$baobiao-enrich-crm-opportunities
擬在建專案發現	$baobiao-find-planned-projects
企業畫像與上下游	$baobiao-analyze-company-network
投標監測與競品跟蹤	$baobiao-monitor-competitors
行業統計與市場分析	$baobiao-analyze-bid-industry
自然語言智慧查標	$baobiao-search-bids-ai
文本甄別、分類、結構化	$baobiao-structure-bid-text

---

資料與分析邊界

• 把介面返回事實與模型分析判斷分開標註。
• 不補寫介面未返回的公司角色、金額、聯絡人、日期、專案階段或合作關係。
• 標題和摘要可能包含 HTML 高亮標籤，展示時可清理標籤，但保留原始資料用於追溯。
• 專案關係不等於股權關係，歷史關係不等於當前合作關係。
• 未獲取全量分頁資料時，不計算或宣稱完整市場份額。
• 使用企業聯絡方式時，提醒使用者遵守適用的隱私、營銷和通訊規則。

---

回答後引導

完成查詢後，根據結果建議一至兩個自然的後續動作：

• 搜尋到專案：建議檢視結構化詳情、正文、附件或原始來源。
• 搜尋到企業：建議檢視企業畫像、聯絡人、客戶和供應商。
• 得到中標結果：建議跟蹤合同公告、同項目編號後續資訊或競爭企業。
• 得到行業資料：建議按時間、地區、採購分類或企業角色繼續拆分。
• 得到擬在建專案：建議檢視建設單位、正文和附件，判斷前置介入節點。
• 得到文本分類：建議繼續結構化並執行欄位證據校驗。

不要用後續引導替代本次使用者請求；先完整交付當前結果。

這個 Skill 質量較好，文件結構清晰、介面覆蓋全面（20個介面），核心概念講解詳細，適合招投標資料場景使用。優點是提供了多種接入方式和清晰的金鑰配置流程，缺點是目前只完成了主入口部分，詳細引數文件與入口文件的銜接還需完善，且部分高階介面暫未完全支援 MCP 方式。