CamoFox Browser — антидетект-браузер для ИИ-агентов
camofox-browser
REST-сервер и CLI на движке Camoufox: агент открывает страницы с подменой отпечатка браузера и читает их как дерево элементов
- 443 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Подмена отпечатка нужна, чтобы сайты хуже распознавали автоматику: многие правила площадок это запрещают, и аккаунт могут заблокировать
- Постоянные профили, куки и хранилище учетных данных дают агенту доступ к вашим входам на сайтах
- Скилл `reddit` публикует посты и комментарии от имени вашего аккаунта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/camofox-browserОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Подмена отпечатка нужна, чтобы сайты хуже распознавали автоматику: многие правила площадок это запрещают, и аккаунт могут заблокировать
- Постоянные профили, куки и хранилище учетных данных дают агенту доступ к вашим входам на сайтах
- Скилл `reddit` публикует посты и комментарии от имени вашего аккаунта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
CamoFox Browser — сервер на TypeScript (Node.js 22 и новее), который оборачивает Camoufox, форк Firefox с подменой отпечатка устройства на уровне движка. Агент работает с ним через REST API или через CLI `camofox`: открывает страницу, получает снимок доступности с метками `e5`, `e3` и кликает или вводит текст по этим меткам. Такой снимок короче сырого HTML и скриншота, поэтому расходует меньше токенов. Для каждого `userId` создается отдельный контекст браузера с постоянным профилем Firefox: куки, localStorage и IndexedDB сохраняются между запусками. По умолчанию действуют лимиты в 50 сессий и 10 вкладок на сессию. Есть 8 региональных пресетов (язык, часовой пояс, геопозиция), прокси на уровне сессии, 14 макросов поиска (Google, YouTube, Amazon, Reddit и другие), структурное извлечение данных по JSON-схеме, запись консоли браузера и трассировки Playwright. Менеджер учетных данных шифрует их AES-256-GCM, а флаг `--inject` передает пароль прямо в браузер, и агент его не видит. В репозитории лежат скиллы для агентов, которые ставятся командой `npx skills add redf0x1/camofox-browser`: `camofox-browser`, `camofox-cli`, `dogfood`, `gemini-image` и `reddit`. Для MCP-клиентов автор отсылает к отдельному проекту CamoFox MCP. Проект назван в README предварительным выпуском (Preview).
Для кого. Разработчикам агентов и автоматизации, которым нужен управляемый браузер с постоянными профилями и отпечатком, отличным от стандартного Playwright.
Подходит, если
- Агент должен ходить по сайтам, где обычный Playwright или Puppeteer распознают как автоматику
- Вход в аккаунт надо сохранить между запусками, чтобы агент возвращался в ту же сессию
- Проверка страниц из разных регионов требует языка, часового пояса и геопозиции из готового пресета
- Нужны данные со страницы в виде JSON по заданной схеме, без выполнения произвольного скрипта
- Для сценария тестирования веб-приложения агенту нужен скилл `dogfood` и запись трассировки
Не подходит, если
- Задача решается обычным Playwright: подмена отпечатка добавляет память и сложность без пользы
- Сайт запрещает автоматизацию в правилах или API: подмена отпечатка нарушает условия и ведет к блокировке аккаунта
- Нужно держать сервер в открытой сети без ключа: при `CAMOFOX_HOST`, отличном от loopback, обязателен `CAMOFOX_API_KEY`
- Требуется стабильный API: в статусе Preview формат ответов и локальное состояние могут измениться между минорными версиями
Пример запроса к агенту
Открой в браузере camofox страницу https://example.com, сделай снимок доступности, найди форму поиска и введи в нее «MCP»Ограничения
Нужны Node.js 22 или новее и от 2 ГБ памяти; для боевой нагрузки рекомендован Linux. Движок Camoufox скачивается при `npm install`, и установка завершается ошибкой, если он не скачался или не прошел проверку.
Сервер слушает loopback по умолчанию. Для других адресов `CAMOFOX_HOST` требуется `CAMOFOX_API_KEY`, режим `CAMOFOX_AUTH_MODE=disabled` предназначен только для закрытой сети агентов. Доступ к частным адресам и метаданным разрешается переменной `CAMOFOX_ALLOW_PRIVATE_NETWORK`. Предварительный выпуск не гарантирует стабильный API и миграцию локального состояния при обновлении.
Как отключить. Остановите сервер, удалите пакет командой `npm uninstall -g camofox-browser` и каталог `~/.camofox` с профилями и хранилищем учетных данных. Скиллы агента удалите из его папки скиллов.
Частые вопросы
Как поставить CamoFox Browser?
Выполните `npm install -g camofox-browser`, затем `camofox open https://example.com`. CLI запускает сервер сам. Для сборки из исходников клонируют репозиторий и выполняют `npm install`, `npm run build` и `npm start`.
Как подключить скиллы CamoFox к Claude Code?
Выполните `npx skills add redf0x1/camofox-browser` и выберите нужные скиллы. Для Claude Code `SKILL.md` ложится в `.claude/skills/camofox-browser/`, для Cursor, Copilot и Codex в `.agents/skills/`.
Есть ли MCP-сервер CamoFox?
В этом репозитории нет, его ведет отдельный проект CamoFox MCP (redf0x1/camofox-mcp) для Claude, Cursor и VS Code. Здесь же лежат REST API, CLI и скиллы.
Как агент входит в аккаунты, не видя пароль?
Через хранилище учетных данных: `camofox auth load gmail --inject --user` передает данные прямо в браузер. Записи шифруются AES-256-GCM с ключом из Argon2id, а пароль в stdout не попадает.
Какой порт использует сервер?
По умолчанию `9377`, меняется переменной `CAMOFOX_PORT`. Адрес `127.0.0.1` задан по умолчанию, для Docker его меняют на `0.0.0.0` вместе с `CAMOFOX_API_KEY`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыМенеджер профилей антидетект-браузера с отдельным отпечатком, куки и прокси на профиль. Встроенный MCP-сервер подключает агента.
Отдельный браузер для агентов со скиллом и MCP: Claude Code и Codex работают в ваших аккаунтах, каждый сеанс записывается и доступен для просмотра
Chromium с подменой отпечатка устройства на уровне движка и MCP-сервер, который дает агенту управлять им через Playwright
Браузер на Rust без Chromium с собственным отпечатком TLS и V8; MCP-сервер отдает агенту страницы и проверку защиты сайта.
Браузер для агента на прямом CDP без Playwright: профили с логинами, CLI, MCP-сервер и запись сценариев в скилл
Скилл веб-исследования: SearXNG ищет, Camofox читает страницы, CloakBrowser открывает сайты, которые проверяют посетителей
Коротко о README
README объясняет подмену отпечатка на уровне движка и сравнивает сервер с Playwright, затем описывает статус Preview, запуск из исходников и через npm, команды CLI, REST API, переменные окружения, Docker и деплой на Fly.io, Railway и Render. Лицензия MIT.