ScreenshotOne MCP Server

ScreenshotOne MCP 服务

这是 ScreenshotOne 的 MCP（Model Context Protocol） 服务官方实现。

进一步了解构建它的原因，以及对 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 Agent，建议使用切片。

成功捕获后，将以文本和结构化内容的形式返回请求的 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 最多可用 4 小时，而元数据内容会包含准确的过期时间。请下载需要保留的任何文件。

extract-website-markdown 仅接受 url。它是 ScreenshotOne format=markdown API 请求的专用快捷方式，会在一条 MCP 文本响应中直接返回生成的 Markdown。当 Agent 需要读取或分析页面内容、但不需要截图时，请使用此工具。

用法

构建

请务必先安装依赖并构建：

npm install && npm run build

获取 ScreenshotOne API 密钥

在 ScreenshotOne 注册并获取 API 密钥。

使用 npx 运行

无需克隆仓库，即可直接从 npm 软件包运行 CLI：

SCREENSHOTONE_API_KEY=your_api_key npx --yes @screenshotone/mcp

配合 Claude 桌面版使用

将以下内容添加到 ~/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 许可证 授权。