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 伺服器
為您的 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_DIR | save_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 或更新版本。
範例提示
- 擷取 https://example.com 的截圖,不含廣告或 Cookie 橫幅。
- 將 https://urlbox.com 儲存為帶有目錄的標記 PDF,並下載到我的電腦。
- 將這篇文章轉換為 Markdown:https://example.com/blog/post
- https://example.com 在手機上看起來如何?
開發
npm install
npm test
測試會針對本機假伺服器執行橋接器,因此無需 Urlbox 帳戶。
授權
MIT
