camofox-browser
by best-radar
README.md
#AI #Browser #AntiDetection #Automation #Agents #NodeJS #Firefox #Camoufox #MCP #Docker
# camofox-browser
Антидетект-браузерный сервер для AI-агентов на базе Camoufox - форка Firefox со spoofing отпечатка на уровне C++.
REST API и MCP / OpenClaw-плагин: accessibility-снимки вместо сырого HTML, стабильные element refs, изоляция сессий и макросы поиска.
## Возможности
- C++ anti-detection - обход типичных bot-detection (Google, Cloudflare и др.)
- Стабильные refs `e1`, `e2`, ... для кликов и ввода
- Компактные accessibility snapshots (~90% меньше сырого HTML)
- Ленивый запуск браузера и idle-shutdown (~40MB в простое)
- Изоляция cookies/storage по пользователям, импорт cookie Netscape
- Прокси + GeoIP, загрузки файлов, VNC-логин через noVNC
- YouTube transcripts, search macros, structured extract, session tracing
- Деплой: Docker, Fly.io, Railway; OpenAPI на `/openapi.json` и `/docs`
## Стек
- Node.js (>=22), Express, Playwright Core, Camoufox
- MCP-сервер и OpenClaw plugin с общей контрактной схемой tools
- better-sqlite3, опционально yt-dlp для быстрых YouTube transcripts
## Быстрый старт
```bash
git clone https://github.com/best-radar/bradar-camofox-browser.git
cd bradar-camofox-browser
npm install && npm start
# -> http://localhost:9377
```
Через npx:
```bash
npx @askjo/camofox-browser
```
OpenClaw:
```bash
openclaw plugins install @askjo/camofox-browser
```
### Docker
```bash
make up # сборка и запуск (автоопределение arch)
make down
make reset # чистая пересборка
```
На Windows - `build.ps1` вместо Make.
## Конфигурация
Ключевые переменные окружения (полный список - в исходном README проекта и `camofox.config.json`):
- порт по умолчанию `9377`
- `CAMOUFOX_EXECUTABLE` - внешний бинарник Camoufox (пропуск bundled download)
- `CAMOFOX_CRASH_REPORT_ENABLED=false` - отключение телеметрии
Первый `npm install` / `npm start` может скачать Camoufox (~300MB).
## Лицензия
MIT - см. файл `LICENSE`.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues