Auto Browser

Предоставьте своему ИИ-агенту настоящий браузер с возможностью участия человека.

Auto Browser — это управляющая панель браузера на базе MCP для авторизованных рабочих процессов. Она предоставляет клиентам MCP, ИИ-агентам и операторам общий браузер Playwright с возможностью перехвата управления человеком, повторно используемыми профилями аутентификации, одобрениями, журналами аудита и развертыванием по принципу «локально в первую очередь» (local-first).

Работает с:

• Claude Desktop

• Cursor

• любым MCP-клиентом, поддерживающим HTTP или stdio

• прямыми REST-запросами, если вам нужно управление через curl

Почему Auto Browser

• MCP-native с первого дня. Интерфейс браузера изначально упакован как MCP-сервер, а не добавлен позже.

• Перехват управления человеком, когда веб-интерфейс становится нестабильным. noVNC позволяет сохранить доступ к активной сессии, когда человеку нужно вмешаться.

• Войдите один раз, используйте повторно. Сохраняйте именованные профили аутентификации и открывайте новые сессии, в которых вы уже авторизованы.

• Local-first по умолчанию. Запускайте весь стек на своем компьютере с помощью Docker Compose или используйте Codespaces для быстрого ознакомления.

• Встроенные механизмы безопасности. Одобрения, идентификация оператора, очистка персональных данных (PII), квитанции Witness и шаблоны соответствия требованиям — все это часть продукта.

Related MCP server: Browser-Use MCP Server

Основные моменты релиза (v1.0.2)

• Обновления безопасности фреймворка с фиксацией версий FastAPI и Starlette на текущей исправленной ветке

• Более безопасные границы ошибок в действиях браузера, CDP, OCR, mesh, рабочих процессах, туннелях, социальных функциях и поверхностях обмена токенами

• Усиление ограничения частоты запросов (rate-limit) с использованием ограниченных корзин и хешированных идентификаторов операторов

• Ужесточение политики хостов и путей для производственных ALLOWED_HOSTS, путей профилей аутентификации и корневых каталогов загрузки

• Платформенный интерфейс 1.0, включая делегирование mesh с подписью, маршруты рабочих процессов, /dashboard, перехват через noVNC, транспорт MCP, журналы аудита и проверки готовности

Полную историю релизов см. в CHANGELOG.md.

Для чего подходит

• внутренние панели управления и инструменты администрирования

• QA с участием оператора и отладка браузера

• рабочие процессы с авторизацией «войти один раз, использовать позже»

• нестабильные сайты, где человеку может потребоваться восстановить поток действий

• рабочие процессы агентов на базе MCP, которым нужен настоящий браузер, а не просто получение HTML

Что не является целью

• скрытная работа или обход защиты от ботов

• разгадывание CAPTCHA

• несанкционированный парсинг или автоматизация учетных записей

• обманная подмена личности или инструменты обхода

Что вы получаете

Быстрый старт

git clone https://github.com/LvcidPsyche/auto-browser.git
cd auto-browser
docker compose up --build

Этого достаточно для локальной разработки с настройками по умолчанию.

Опционально:

cp .env.example .env
make doctor

Запустите make doctor из обычного терминала с доступом к локальному Docker и разрешением на открытие сокетов localhost.

Откройте:

• Документация API: http://127.0.0.1:8000/docs

• Панель управления оператора: http://127.0.0.1:8000/dashboard

• Визуальный перехват управления: http://127.0.0.1:6080/vnc.html?autoconnect=true&resize=scale

Все опубликованные порты по умолчанию привязаны к 127.0.0.1.

Попробуйте в Codespaces

Codespaces автоматически подготавливает стек. Панель управления и вкладки noVNC обычно готовы примерно через 90 секунд.

Первая полезная демонстрация

Наиболее показательный сценарий в этом репозитории:

1. создание сессии

2. ручной вход, если сайту нужен человек

3. сохранение сессии как именованного профиля аутентификации

4. открытие новой сессии из этого профиля

5. продолжение работы без повторной авторизации

Начните здесь:

• examples/login-and-save-profile.md

• examples/README.md

Минимальное создание сессии:

curl -s http://127.0.0.1:8000/sessions \
  -X POST \
  -H 'content-type: application/json' \
  -d '{"name":"demo","start_url":"https://example.com"}' | jq

Минимальное наблюдение:

curl -s http://127.0.0.1:8000/sessions/<session-id>/observe | jq

MCP-клиенты

Auto Browser предоставляет:

• HTTP MCP-эндпоинт по адресу http://127.0.0.1:8000/mcp

• удобные эндпоинты http://127.0.0.1:8000/mcp/tools и http://127.0.0.1:8000/mcp/tools/call

• встроенный мост stdio в scripts/mcp_stdio_bridge.py

Профиль инструментов MCP по умолчанию — curated, который сохраняет интерфейс браузера компактным для лучшего выбора инструментов. Если вам нужен полный набор внутренних инструментов, установите:

MCP_TOOL_PROFILE=full

Пример вызова инструмента:

curl -s http://127.0.0.1:8000/mcp/tools/call \
  -X POST \
  -H 'content-type: application/json' \
  -d '{
    "name":"browser.create_session",
    "arguments":{
      "name":"demo",
      "start_url":"https://example.com"
    }
  }' | jq

Руководства по настройке клиентов:

• docs/mcp-clients.md

• examples/claude-desktop-setup.md

• examples/cursor-mcp-setup.md

• examples/claude_desktop_config.json

Безопасность и соответствие требованиям

Для реального частного развертывания установите как минимум:

APP_ENV=production
API_BEARER_TOKEN=<strong-random-secret>
REQUIRE_OPERATOR_ID=true
AUTH_STATE_ENCRYPTION_KEY=<44-char-fernet-key>
REQUIRE_AUTH_STATE_ENCRYPTION=true
REQUEST_RATE_LIMIT_ENABLED=true
METRICS_ENABLED=true

COMPLIANCE_TEMPLATE может применить предварительно настроенную политику при запуске:

Все шаблоны требуют одобрения загрузок. HIPAA, SOC2 и PCI-DSS также включают квитанции Witness. При запуске примененная политика записывается в /data/compliance-manifest.json.

Пример:

COMPLIANCE_TEMPLATE=HIPAA docker compose up

Подробности развертывания, размещенные заметки Witness, режимы аутентификации CLI и руководство по reverse-SSH см. в:

• docs/deployment.md

• docs/production-hardening.md

Обзор архитектуры

flowchart LR
    User[Human operator] -->|watch / takeover| noVNC[noVNC]
    LLM[OpenAI / Claude / Gemini] -->|shared tools| Controller[Controller API]
    Controller -->|Playwright protocol| Browser[Browser node]
    noVNC --> Browser
    Browser --> Artifacts[(screenshots / traces / auth state)]
    Controller --> Artifacts
    Controller --> Policy[Allowlist + approval gates]

Основные компоненты:

• browser-node/ запускает Chromium, Xvfb, x11vnc и noVNC

• controller/ предоставляет контроллер FastAPI, транспорт MCP, политики и эндпоинты оркестрации

• data/ хранит артефакты выполнения, состояние аутентификации, одобрения, журналы аудита и опциональные кэши CLI

• scripts/ содержит локальные вспомогательные скрипты для проверки готовности, дымовых тестов, мостов и проверок релиза

Руководство по репозиторию

Общие команды

Карта документации

Участие в разработке

Если вы хотите помочь, начните с:

• CONTRIBUTING.md

• docs/good-first-issues.md

• CODE_OF_CONDUCT.md

Если Auto Browser оказался полезным, звезда поможет другим людям найти его.