SuperAPI AI 工具集

snapshot-site-mcp

Snapshot Site MCP 是 Snapshot Site API 的官方 MCP 服务器,用于让 Claude、ChatGPT 等 MCP 客户端对任意网页执行截图捕获、页面版本视觉对比以及 AI 页面摘要分析。它支持两种连接方式:托管模式(通过 OAuth 登录,无需运行本地进程或配置 API 密钥)与本地模式(通过 stdio 运行并传入 SNAPSHOT_SITE_API_KEY)。工具可输出 PNG、JPEG、WebP、PDF 或 HTML 格式,并针对 MCP 客户端做了工具标注,包含更丰富的标题、分类元数据和示例意图,以提升在 Claude Desktop 和 Cursor 中的工具选择效果。两种连接方式产生的调用均计入与直接 API 调用相同的套餐配额。

访问官网

工具介绍

用途 Snapshot Site MCP 是 Snapshot Site API 的官方 MCP 服务器,旨在让 Claude、ChatGPT 以及其他 MCP 客户端能够捕获、比较和分析任意网页。用户可以在 MCP 客户端内直接调用该服务器,完成网页截图、页面版本对比(用于发现视觉回归)以及获取 AI 页面摘要等任务。

主要能力

  • 网页捕获:可将任意 URL 捕获为 PNG、JPEG、WebP、PDF 或 HTML 格式。
  • 页面版本对比:支持对比不同页面版本,从而发现视觉回归(visual regressions)。
  • AI 页面摘要:可获取 AI 生成的页面摘要。
  • 工具标注:这些工具针对 MCP 客户端做了标注,并包含更丰富的标题、分类元数据和示例意图,有助于在 Claude Desktop 和 Cursor 中更好地进行工具选择。

两种连接方式

  1. 托管模式(使用 OAuth):将 MCP 客户端指向 https://mcp.snapshot-site.com/mcp 并登录。无需运行本地进程,客户端配置中也不需要 API 密钥;服务器会根据 OAuth 会话解析用户账户。
  2. 本地模式(使用 API 密钥):自行通过 stdio 运行该包,并提供 SNAPSHOT_SITE_API_KEY。服务器将直接调用 Snapshot Site API。 无论采用哪种方式,调用都会计入与直接 API 调用相同的套餐配额;通过 MCP 进行的调用不会被单独计量。

使用方式(本地 stdio 模式) 托管服务器不需要凭据——通过 OAuth 登录后,服务器会从会话中解析账户。如果使用本地 stdio 模式,则需要 Snapshot Site API 密钥:

  1. 注册 Snapshot Site Console 账户。
  2. 在 API Keys 页面创建 API 密钥。
  3. 将密钥作为 SNAPSHOT_SITE_API_KEY 环境变量传递给服务器。
  4. 除非指向自托管或暂存实例,否则保持 SNAPSHOT_SITE_BASE_URL 为默认值(https://api.prod.ss.snapshot-site.com)。

运行要求与测试情况 需要 Node.js 20.9 或更高版本。基于 @modelcontextprotocol/sdk v1.28 构建,已通过 stdio 在 Claude Desktop 和 Cursor 上测试,并可与任何支持 streamable HTTP 传输的客户端一起针对托管端点使用。

OAuth 发现流程 客户端连接托管服务器时,服务器会先根据签发者(issuer)验证令牌,并解析令牌所属账户,然后再运行工具。

关于 client_id client_id 仅在授权步骤中需要。如果客户端无法事先发现该 client_id,则需在连接器 UI 中手动输入;OAuth 流程开始后无法再注入。服务器可以通过在 /.well-known/oauth-protected-resource 中暴露 preferred_client_id 来发布实验性的 implicit 模式。读取该元数据的客户端可能可跳过手动输入;忽略该字段的客户端仍需要手动提供 client_id。

远程 HTTP 模式 该包也支持面向使用 mcp-remote 的客户端的托管 MCP 端点。可启动 HTTP 服务器,并通过环境变量进行配置。远程客户端配置可使用直接的 API 密钥头部。托管服务器是无状态的,每个请求都通过 x-snapshotsiteapi-key 进行身份认证,因此可以安全地在多个副本上运行,而无需会话亲和性(session affinity)。

Zitadel / OAuth 远程 HTTP 服务器还支持对照 OIDC 签发者(例如 Zitadel)验证的 OAuth 持有者令牌(bearer tokens)。在持有者令牌模式下,MCP 服务器根据签发者的 JWKS 验证传入的访问令牌,然后使用服务器端的 Snapshot Site API 密钥调用后端 API。它还暴露并代理相关端点,以便 MCP 客户端自动发现授权服务器元数据。当设置了 OIDC_DISCOVERY_CLIENT_ID 时,受保护资源元数据中还会包含该信息,这是面向能够自动推断 OAuth 公共客户端的客户端的实验性兼容提示;手动输入 client_id 仍是可靠的备选方案。

registration_endpoint 兼容垫片 MCP 服务器还暴露了一个轻量级的 registration_endpoint 兼容垫片。该垫片目前返回预配置的公共 PKCE 客户端,而不是为每次安装配置全新的 Zitadel 客户端。只要客户端请求的 redirect_uris 是有效的 HTTPS URL,它就会验证并反映这些地址。此举旨在改善对期望 DCR 风格发现的客户端的兼容性,同时保留现有的手动流程作为备选。

适用场景 适用于需要在 AI 对话或 MCP 客户端工作流中进行网页截图捕获、页面视觉回归对比以及快速获取页面摘要的用户。用户可先在 Screenshot 控制台游乐场(playground)中预览捕获及其参数,再将其接入工具调用,适用于不确定应使用哪些选项的情况。

限制 资料未提供工具的完整清单、各参数细节、定价与套餐具体内容、速率限制、支持的最大页面数量或截图尺寸等具体限制信息,暂未提供。