Stealth Agent Browser

Stealth Agent Browser

ykshah1309Apache-2.0
1 звёзд
Stealth Agent Browser — это MCP-сервер, который запускает Chromium-браузер с усиленной защитой от обнаружения. Разработчики используют его, чтобы AI-агенты могли взаимодействовать с веб-страницами, не раскрывая свою «ботовую» сущность. Сервер решает несколько задач одновременно. Обходит современные системы детекции (CreepJS, bot.sannysoft.com). Экономит токены за счёт компактных YAML-слепков вместо сырого HTML. Даёт модели визуальную привязку благодаря размеченным скриншотам. В основе лежит модифицированная версия Playwright с пропатченной утечкой CDP — там, где обычные плагины бессильны.
ChromeBrowser
Открыть на GitHubОфициальный сайт

Установка

npx -y stealth-agent-browser-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикykshah1309
  • ЛицензияApache-2.0

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Запускает Chromium в режиме «невидимки» — обходит тесты на бота (CreepJS, bot.sannysoft.com) за счёт пропатченного протокола CDP (без утечки Runtime.Enable).
  • Возвращает слепок страницы в формате YAML (~2–5 КБ) вместо полного HTML (100+ КБ). Резко экономит токены и ускоряет ответ модели.
  • Присваивает каждому интерактивному элементу уникальный идентификатор вроде [ref=e23]. Действия выполняются по id — никаких CSS-селекторов.
  • Делает скриншот с гибридной разметкой (mode: "hybrid"): накладывает на изображение красные рамки с номерами (техника Set-of-Mark). Номера на картинке совпадают с id в YAML-слепке.
  • Извлекает читаемое содержимое через Mozilla Readability и JSDOM. На выходе — чистый Markdown без рекламы, баннеров и лишних блоков.
  • Поддерживает инкрементальное чтение: при повторном вызове возвращает только изменившиеся данные. Если контент не обновился, повторное чтение ничего не стоит.
  • Выполняет произвольный JavaScript на целевой странице и возвращает результат в структурированном виде.
  • Управляет вкладками: открывает новые, переключается между ними и закрывает их по запросу агента.
  • Работает с прокси с по-сессионной авторизацией. Подходит для резиденциальных пулов и сервисов, ограничивающих доступ по IP.
  • Изолирует сессии: каждая сессия браузера запускается с чистым профилем — куки и данные разных сессий не смешиваются.

Как подключить

1. Установите сервер глобально:

npm install -g stealth-agent-browser-mcp

Браузер Chromium загрузится автоматически при первом запуске. Если этого не произошло, выполните npx playwright-core install chromium.

2. Добавьте запись в конфигурацию MCP-клиента. Например, для Claude Desktop:

{ "mcpServers": { "stealth-browser": { "command": "npx", "args": ["-y", "stealth-agent-browser-mcp"], "env": { "SAB_HEADLESS": "true", "SAB_STEALTH_LEVEL": "patched" } } } }

3. Перезапустите клиент. После перезапуска ассистент получит доступ к инструментам управления браузером.

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

  • «Открой страницу, сделай слепок в YAML и покажи все элементы с ref-идентификаторами».
  • «Сделай скриншот в режиме hybrid, нажми на кнопку под номером 5 и верни чистый текст получившегося раздела».
  • «Проверь сайт на детекцию бота — запусти тест bot.sannysoft.com и покажи скриншот с результатом».
  • «Извлеки читаемое содержимое статьи через Readability и сохрани в Markdown».

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: Apache-2.0
  • Совместимые клиенты: Claude Desktop, Claude Code, Cursor и другие MCP-хосты

Поделиться