ScreenshotOne

官方

使用 ScreenshotOne 渲染網站截圖

GitHub

試用此 MCP贊助

你可以用 ScreenshotOne MCP 做什麼？

渲染網站截圖 — 透過 render-website-screenshot 請求任何 URL 的截圖，並可設定 full_page、block_ads 和 image_quality 等選項。
將頁面內容擷取為 Markdown — 使用 extract-website-markdown 取得任何網頁經清理、易讀的 Markdown 版本，以便進行分析。
取得整頁切片 — 請求 full_page=true 和 full_page_slices=true，以接收較小的垂直圖片 URL，用於分析長頁面。
檢查 API 使用配額 — 呼叫 get-usage 查看目前 ScreenshotOne API 配額與並發使用情況。

文件

ScreenshotOne MCP 伺服器

這是 MCP（模型上下文協定）伺服器之於 ScreenshotOne 的官方實作。

關於為何建置它的一些說明，以及對 MCP 未來的一些想法。

ScreenshotOne 也提供官方代管的 MCP 伺服器。請參閱 ScreenshotOne MCP 整合以取得設定說明與最新更新。

工具

render-website-screenshot：渲染網站截圖，並依要求回傳暫時的截圖、內容與切片 URL。
extract-website-markdown：渲染網站並直接以文字形式回傳清理後的 Markdown。
get-usage：取得 ScreenshotOne API 配額與並發使用量。

截圖工具提供以下重點選項：

url
block_banners（預設為 true）
block_ads（預設為 true）
image_quality（預設為 80）
full_page（預設為 false）
full_page_slices（預設為 false；需要 full_page=true）
metadata_content（預設為 false）
metadata_content_format（html 或 markdown；需要 metadata_content=true）

元資料內容與全頁切片的選項名稱和值與 ScreenshotOne API 相符。此工具不開放回應類型或快取控制；它一律要求 JSON 回應並停用 API 快取。

設定 metadata_content=true 與 metadata_content_format=markdown 以隨截圖接收暫時的 Markdown 內容 URL。設定 full_page=true 與 full_page_slices=true 以接收較小的垂直截圖 URL。當 AI 代理需要分析可能無法可靠地以單一大圖處理的長頁面時，切片是較佳的選擇。

成功擷取會以文字與結構化內容回傳要求的 URL：

{
    "url": "https://<screenshotone-cache-domain>/...",
    "content": {
        "url": "https://<screenshotone-cache-domain>/...",
        "expires": "Sun, 07 Sep 2026 12:00:00 GMT",
        "format": "markdown"
    },
    "slices": [
        {
            "index": 0,
            "offset_y": 0,
            "width": 1280,
            "height": 4000,
            "url": "https://<screenshotone-cache-domain>/..."
        }
    ]
}

這些 URL 是暫時的。截圖 URL 最多可使用四小時，而元資料內容則包含其確切的到期時間。請下載任何你需要保留的成品。

extract-website-markdown 僅接受 url。它是 ScreenshotOne 的 format=markdown API 請求的聚焦捷徑，並直接在單一 MCP 文字回應中回傳產生的 Markdown。當代理需要閱讀或分析頁面內容而不需要截圖時，請使用它。

使用方式

建置

請務必先安裝相依套件並進行建置：

npm install && npm run build

取得你的 ScreenshotOne API 金鑰

在 ScreenshotOne 註冊並取得你的 API 金鑰。

使用 npx 執行

直接從 npm 套件執行 CLI，無需複製儲存庫：

SCREENSHOTONE_API_KEY=your_api_key npx --yes @screenshotone/mcp

搭配 Claude for Desktop

將以下內容加入你的 ~/Library/Application\ Support/Claude/claude_desktop_config.json：

{
    "mcpServers": {
        "screenshotone": {
            "command": "npx",
            "args": ["--yes", "@screenshotone/mcp"],
            "env": {
                "SCREENSHOTONE_API_KEY": "<your api key>"
            }
        }
    }
}

獨立執行或用於其他專案

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

授權

ScreenshotOne MCP Server 依 MIT 授權授權。