Urlbox Full Page Screenshots

官方

一個用於 Urlbox 螢幕截圖 API 的 MCP 伺服器。它讓您的客戶端能夠從網站擷取螢幕截圖、生成 PDF、提取 HTML/Markdown 等。

你可以用 Urlbox Full Page Screenshots MCP 做什麼?

  • 擷取全頁截圖 — 要求任何 URL 的截圖,並可選擇封鎖廣告或 Cookie 橫幅。
  • 產生 PDF 與影片 — 要求帶有大綱的標記 PDF,或頁面的影片渲染,並透過 save_render 儲存至本機。
  • 擷取頁面內容 — 將任何文章或網頁轉換為乾淨的 Markdown、HTML 或純文章文字。
  • 比較頁面版本 — 要求對兩個 URL 進行視覺差異比對,或捕捉網站在手機檢視模式下的外觀。
  • 管理 Urlbox 資源 — 使用組織金鑰,可建立或更新專案、檢查 Webhook,並檢視帳戶使用量。

文件

Urlbox 截圖 MCP 伺服器

image

為您的 AI 助手提供真實瀏覽器來擷取網站截圖。Urlbox MCP 伺服器可擷取截圖、製作 PDF 和影片、提取 HTML、Markdown 和文章文字、比較頁面,並管理您的 Urlbox 專案、Webhook 和使用量。

使用託管伺服器(建議)

將您的客戶端連線至 https://api.urlbox.com/mcp。無需安裝任何東西。

  • Claude(claude.ai 和桌面版):設定、連接器、新增自訂連接器,輸入 https://api.urlbox.com/mcp,然後登入 Urlbox。

  • ChatGPT:使用 URL https://api.urlbox.com/mcp 新增連接器,然後登入 Urlbox。

  • Claude Code:claude mcp add --transport http urlbox https://api.urlbox.com/mcp,然後執行 /mcp 登入。

  • Codex:codex mcp add urlbox --url https://api.urlbox.com/mcp,然後 codex mcp login urlbox 登入。

  • Cursor:將此新增至 ~/.cursor/mcp.json:

    {
      "mcpServers": {
        "urlbox": {
          "url": "https://api.urlbox.com/mcp",
          "headers": { "Authorization": "Bearer YOUR_URLBOX_API_KEY" }
        }
      }
    }
    

無法登入的客戶端可以將 API 金鑰作為 Authorization: Bearer <key> 傳送。組織 API 金鑰(ubx_org_...)可解鎖所有工具。專案密鑰僅適用於渲染工具。您可以在 Urlbox 儀表板 找到您的金鑰。

本機橋接器(此套件)

某些客戶端只能啟動本機伺服器。此套件是一個小型本機橋接器:它在您的機器上透過 stdio 執行,並將所有內容轉發至託管伺服器,因此您能獲得完全相同的工具,且始終保持最新狀態。

{
  "mcpServers": {
    "urlbox": {
      "command": "npx",
      "args": ["-y", "@urlbox/screenshot-mcp"],
      "env": {
        "URLBOX_API_KEY": "your_api_key_here"
      }
    }
  }
}

需要 Node.js 20 或更新版本。

變數說明
URLBOX_API_KEY您的組織 API 金鑰或專案密鑰。
SECRET_KEY也接受,適用於為 1.x 編寫的設定。若兩者皆設定,URLBOX_API_KEY 優先。
URLBOX_DOWNLOAD_DIRsave_render 儲存檔案的位置。預設為 ~/Downloads。

橋接器新增一個本機工具 save_render,它會下載任何 Urlbox 工具回傳的渲染 URL 並儲存到您的電腦。只需說「截取 example.com 的截圖並儲存到我的電腦」即可。現有檔案絕不會被覆寫。

從 1.x 升級

您現有的設定仍可運作:SECRET_KEY 仍會被讀取,套件名稱和指令保持不變。

  • 工具現在來自託管伺服器,因此數量更多,且無需更新即可持續改進。
  • render 仍然存在。其 store_renders 選項和 download 工具已由 save_render 取代。
  • 檔案現在儲存至 ~/Downloads,而非 ~/Downloads/urlbox-renders。設定 URLBOX_DOWNLOAD_DIR 以保留舊位置。
  • 使用專案密鑰可獲得渲染工具。使用組織 API 金鑰可同時管理專案、Webhook 和使用量。
  • 需要 Node.js 20 或更新版本。

範例提示

開發

npm install
npm test

測試會針對本機假伺服器執行橋接器,因此無需 Urlbox 帳戶。

授權

MIT