Urlbox Full Page Screenshots

Urlbox 截图 MCP 服务

为你的 AI 助手提供一个真正的浏览器，用于截取网站截图。Urlbox MCP 服务可截取截图、生成 PDF 和视频、提取 HTML、Markdown 和文章文本、比较页面，以及管理你的 Urlbox 项目、webhook 和用量。

使用托管服务（推荐）

将客户端连接到 https://api.urlbox.com/mcp。无需安装。

• Claude（claude.ai 和桌面端）：依次打开 Settings、Connectors、Add custom connector，输入 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" }
      }
    }
  }
  

无法登录的客户端可以通过 Authorization: Bearer <key> 发送 API 密钥。组织 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_DIR	save_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 或更高版本。

示例提示词

• 截取 https://example.com 的截图，不要显示广告或 Cookie 横幅。
• 将 https://urlbox.com 保存为带标签和大纲的 PDF，并下载到我的计算机上。
• 将这篇文章转换为 Markdown：https://example.com/blog/post
• https://example.com 在手机上的显示效果如何？

开发

npm install
npm test

测试会使用本地模拟服务运行桥接程序，因此无需 Urlbox 账户。

许可证

MIT