camoufox-mcp

camoufox-mcp

baixianger
7 звёзд1 форков
Camoufox MCP — это сервер для браузерной автоматизации, построенный на базе защищённого браузера Camoufox (специализированная сборка Firefox). Его главная задача — дать AI-ассистенту возможность управлять браузером так, чтобы сайты не могли отличить его от живого пользователя. Инструмент пригодится разработчикам, которые парсят сайты с Cloudflare и DataDome, автоматизируют тестирование или создают AI-агентов. В отличие от стандартного headless-режима, Camoufox подменяет цифровые отпечатки, имитирует человеческое поведение и умеет работать с прокси с привязкой к GeoIP.
ScrapingBrowserProductivityFirefox
Открыть на GitHub

Установка

npx -y camoufox-mcp

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

Общее

  • СтатусСообщество
  • Разработчикbaixianger

Технологии

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

Описание

Возможности

  • Обход антидетекта: подмена Canvas-, WebRTC-, Audio- и таймзонных отпечатков. Сайты видят уникальный браузер, а не бота.
  • Изолированные сессии: каждая сессия работает со своими куки, localStorage и кешем. Можно запустить несколько профилей одновременно.
  • Эмуляция человека: плавные траектории курсора и естественные задержки при кликах.
  • Прокси с GeoIP: при подключении прокси сервер автоматически подменяет часовой пояс, язык и локаль.
  • JavaScript в двух контекстах: выполнение скриптов в main world (доступ к NUXT, NEXT_DATA) и в изолированном контексте с async/await.
  • Сохранение состояния: куки и localStorage можно экспортировать в JSON и загружать обратно. Не требуется повторная аутентификация.
  • Перехват сети (network interception): контроль всех запросов, блокировка ненужных ресурсов.
  • Автоматическое закрытие cookie-попапов: встроенная библиотека из 50+ селекторов для популярных сайтов.
  • Запись действий пользователя: сервер записывает последовательность кликов и ввод текста для последующего воспроизведения.
  • Автоустановка: браузер (~150 МБ) загружается автоматически при первом запуске.

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

1. Установите MCP-сервер через npm:

npx -y camoufox-mcp

2. Добавьте конфигурацию в ваш MCP-клиент. Для Claude Desktop отредактируйте файл claude_desktop_config.json:

{ "mcpServers": { "camoufox": { "command": "npx", "args": ["-y", "camoufox-mcp"] } } }

3. Если используете прокси, укажите переменные окружения PROXY_SERVER, PROXY_USER и PROXY_PASS. Подробные настройки задаются в файле ~/.config/camoufox-mcp/settings.json.

4. Перезапустите клиент. При первом запуске сервер автоматически загрузит браузер Camoufox.

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

«Зайди на страницу товара, дождись загрузки динамического контента, собери цену и характеристики в JSON.»

«Авторизуйся на портале поставщика, экспортируй куки в файл session.json.»

«Открой три сессии с разными прокси. В каждой найди тариф и сравни условия доставки.»

«Найди кнопку по XPath, кликни по ней с человеческой задержкой и запиши консольный лог.»

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

  • Язык: TypeScript
  • Транспорт: stdio
  • Движок: Camoufox (Firefox Gecko)
  • Лицензия: MIT
  • Версия Node.js: 18+
  • Установка: npx -y camoufox-mcp
  • Совместимость: Claude Desktop, Cursor, Continue.dev и любые MCP-хосты со stdio

Поделиться