Camoufox Research

MCP-сервер веб-ресёрча на анти-детект браузере Camoufox: поиск, чтение страниц (включая JS/SPA), батч-чтение, клики, ввод текста, живые сессии, кэш и retry. Устанавливается как обычный Python-пакет и подключается к любому MCP-харнессу (opencode, Claude Desktop, Cursor…).

Структура

camoufox-reasearch/
├── camoufox_research/     # Python-пакет (движок + MCP-интерфейс)
│   ├── __init__.py
│   ├── camoufox_browser.py    # обёртка Camoufox (launch, настройки)
│   ├── camoufox_session.py    # живая сессия: навигация, клики, ввод, скролл
│   ├── camoufox_fetch.py      # чтение страниц + batch_fetch + извлечение текста
│   ├── camoufox_research.py   # MCP-сервер (FastMCP, stdio), entry point
│   ├── camoufox_rpc.py        # протокол сервер ↔ воркер
│   ├── camoufox_worker.py     # процесс-воркер (sync Camoufox, headless)
│   ├── camoufox_cache.py      # sqlite-кэш страниц, TTL сутки
│   └── session_tools.py       # общие хелперы сервера
├── mcp/
│   ├── server.py              # запуск из исходников без установки
│   ├── requirements.txt       # зависимости (запинены)
│   └── config/                # примеры подключения к харнессам
├── scripts/
│   ├── update_camoufox.py     # установка/обновление браузера (все ОС)
│   └── _compat.py             # кроссплатформенные хелперы (UTF-8, venv)
├── configs/example.env        # переменные окружения (опционально)
├── research/                  # результаты ресёрча (не коммитится)
├── .github/workflows/ci.yml   # CI: py 3.10-3.12, установка, stdio smoke
├── pyproject.toml             # пакет + entry point `camoufox-research`
├── README.md
└── POSTING_RULES.md           # pre-release checklist

Установка

git clone <ваш-репозиторий> camoufox-reasearch && cd camoufox-reasearch

# 1. venv + пакет
python3 -m venv ~/.venvs/camoufox-research
~/.venvs/camoufox-research/bin/pip install .

# 2. скачать браузер (один раз)
~/.venvs/camoufox-research/bin/python -m camoufox fetch

# 3. проверить
~/.venvs/camoufox-research/bin/camoufox-research   # ждёт stdin (stdio)

Windows: venv\Scripts\pip.exe install ., venv\Scripts\python.exe -m camoufox fetch; нужен Python не из MS Store и VC++ Redistributable (детали — в docstring scripts/update_camoufox.py).

Подключение MCP

opencode (~/.config/opencode/opencode.json):

{
  "mcp": {
    "camoufox": {
      "type": "local",
      "command": ["/путь/до/venv/bin/camoufox-research"],
      "enabled": true
    }
  }
}

Claude Desktop и другие — готовые примеры в mcp/config/. Без установки пакета можно запускать python mcp/server.py (shim).

Проверка: opencode mcp list → camoufox: connected.

Инструменты (19)

Группа	Инструменты
Ресёрч	research (глубокий поиск с чтением), web_search
Чтение	fetch_page, batch_fetch, extract_links
Браузер	browser_navigate, browser_click, browser_type
Живая сессия	session_start/navigate/click/type/scroll/links/text/back/status/end
Сервис	ping

Поведение

• Браузер живёт в отдельном процессе-воркере (sync, headless=True) — сервер stdio не блокируется.
• JS-страницы (SPA/React/Next) читаются без подготовки: поллинг контента + скролл + стабильность; пусто — повторный вызов.
• Кэш: sqlite ~/.cache/camoufox-research/cache.db, TTL сутки, retry с backoff, лимит по памяти/сети (macOS vm_stat).
• Конфигурация — только через окружение (см. configs/example.env): CAMOUFOX_VENV, CAMOUFOX_CACHE_DIR, таймауты, прокси.

CI

При каждом push GitHub Actions проверяет: установка пакета на Python 3.10/3.11/3.12, компиляция импортов, MCP stdio smoke (initialize → tools/list → ping). Полный тест с браузером — локально (update_camoufox.py + ручной smoke).

Лицензии зависимостей

• camoufox — его лицензия в репозитории проекта
• mcp — MIT
• trafilatura — Apache-2.0 / GPL-3.0

Принадлежит: t.me/aidvizhenie · t.me/hilartem · t.me/aidvizh_hub