Urlbox Full Page Screenshots

官方

一个用于Urlbox截图API的MCP服务器。它使您的客户端能够从网站截取屏幕截图、生成PDF、提取HTML/标记等。

你可以用 Urlbox Full Page Screenshots MCP 做什么?

  • 截取整页截图 — 请求对任意 URL 进行截图,并可选择屏蔽广告或 Cookie 横幅。
  • 生成 PDF 和视频 — 请求带有目录的标记 PDF,或页面的视频渲染,并通过 save_render 保存到本地。
  • 提取页面内容 — 将任何文章或网页转换为干净的 markdown、HTML 或纯文章文本。
  • 比较页面版本 — 请求对两个 URL 进行视觉差异对比,或捕捉网站在手机视口下的显示效果。
  • 管理 Urlbox 资源 — 使用组织密钥,创建或更新项目、检查 webhook,并查看账户使用情况。

文档

Urlbox 截图 MCP 服务器

image

为您的 AI 助手提供一个真实的浏览器来截取网站截图。Urlbox MCP 服务器可以截取截图、生成 PDF 和视频、提取 HTML、Markdown 和文章文本、比较页面,并管理您的 Urlbox 项目、Webhook 和使用情况。

使用托管服务器(推荐)

将您的客户端连接到 https://api.urlbox.com/mcp。无需安装任何内容。

  • Claude(claude.ai 和桌面版):设置、连接器、添加自定义连接器,输入 https://api.urlbox.com/mcp,然后登录 Urlbox。

  • ChatGPT:使用 URL https://api.urlbox.com/mcp 添加连接器,然后登录 Urlbox。

  • Claude Code:claude mcp add --transport http urlbox https://api.urlbox.com/mcp,然后运行 /mcp 登录。

  • Codex:codex mcp add urlbox --url https://api.urlbox.com/mcp,然后 codex mcp login urlbox 登录。

  • Cursor:将其添加到 ~/.cursor/mcp.json:

    {
      "mcpServers": {
        "urlbox": {
          "url": "https://api.urlbox.com/mcp",
          "headers": { "Authorization": "Bearer YOUR_URLBOX_API_KEY" }
        }
      }
    }
    

无法登录的客户端可以将 API 密钥作为 Authorization: Bearer <key> 发送。组织 API 密钥(ubx_org_...)可解锁所有工具。项目密钥仅适用于渲染工具。您可以在 Urlbox 仪表板 中找到您的密钥。

本地桥接(本包)

某些客户端只能启动本地服务器。本包是一个小型本地桥接:它在您的机器上通过 stdio 运行,并将所有内容转发到托管服务器,因此您可以获得完全相同的工具,并且始终是最新的。

{
  "mcpServers": {
    "urlbox": {
      "command": "npx",
      "args": ["-y", "@urlbox/screenshot-mcp"],
      "env": {
        "URLBOX_API_KEY": "your_api_key_here"
      }
    }
  }
}

需要 Node.js 20 或更高版本。

变量描述
URLBOX_API_KEY您的组织 API 密钥或项目密钥。
SECRET_KEY也接受,适用于为 1.x 编写的配置。如果两者都设置,URLBOX_API_KEY 优先。
URLBOX_DOWNLOAD_DIRsave_render 保存文件的位置。默认为 ~/Downloads。

桥接添加了一个本地工具 save_render,它下载任何 Urlbox 工具返回的渲染 URL 并将其保存到您的计算机。只需说,例如“截取 example.com 的截图并保存到我的电脑”。现有文件永远不会被覆盖。

从 1.x 升级

您现有的配置仍然有效:SECRET_KEY 仍会被读取,包名和命令不变。

  • 工具现在来自托管服务器,因此工具更多,并且无需更新即可持续改进。
  • render 仍然存在。其 store_renders 选项和 download 工具已被 save_render 取代。
  • 文件保存到 ~/Downloads 而不是 ~/Downloads/urlbox-renders。设置 URLBOX_DOWNLOAD_DIR 以保留旧位置。
  • 使用项目密钥,您可以获得渲染工具。使用组织 API 密钥还可以管理项目、Webhook 和使用情况。
  • 需要 Node.js 20 或更高版本。

示例提示

开发

npm install
npm test

测试针对本地假服务器运行桥接,因此不需要 Urlbox 账户。

许可证

MIT