Bol Ai

io.github.peter-schout由 GitHub 帳號 peter-schout 發布v1.0.0更新於 Oct 28, 2026

Extract structured data from Bills of Lading: parties, ports, containers, incoterms. EU-hosted.

已驗證Streamable HTTP可網頁執行檔案與儲存資料與分析商業與電商

概覽

AI 產生的概覽

Bol.ai 從提單、發票、裝箱單等貨運文件擷取結構化資料,並可核對與匯出結果。

可以做什麼
  • 透過 URL 或 base64 從單一貨運文件(PDF、PNG、JPG)擷取結構化欄位,並自動辨識文件類型
  • 對最多 10 個文件 URL 批次擷取,並逐份回報處理結果
  • 列出近期文件,依 id 取得擷取結果,包含人工更正與驗證警告
  • 儲存更正後的欄位值,更正資料優先於原始擷取結果
  • 依共用參考編號關聯同一批貨物的其他文件,逐欄位比對各方、重量與件數
  • 將完成的擷取結果匯出為 TMS/ERP 可用的正規化列資料,並查詢剩餘額度與訂閱狀態
適用情境
適合物流、貨運承攬與貿易合規情境:讓助理讀取運輸文件、更正或核驗擷取欄位、交叉比對同一批貨物的多份文件,並把正規化資料交給 TMS 或 ERP。
執行需求
遠端 MCP 端點,位於 bol.ai,使用 streamable HTTP。需要 Bol.ai API 金鑰,以 bearer 形式放在 Authorization 標頭中;金鑰須在應用程式內建立,且帳號為 Professional 方案。文件須可透過 URL 存取或以 base64 內容提供,單份上限 10 MB。
安裝前請注意
Authorization 標頭中的 API 金鑰屬於機密,應避免出現在日誌或共用設定中。擷取會消耗預付額度,批次中每份文件分別計費,可能在處理途中額度用盡,建議先查詢用量。儲存更正與匯出會寫入帳號資料。貨運文件會傳送至第三方歐盟託管服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Bol Ai,將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.peter-schout%2Fbol-ai/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "bol-ai": {
      "type": "http",
      "url": "https://bol.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

工具

8

extract_bol

Extract freight document

Extract structured data from a freight document (PDF, PNG or JPG, max 10 MB): Bill of Lading, commercial invoice, packing list, or CMR road waybill. The document type is detected automatically and returned as `doc_type`. Provide either a fetchable `url` or `base64` file content. Fields not present in the document are null — never guessed. Each successful extraction bills one document.

輸入參數urlbase64filename

extract_batch

Extract multiple freight documents

Extract up to 10 freight documents in one call. Provide an array of fetchable URLs; each document is processed and billed independently, and the response reports a per-document outcome so partial success (e.g. running out of credits mid-batch) is explicit.

輸入參數urls必填

list_documents

List documents

List the 100 most recent documents for this account with id, filename, status (pending/done/failed), doc_type and primary reference number.

無需輸入參數。

get_document

Get extraction result

Get the extraction result for a document by id: doc_type, extracted fields, user corrections (when present), and deterministic verification warnings (ISO 6346 container check digits, plausibility flags). `fields` is the best available data (corrections win); `original_fields` and `corrected_fields` show both sides.

輸入參數id必填

save_corrections

Save field corrections

Save corrected field values for an extracted document. The original extraction is kept alongside the corrections; corrected data takes precedence in get_document, exports and reconciliation. Pass the complete corrected fields object (same shape as returned by get_document).

輸入參數id必填fields必填

export_documents

Export documents as normalized rows

Export completed extractions as TMS/ERP-ready normalized line rows (one row per container / invoice line / package / goods line), newest first. Optional doc_type filter and max_rows cap. Corrected data wins over the original extraction. For CSV/XLSX files use GET /api/bol/export on the REST API.

輸入參數typemax_rows

get_usage

Check credits and subscription

Check this account's remaining prepaid credits and subscription status. Call this before large batches to avoid running out of credits mid-workflow. When the account cannot bill more documents, a human can top up at the returned buy_credits_url.

無需輸入參數。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 83%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。