ScreenshotOne

официальный

Рендеринг скриншотов веб-сайтов с помощью ScreenshotOne

GitHub
36
Попробовать этот MCPСпонсировано

Что можно делать с ScreenshotOne MCP?

  • Рендеринг скриншотов веб-сайтов — Запросите скриншот любого URL с такими опциями, как full_page, block_ads и image_quality, через render-website-screenshot.
  • Извлечение содержимого страницы в Markdown — Используйте extract-website-markdown, чтобы получить очищенную, читаемую Markdown-версию любой веб-страницы для анализа.
  • Получение срезов полной страницы — Укажите full_page=true и full_page_slices=true, чтобы получить меньшие вертикальные URL-адреса изображений для анализа длинных страниц.
  • Проверка квоты использования API — Вызовите get-usage, чтобы увидеть текущую квоту API ScreenshotOne и использование параллелизма.

Документация

MCP-сервер ScreenshotOne

Официальная реализация MCP (Model Context Protocol) сервера для ScreenshotOne.

Ещё несколько слов о том, зачем он был создан, и некоторые мысли о будущем MCP.

ScreenshotOne также предлагает официальный размещённый MCP-сервер. См. интеграцию MCP ScreenshotOne для получения инструкций по настройке и последних обновлений.

ScreenshotOne Server MCP server

Инструменты

  • render-website-screenshot: Создаёт скриншот веб-сайта и возвращает временные URL-адреса скриншота, контента и срезов по запросу.
  • extract-website-markdown: Отрисовывает веб-сайт и возвращает его очищенный Markdown напрямую в виде текста.
  • get-usage: Получает информацию о квоте API ScreenshotOne и использовании параллельных запросов.

Инструмент создания скриншотов предоставляет следующие основные параметры:

  • url
  • block_banners (по умолчанию true)
  • block_ads (по умолчанию true)
  • image_quality (по умолчанию 80)
  • full_page (по умолчанию false)
  • full_page_slices (по умолчанию false; требуется full_page=true)
  • metadata_content (по умолчанию false)
  • metadata_content_format (html или markdown; требуется metadata_content=true)

Названия параметров и значения для метаданных контента и срезов полной страницы соответствуют API ScreenshotOne. Инструмент не предоставляет управление типом ответа или кэшем; он всегда запрашивает JSON-ответ с отключённым кэшированием API.

Установите metadata_content=true и metadata_content_format=markdown, чтобы получать временный URL-адрес Markdown-контента вместе со скриншотом. Установите full_page=true и full_page_slices=true, чтобы получать URL-адреса меньших вертикальных срезов скриншота. Срезы предпочтительны, когда ИИ-агенту необходимо проанализировать длинную страницу, которая может не обрабатываться надёжно как одно большое изображение.

Успешный захват возвращает запрошенные URL-адреса в виде текста и структурированного контента:

{
    "url": "https://<screenshotone-cache-domain>/...",
    "content": {
        "url": "https://<screenshotone-cache-domain>/...",
        "expires": "Sun, 07 Sep 2026 12:00:00 GMT",
        "format": "markdown"
    },
    "slices": [
        {
            "index": 0,
            "offset_y": 0,
            "width": 1280,
            "height": 4000,
            "url": "https://<screenshotone-cache-domain>/..."
        }
    ]
}

URL-адреса являются временными. URL-адрес скриншота доступен до четырёх часов, а метаданные контента включают точное время его истечения. Скачайте любые артефакты, которые вам нужно сохранить.

extract-website-markdown принимает только url. Это узконаправленный ярлык для API-запроса format=markdown ScreenshotOne и возвращает полученный Markdown напрямую в одном текстовом ответе MCP. Используйте его, когда агенту нужно прочитать или проанализировать содержимое страницы без скриншота.

Использование

Сборка

Всегда сначала устанавливайте зависимости и выполняйте сборку:

npm install && npm run build

Получите свой API-ключ ScreenshotOne

Зарегистрируйтесь на ScreenshotOne и получите свой API-ключ.

Запуск с помощью npx

Запустите CLI напрямую из npm-пакета без клонирования репозитория:

SCREENSHOTONE_API_KEY=your_api_key npx --yes @screenshotone/mcp

С Claude для Desktop

Добавьте следующее в ваш ~/Library/Application\ Support/Claude/claude_desktop_config.json:

{
    "mcpServers": {
        "screenshotone": {
            "command": "npx",
            "args": ["--yes", "@screenshotone/mcp"],
            "env": {
                "SCREENSHOTONE_API_KEY": "<your api key>"
            }
        }
    }
}

Автономно или для других проектов

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

Лицензия

ScreenshotOne MCP Server лицензирован по лицензии MIT.