Screenshot Scout

Screenshot Scout MCP 服务

通过 MCP 客户端使用 Screenshot Scout 将 HTTP 或 HTTPS 网页截取为图片或 PDF。

此服务提供一个工具：capture_screenshot。它支持整页和元素截图、设备和视口控制、位置选择、页面交互和屏蔽选项、图片尺寸和质量、PDF 布局、缓存、临时结果 URL，以及符合条件的 MCP 图片内容。

所需条件

• 一个 Screenshot Scout 账户，以及从 API keys 页面获取的访问密钥。
• 使用 npm/stdio 安装需要 Node.js 22 或更高版本。Claude Desktop 的 MCPB 运行时由 Claude 捆绑提供。
• 仅当所选 API 密钥要求对 Screenshot Scout 请求进行签名时，才需要可选的密钥。

每次截图都会使用你的 Screenshot Scout 账户，并受其套餐、配额和速率限制约束。

使用 npm 运行本地 stdio

先使用以下本地 stdio 配置：

{
  "mcpServers": {
    "screenshotscout": {
      "command": "npx",
      "args": ["-y", "@screenshotscout/mcp"],
      "env": {
        "SCREENSHOTSCOUT_ACCESS_KEY": "YOUR_ACCESS_KEY"
      }
    }
  }
}

如果访问密钥要求对请求进行签名，请在本地添加密钥：

"SCREENSHOTSCOUT_SECRET_KEY": "YOUR_SECRET_KEY"

请勿将个人配置文件纳入源代码管理。凭据是进程环境值，而非工具参数。请参阅 各客户端的复制粘贴配置，了解 Claude Desktop、Claude Code、Cursor、VS Code/GitHub Copilot、Devin 和 Cline 的配置。

从源代码检出目录运行

npm ci
npm run build

使用 node 指向 dist/stdio.js 的绝对路径，并提供上述相同的环境变量。

Claude Desktop MCPB

安装 Claude Desktop 扩展：

1. 从对应版本的 GitHub 发布页面下载 screenshotscout-mcp-<version>.mcpb。
2. 在 Claude Desktop 中，打开 设置 → 扩展 → 高级设置，然后选择 安装扩展…。
3. 选择下载的文件。
4. 输入所需的访问密钥。仅当 API 密钥要求对请求进行签名时，才输入密钥。

Claude Desktop 会将两个字段都视为敏感设置。v0.2.0 MCPB 支持 Windows。

托管的 Streamable HTTP

托管的 API 密钥端点现已上线：

https://mcp.screenshotscout.com/mcp/api-key

该端点仅适用于能够附加静态 HTTP 标头的客户端：

Authorization: Bearer YOUR_ACCESS_KEY

该端点仅接受访问密钥。切勿向其发送 Screenshot Scout 密钥，也切勿将任一密钥放入 URL 或工具参数中。无法附加静态 Bearer 标头的客户端不能使用此端点。

要求请求签名的 API 密钥必须改用本地 stdio 或 MCPB，或者为托管端点使用专用的无签名访问密钥。

使用 Docker 运行本地 stdio

从源代码检出目录构建生产镜像：

docker build --tag screenshotscout-mcp:local .

从本地环境传递凭据，并保持 stdin 连接以处理 MCP stdio 流量：

docker run --rm -i --init --cap-drop=ALL --security-opt=no-new-privileges --read-only \
  -e SCREENSHOTSCOUT_ACCESS_KEY \
  -e SCREENSHOTSCOUT_SECRET_KEY \
  screenshotscout-mcp:local

SCREENSHOTSCOUT_SECRET_KEY 仍为可选项。该镜像以非特权用户身份运行，仅包含编译后的 stdio 服务及其生产依赖项。它不声明端口或容器运行状况检查：MCP 客户端负责管理 stdio 进程，并通过完成 MCP 初始化来验证其是否就绪。镜像及其位于 docker-mcp-catalog.yaml 中的 Docker MCP Catalog 元数据只是本地准备工作；这些命令并不意味着存在公开镜像。

工具：capture_screenshot

capture_screenshot 会针对所提供的 URL 和选项发送一次截图请求。目标网页位于外部，其返回内容必须视为不可信内容。

输入

只需提供 url。默认使用 1280×720 的视口进行捕获。未指定格式时，工具会返回质量为 60 的 JPEG。resultMode 默认为 "auto"。

分组	输入
目标和输出	url；format（png、jpg、jpeg、webp、gif、tiff、pdf）；resultMode（auto、url_only）
位置和视口	country（两位国家代码）、device、deviceViewportWidth、deviceViewportHeight、colorScheme（auto、dark、light）、fullPage
页面准备	blockCookieBanners、blockAds、blockChatWidgets、selector、hideSelectors、clickSelectors
计时	waitUntil（load、domcontentloaded、networkidle0、networkidle2）、delay（0–30 秒）、navigationTimeout（5–90 秒）、timeout（1–240 秒）
缓存	cache、cacheTtl（14,400–2,592,000 秒）
输出尺寸调整	imageWidth、imageHeight（1–8,192；仅适用于图像）
仅适用于图像	imageQuality（0–100；仅适用于 JPEG/WebP）
仅适用于 PDF	pdfPaperFormat（letter、legal、tabloid、a3、a4、a5、a6）、pdfLandscape、pdfPrintBackground、pdfMargin、各边距字段、pdfScale（0.1–2）、pdfPageRanges（例如 1-3,5）

同时提供两个输出尺寸时，它们的乘积不能超过 64,000,000 像素。PDF 边距可使用 px、in、mm 或 cm 单位，且值必须为非负数。其他格式的输入会被忽略：imageQuality 仅适用于 JPEG 和 WebP；PDF 输入仅适用于 format: "pdf"。PDF 始终包含整个页面，因此 fullPage、selector、imageWidth 和 imageHeight 对 PDF 均无效。

结果

• 当 resultMode 为 auto 时，PNG、JPEG、WebP 和 GIF 只有在 MIME 类型符合条件、尺寸已知且每边不超过 8,000 像素、原始数据不超过 5 MiB，且完整序列化结果符合当前 128,000 字节的服务端限制时，才可能作为 MCP 图像内容返回。
• 不符合内嵌条件的捕获仍会成功，并返回其临时 URL 以及可供采取行动的省略原因。
• TIFF 仅以 URL 形式返回。
• PDF 字节数据不会内嵌。PDF 结果包含安全文本和结构化元数据；如果 Screenshot Scout 提供了结果 URL，还会包含资源链接。
• 对于所有格式，resultMode: "url_only" 都会省略图像字节数据。

MCP 客户端会控制是否显示返回的图像内容或资源链接，或是否将其提供给模型。

结构化元数据可包含 screenshotUrl、screenshotUrlExpiresAt、cacheStatus、format、mimeType、imageWidth、imageHeight、inlineImageIncluded 和 inlineImageOmissionReason。

请将结果 URL 视为敏感的临时链接，并遵守其报告的过期时间。

示例提示词

• “在深色模式下，将 https://example.com 捕获为完整页面 PNG。仅返回 URL。”
• “对 https://example.com/pricing 截取 1280×720 的 JPEG，屏蔽 Cookie 横幅和广告，并将质量设为 80。”
• “为 https://example.com/report 创建 A4 PDF，启用背景，边距设为 10 mm。”

隐私与安全

服务器会将目标 URL 和所选捕获选项发送给 Screenshot Scout，由其加载目标网站。捕获私人或受监管材料前，请查看 Screenshot Scout 隐私政策。

• 请勿捕获未经授权访问的页面。
• 请勿在提示词、工具输入、URL、问题报告或日志中粘贴凭据。
• 请将本地访问权限和密钥保存在由客户端管理的密钥存储空间或私有环境配置中。
• 本地 stdio 服务不会添加遥测数据。托管服务的应用程序日志仅限于请求方法、响应状态、持续时间和经过净化的意外错误。该服务的设计不会记录凭据、目标 URL、截图 URL、请求或响应内容，也不会记录图像字节。
• 允许使用工具前，请检查每个目标和捕获请求。该工具可访问开放网络，会消耗配额并与外部网站交互。
• 请按照 SECURITY.md 中的说明私下报告漏洞。

开发

npm ci
npm run format:check
npm run lint
npm run typecheck
npm test
npm run metadata:check
npm run registry:validate
npm run mcpb:validate
npm run mcpb:pack

许可证

MIT © Oleksii Velykyi