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-сервер для скриншотов

image

Дайте вашему ИИ-ассистенту настоящий браузер для создания скриншотов веб-сайтов. 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 или новее.

Примеры запросов

Разработка

npm install
npm test

Тесты запускают мост против локального фейкового сервера, поэтому им не нужен аккаунт Urlbox.

Лицензия

MIT