Site-Shot MCP server

Дайте Claude, Cursor и другим ИИ-агентам возможность видеть любую веб-страницу — делайте скриншоты сайтов с помощью Site-Shot через Model Context Protocol.

Настоящий рендеринг Chromium · захват всей страницы · прокси по странам · автоматическое удаление рекламы и cookie-баннеров (чище изображения, меньше токенов для зрения).

Быстрый старт (Claude Desktop)

1. Получите API-ключ Site-Shot на https://www.site-shot.com/start/.

2. Добавьте это в конфигурацию Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "site-shot": {
      "command": "npx",
      "args": ["-y", "site-shot-mcp"],
      "env": { "SITESHOT_API_KEY": "YOUR_API_KEY" }
    }
  }
}

3. Перезапустите Claude Desktop. Попросите его "сделать полноэкранный скриншот https://news.ycombinator.com" и он вызовет сервер и покажет вам изображение.

Работает так же в любом MCP-клиенте (Cursor, Cline, VS Code, LangChain, CrewAI) — укажите клиенту npx -y site-shot-mcp с SITESHOT_API_KEY в окружении.

Related MCP server: ScreenshotOne MCP Server

Инструменты

capture_screenshot

Сделать скриншот веб-страницы (по умолчанию — область просмотра).

Возвращает скриншот в виде MCP-изображения.

"API default" — это не число, которое этот пакет может указать. width, height и wait_ms передаются только тогда, когда вы их передаёте, поэтому то, что применяется, когда вы их не передаёте, решает Site-Shot API и может измениться без выпуска новой версии здесь. Версии до 1.1.0 выводили размеры в пикселях для width / height, которые API не использует — агент, опускавший их, чтобы получить «значение по умолчанию», получал другой вьюпорт, и в возвращённом изображении ничто не указывало на это. Передавайте явные значения, когда размер важен.

Коды стран — это коды ISO, а не названия. Передавайте "DE", а не "Germany". API сопоставляет коды точно и в противном случае выполнил бы рендеринг через прокси в США, не сообщив вам об этом, поэтому сервер отклоняет полные названия прежде чем потратить рендер. strict_country (включён по умолчанию) точно так же превращает недоступную страну в ошибку вместо тихого скриншота через США — передайте false, чтобы вернуться к запасному варианту. Поддерживаемые страны →

capture_full_page

То же, что и capture_screenshot, но с включённым захватом всей страницы.

Зачем вызывать этот сервер вместо собственного браузера агента?

Если ваш агент управляет браузером, он может сам делать скриншоты страниц — и для страниц, требующих входа или прохождения по сценарию, это правильный инструмент. Для публичных URL делегирование захвата этому серверу обычно лучше с инженерной точки зрения: каждый захват выполняется по одному и тому же конвейеру (без повторного планирования между запусками), может быть выполнен из конкретной страны с соответствующими локалью и часовым поясом (country + strict_country), оценивается классификатором изображений с эскалационной лестницей повторных попыток перед возвратом результата и стоит долю цента вместо сеанса браузера плюс vision-токены за каждый просмотр. Полное сравнение, честно рассматривающее обе стороны: ИИ-агент против API скриншотов — кто должен захватывать страницу.

Конфигурация

Сервер — это тонкая обёртка над существующим HTTP API Site-Shot (https://api.site-shot.com/) — без отдельного бэкенда.

Локальная разработка

npm install
npm run check   # syntax check
npm run smoke   # offline tests (stubbed fetch, no API key needed)
SITESHOT_API_KEY=yourkey npm start   # run the server on stdio

Требования

Node.js ≥ 18 (использует встроенный fetch).

Лицензия

MIT