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 服务器
为您的 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_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
