Live Web Data by Teneo Protocol

官方

遠端 MCP 伺服器與 API，可依您選擇的國家，即時擷取任何公開網頁，呈現當地訪客所見的內容，並轉換為乾淨的 Markdown。為 AI 代理提供網頁資料擷取、抓取與爬取服務，結果依所在地呈現，並按請求計價。livewebdata.com 是 Live Web Data API，由 Teneo Protocol 推出。

造訪 livewebdata.com

你可以用 Live Web Data By Teneo Protocol MCP 做什麼？

擷取即時網頁內容 — 請助理讀取任何公開網址，並以乾淨的 Markdown、純文字或 HTML 格式傳回主要內容。
選擇瀏覽國家 — 指定要從特定國家查看網頁，例如 de、gb 或 us，使用 ISO-3166 alpha-2 代碼。
控制輸出大小與範圍 — 將 max_characters 設為 500 至 100,000，並選擇精簡的主要內容或完整網頁本文。
查看帳戶狀態 — 執行大量批次前，請助理確認剩餘點數、方案和速率限制；此呼叫免費。
處理擷取錯誤 — 取得針對受限網站、找不到頁面、逾時、速率限制和點數不足等情況的可行錯誤訊息。

託管 MCP 伺服器

npx add-mcp 'https://livewebdata.com/mcp'

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

在 Claude、Cursor、VS Code 和任何其他 MCP 用戶端中，將 Live Web Data API 作為工具使用——只需一個 URL 和您現有的 API 金鑰。

什麼是 MCP

Model Context Protocol (MCP) 是一種開放標準，可讓 AI 代理探索並呼叫外部工具。我們的 MCP 伺服器將 Contents API 提供為兩種工具，讓代理能自行讀取任何公開網頁。

伺服器與驗證

	值
伺服器 URL	`https://livewebdata.com/mcp`
傳輸方式	Streamable HTTP（無狀態）：透過 `POST` 傳送 JSON-RPC；`GET` 和 `DELETE` 會回應 `405`
驗證	`Authorization: Bearer <api_key>`
金鑰	與 REST API 使用相同的金鑰——在 API keys 下建立一組

缺少或無效的金鑰會收到 HTTP 401 拒絕（帳戶遭停用時為 403，"API access for this account is suspended. Contact support."），且不會執行任何工具。

用戶端設定

將 YOUR_KEY 替換為您的 API 金鑰。在儀表板的 Integrations 頁面中，系統會自動填入您的金鑰。

在終端機中執行此命令。之後，這個專案的每個 Claude Code 工作階段都能使用此伺服器。

claude mcp add --transport http live-web-data https://livewebdata.com/mcp \
  --header "Authorization: Bearer YOUR_KEY"

新增 --scope user，即可在所有專案中使用。使用 claude mcp list 檢查。

get_page_contents

即時擷取公開網頁，並以乾淨的 Markdown、純文字或 HTML 傳回主要內容。唯讀、冪等。每次呼叫僅處理一個 URL。

參數	類型	預設值	說明
`url`	字串（http/https，最多 8,192 個字元）	必填	要擷取的公開 URL。
`country`	ISO-3166 alpha-2	`"us"`	以此國家/地區的視角擷取網頁，例如 'de'、'gb'、'us'。
`format`	`"markdown"` \| `"text"` \| `"html"`	`"markdown"`	輸出格式。建議使用 markdown。只有在 `"html"` 時才會擷取並傳回網頁 HTML。
`max_characters`	整數 500–100000	`8000`	傳回內容的字元數上限。由於結果會放入代理的上下文中，因此上限低於 REST API 的預設值（`text.maxCharacters`，100,000）；若內容遭截斷，請調高此值。
`verbosity`	`"compact"` \| `"full"`	`"compact"`	compact = 僅主要內容，full = 整個頁面本文。

結果會以一個文字項目傳回，先附上簡短標頭，再接續內容。完整的 REST 格式 JSON 也會以 structuredContent 傳回（只有在 format: "html" 時才包含 results[].html）。

# Web scraping - Wikipedia
Source: https://en.wikipedia.org/wiki/Web_scraping · country: us · live · credits used: 1 · credits left: 8,411

# Web scraping - Wikipedia

…

get_account_status

檢查連線帳戶的剩餘點數、方案和速率限制。代理應在大量批次作業前呼叫此工具。無參數，免費。傳回與 GET /v1/account 相同的數值。

Plan: Starter · Credits left: 8,412 · Rate limit: 2 URL/s (burst 4) · Status: active

錯誤

錯誤會以 isError: true 傳回，並附上一句代理可採取行動的說明。未扣除點數時，訊息會以「未扣除任何點數。」結尾。

情況	提供給代理的訊息
451 受限目標	此網站受到限制，無法擷取。請勿重試；改用其他來源。
`CRAWL_NOT_RENDERED`	此頁面沒有可用文字：需要 JavaScript 渲染，或即使完成渲染也沒有顯示文字。請嘗試其他來源，或改用提供相同資訊的其他 URL。
`CRAWL_NOT_FOUND`	找不到頁面（404/410）。
`SOURCE_NOT_AVAILABLE`	網站拒絕了此請求。請改用其他來源。
`SOURCE_BLOCKED`	網站拒絕存取。請改用其他來源。
`CRAWL_LIVECRAWL_TIMEOUT`	頁面逾時。請使用較長的逾時時間重試一次，否則改用其他來源。
`BROWSER_UNAVAILABLE`	瀏覽器渲染暫時無法使用。請在幾分鐘後重試，否則改用其他來源。
`RATE_LIMITED`	已達到使用者方案的渲染上限。請勿立即重試渲染；改用其他來源。
402 點數不足	帳戶點數已用完。請告知使用者前往 …/dashboard/billing 儲值。
429 請求過於頻繁	已達到速率限制。請等待 N 秒後再重試。
401 / 403	API 金鑰無效或已停用。請告知使用者前往 …/dashboard/keys 檢查金鑰。
仍在擷取（超過 5 分鐘）	頁面在 5 分鐘內仍未載入完成，且此次擷取仍可能會收費。請改用其他來源。

點數

MCP 呼叫的計費方式與 REST 呼叫完全相同：每個成功擷取的頁面扣 1 點；失敗的請求（包括遭網站拒絕存取）免費。這些呼叫會在 Usage 中以 mcp 顯示。請參閱 Credits。