ScreenshotOne

MCP-сервер ScreenshotOne

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

Несколько слов о причинах его создания и размышления о будущем MCP.

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

Инструменты

• render-website-screenshot: Создаёт снимок экрана сайта и возвращает запрошенные временные URL снимка, содержимого и фрагментов.
• render-website-screenshot-as-file: Создаёт снимок экрана сайта или PDF-файл и возвращает сам файл, встроенный в ответ как ресурс MCP, вместе с временным 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 снимка экрана доступен до четырёх часов, а содержимое метаданных включает точное время истечения срока действия. Скачайте все нужные вам файлы.

render-website-screenshot-as-file предназначен для клиентов, которым нужен сам файл, например чтобы сохранить или прикрепить его, либо которые не могут скачивать файлы по ссылкам. Он принимает url, format (по умолчанию jpg, а также png, webp, gif, jp2, tiff, avif, heif или pdf), block_banners, block_ads, image_quality, full_page и full_page_max_height (требуется full_page=true). Он возвращает файл как встроенный ресурс (type: "resource" с blob в формате base64 и его MIME-типом), а также его имя, URI, MIME-тип, размер и временный URL в виде текста и структурированного содержимого. Файлы размером более 5 МБ не встраиваются; инструмент возвращает ошибку с рекомендацией выбрать меньший формат, качество или высоту и включает временный URL.

extract-website-markdown принимает только url. Это специализированный способ выполнить запрос к API ScreenshotOne format=markdown; он возвращает полученный 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.