Urlbox Full Page Screenshots
официальныйMCP-сервер для Urlbox Screenshot API. Он позволяет вашему клиенту делать скриншоты, создавать PDF-файлы, извлекать HTML/markdown и многое другое с веб-сайтов.
Что можно делать с Urlbox Full Page Screenshots MCP?
- Делайте полноэкранные скриншоты — Запросите скриншот любого URL-адреса с возможностью блокировки рекламы или баннеров с cookie.
- Создавайте PDF и видео — Запросите PDF с оглавлением или видеорендер страницы, сохраняемый локально через
save_render. - Извлекайте содержимое страниц — Преобразуйте любую статью или веб-страницу в чистый markdown, HTML или обычный текст статьи.
- Сравнивайте версии страниц — Попросите визуально сравнить два URL-адреса или зафиксировать, как сайт выглядит на мобильном вьюпорте.
- Управляйте ресурсами Urlbox — С помощью ключа организации создавайте или обновляйте проекты, проверяйте вебхуки и просматривайте использование аккаунта.
Документация
Urlbox MCP-сервер для скриншотов
Дайте вашему ИИ-ассистенту настоящий браузер для создания скриншотов веб-сайтов. MCP-сервер Urlbox делает скриншоты, создает PDF и видео, извлекает HTML, markdown и текст статей, сравнивает страницы, а также управляет вашими проектами Urlbox, вебхуками и использованием.
Использование хостируемого сервера (рекомендуется)
Подключите ваш клиент к 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>. Ключ организации (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 | Ваш ключ организации или секретный ключ проекта. |
SECRET_KEY | Также принимается для конфигураций, написанных для 1.x. URLBOX_API_KEY имеет приоритет, если заданы оба. |
URLBOX_DOWNLOAD_DIR | Куда save_render сохраняет файлы. По умолчанию — ~/Downloads. |
Мост добавляет один локальный инструмент, save_render, который загружает URL рендера, возвращаемый любым инструментом Urlbox, и сохраняет его на ваш компьютер. Просто попросите, например, «сделай скриншот example.com и сохрани его на мой компьютер». Существующие файлы никогда не перезаписываются.
Обновление с версии 1.x
Ваша существующая конфигурация продолжает работать: SECRET_KEY по-прежнему читается, а имя пакета и команда не изменились.
- Инструменты теперь поступают с хостируемого сервера, поэтому их стало гораздо больше, и они продолжают улучшаться без обновления.
renderпо-прежнему доступен. Его опцияstore_rendersи инструментdownloadзаменены наsave_render.- Файлы сохраняются в
~/Downloadsвместо~/Downloads/urlbox-renders. УстановитеURLBOX_DOWNLOAD_DIR, чтобы сохранить прежнее расположение. - С секретным ключом проекта вы получаете инструменты рендеринга. Используйте ключ организации, чтобы также управлять проектами, вебхуками и использованием.
- Требуется 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
