Site-Shot MCP server

让 Claude、Cursor 和其他 AI 代理能够看到任意网页 —— 通过 Model Context Protocol 使用 Site-Shot 截取网站截图。

真实的 Chromium 渲染 · 整页截取 · 国家代理 · 自动移除广告和 Cookie 横幅（图像更干净、视觉令牌更少）。

快速开始（Claude Desktop）

1. 在 https://www.site-shot.com/start/ 获取 Site-Shot API 密钥。

2. 将其添加到 Claude Desktop 配置（claude_desktop_config.json）中：

{
  "mcpServers": {
    "site-shot": {
      "command": "npx",
      "args": ["-y", "site-shot-mcp"],
      "env": { "SITESHOT_API_KEY": "YOUR_API_KEY" }
    }
  }
}

3. 重启 Claude Desktop。让它 “对 https://news.ycombinator.com 截取整页截图”，它就会调用服务器并把图像展示给你。

在任何 MCP 客户端（Cursor、Cline、VS Code、LangChain、CrewAI）中的用法都一样 —— 只需要让客户端在环境中携带 SITESHOT_API_KEY 指向 npx -y site-shot-mcp 即可。

Related MCP server: ScreenshotOne MCP Server

工具

capture_screenshot

截取一个网页的截图（默认按视口截取）。

以 MCP 图像形式返回截图。

“API 默认值”并不是这个包能够声明的某个数值。 width、height 和 wait_ms 只会在你传入时才被转发，因此当你不传参数时实际生效的值由 Site-Shot API 决定，并且可能在本包没有任何发版变动的情况下发生变化。1.1.0 及更早版本为 width / height 打印了 API 并不使用的像素尺寸 —— 省略这些参数去“采用默认值”的代理会得到 不同的视口，而返回的图像中没有任何信息能揭示这一点。只要尺寸很重要，就请传入显式值。

国家代码是 ISO 代码，绝不是名称。 请传 "DE"，而不是 "Germany"。API 会精确匹配代码， 否则就会在不告知你的情况下通过美国代理渲染。因此，服务器会在消耗一次渲染之前拒绝完整名称。strict_country （默认开启）同样会把不可用的国家变成错误，而不是静默地截出一张美国截图 —— 传 false 即可重新启用回退。 支持的国家 →

capture_full_page

与 capture_screenshot 相同，但已启用了整页截取。

为什么要调用这个服务器，而不是用代理自带的浏览器？

如果你的代理驱动浏览器，它完全可以自己截取页面 —— 对于那些需要登录或需要逐步走完整流程的页面，那才是正确的工具。对于公开 URL，把截取工作委托给这个服务器通常是更好的工程实践：每次截取都运行相同的流水线（多次运行之间无需重新规划），可以从特定国家 / 地区截取并匹配相应的语言环境、时区（country + strict_country），返回前还会由图像分类器评分，并带有逐级升级的重试机制作为后盾，而且每次查看的成本只是一美分的一小部分，而不是一个浏览器会话加视觉令牌。完整的两侧对比、两种方向都如实说明： AI 代理 vs. 截图 API —— 谁应当截取页面。

配置

该服务器是现有 Site-Shot HTTP API（https://api.site-shot.com/）的薄封装 —— 没有独立的后端。

本地开发

npm install
npm run check   # syntax check
npm run smoke   # offline tests (stubbed fetch, no API key needed)
SITESHOT_API_KEY=yourkey npm start   # run the server on stdio

环境要求

Node.js ≥ 18（使用内置的 fetch）。

许可证

MIT