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)

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