Skip to main content
Glama
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`.