Urlbox MCP Server 是一个面向 AI 助手的浏览器工具服务器，可为网站截图、生成 PDF 和视频、提取 HTML、Markdown 与文章正文、比较页面，并管理 Urlbox 项目、webhook 与用量。
【用途】 为 Claude、ChatGPT 及其他 AI 助手提供真实浏览器能力，让助手能够直接抓取和渲染网页内容，并将结果以截图、PDF、视频或文本形式返回。
【主要能力】
- 网站截图
- 生成 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 运行，并将所有请求转发到托管服务器，因此工具与托管服务器完全一致且始终保持最新。需要 Node.js 20 或更高版本。
桥接会额外添加一个本地工具 save_render，用于下载任意 Urlbox 工具返回的渲染 URL 并保存到计算机。例如可要求“截图 example.com 并保存到我的电脑”。已存在的文件不会被覆盖。
从 1.x 升级：原有配置继续可用，SECRET_KEY 仍会被读取，包名和命令不变。工具现在来自托管服务器，因此数量更多，且无需更新即可持续改进。render 仍然存在，其 store_renders 选项和下载工具被 save_render 取代。文件保存到 ~/Downloads 而不是 ~/Downloads/urlbox-renders，可设置 URLBOX_DOWNLOAD_DIR 保留旧位置。使用项目密钥只能获得渲染工具，使用组织 API 密钥还可管理项目、webhook 和用量。要求 Node.js 20 或更高版本。
【示例提示词】
- Take a screenshot of https://example.com without ads or cookie banners.
- Save https://urlbox.com as a tagged PDF with an outline and download it to my computer.
- Turn this article into markdown: https://example.com/blog/post
- How does https://example.com look on a phone?
【限制】 使用渲染工具需要 Urlbox API 密钥；管理项目、webhook 和用量需要组织 API 密钥。本地桥接方式需要 Node.js 20 或更高版本。测试通过本地假服务器运行桥接，因此无需 Urlbox 账号。
