title: Browser Automation description: Control browsers with multiple providers, local Chrome via CDP, or cloud browsers for web interaction, form filling, scraping, and more. sidebar_label: Browser sidebar_position: 5 lang: ru

Автоматизация браузера

Агент Hermes включает в себя полный набор инструментов для автоматизации браузера с несколькими опциями серверной части:

• Облачный режим базы браузера через Browserbase для управляемых облачных браузеров и инструментов защиты от ботов.
• Использовать облачный режим браузера через Использование браузера в качестве альтернативного поставщика облачного браузера.
• Облачный режим Firecrawl через Firecrawl для облачных браузеров со встроенным парсингом.
• Локальный режим Camofox через Camofox для локального просмотра с защитой от обнаружения (подмена отпечатков пальцев на основе Firefox)
• Локальный Chrome через CDP — подключите инструменты браузера к своему экземпляру Chrome с помощью /browser connect.
• Режим локального браузера через интерфейс командной строки agent-browser и локальную установку Chromium.

Во всех режимах агент может перемещаться по веб-сайтам, взаимодействовать с элементами страниц, заполнять формы и извлекать информацию.

Обзор

Страницы представлены в виде деревьев доступности (текстовых снимков), что делает их идеальными для агентов LLM. Интерактивные элементы получают идентификаторы ссылок (например, @e1, @e2), которые агент использует для нажатия и ввода текста.

Ключевые возможности:

• Облачное выполнение с участием нескольких поставщиков — База браузеров, Использование браузера или Firecrawl — локальный браузер не требуется.
• Локальная интеграция с Chrome — подключитесь к работающему Chrome через CDP для практического просмотра.
• Встроенная скрытность — случайные отпечатки пальцев, решение CAPTCHA, резидентные прокси (база браузера)
• Изоляция сеанса — для каждой задачи создается собственный сеанс браузера.
• Автоматическая очистка — неактивные сеансы закрываются по истечении таймаута.
• Анализ зрения — снимок экрана + анализ AI для визуального понимания

Настройка

Облачный режим базы браузера

Чтобы использовать облачные браузеры, управляемые Browserbase, добавьте:

# Add to ~/.hermes/.env
BROWSERBASE_API_KEY=***
BROWSERBASE_PROJECT_ID=your-project-id-here

Получите свои учетные данные на browserbase.com.

Браузер Использовать облачный режим

Чтобы использовать Browser Use в качестве поставщика облачного браузера, добавьте:

# Add to ~/.hermes/.env
BROWSER_USE_API_KEY=***

Получите ключ API на сайте browser-use.com. Использование браузера предоставляет облачный браузер через REST API. Если заданы учетные данные Browserbase и Browser Use, Browserbase имеет приоритет.

Облачный режим Firecrawl

Чтобы использовать Firecrawl в качестве поставщика облачного браузера, добавьте:

# Add to ~/.hermes/.env
FIRECRAWL_API_KEY=fc-***

Получите ключ API на firecrawl.dev. Затем выберите Firecrawl в качестве поставщика браузера:

hermes setup tools
# → Browser Automation → Firecrawl

Дополнительные настройки:

# Self-hosted Firecrawl instance (default: https://api.firecrawl.dev)
FIRECRAWL_API_URL=http://localhost:3002

# Session TTL in seconds (default: 300)
FIRECRAWL_BROWSER_TTL=600

Гибридная маршрутизация: облако для общедоступных URL-адресов, локальная для локальной сети/локального хоста

Когда облачный провайдер настроен, Hermes автоматически создает локальную версию Chromium. для URL-адресов, которые разрешаются в частный адрес, адрес обратной связи или локальную сеть (localhost, 127.0.0.1, 192.168.x.x, 10.x.x.x, 172.16-31.x.x, *.local, *.lan, *.internal, Шлейф IPv6 ::1, локальный канал 169.254.x.x). Публичные URL-адреса продолжают использовать облачный провайдер в том же разговоре.

Это решает распространенный рабочий процесс «Я разрабатываю локально, но использую Browserbase» — агент может сделать снимок экрана вашей информационной панели по адресу http://localhost:3000 AND scrape https://github.com без необходимости переключения провайдера или отключения защиты SSRF. Поставщик облачных услуг никогда не видит частный URL-адрес.

Эта функция включена по умолчанию. Чтобы отключить его (все URL-адреса переходят на настроенный облачный провайдер, как и раньше):

# ~/.hermes/config.yaml
browser:
  cloud_provider: browserbase
  auto_local_for_private_urls: false

Если автоматическая маршрутизация отключена, частные URL-адреса отклоняются с "Blocked: URL targets a private or internal address", если вы также не установите browser.allow_private_urls: true (что позволяет поставщику облачных услуг попробовать их — обычно не работает, поскольку Browserbase и т. д. не могут подключиться к вашей локальной сети).

Требования: локальная коляска использует тот же интерфейс командной строки agent-browser, что и чисто локальная версия. режим, поэтому вам необходимо его установить (hermes setup tools → Browser Automation автоматически устанавливает его). Пост-навигация перенаправляет с общедоступного URL-адреса на частный адрес по-прежнему заблокированы (вы не можете использовать трюк с перенаправлением на внутренний адрес, чтобы достичь вашей локальной сети через общедоступный путь).

Локальный режим Camofox

Camofox — это автономный сервер Node.js, включающий Camoufox (вилка Firefox с подменой отпечатков пальцев C++). Он обеспечивает локальный просмотр с защитой от обнаружения без облачных зависимостей.

# Install and run
git clone https://github.com/jo-inc/camofox-browser && cd camofox-browser
npm install && npm start   # downloads Camoufox (~300MB) on first run

# Or via Docker
docker run -d --network host -e CAMOFOX_PORT=9377 jo-inc/camofox-browser

Затем установите ~/.hermes/.env:

CAMOFOX_URL=http://localhost:9377

Или настройте через hermes tools → Автоматизация браузера → Camofox.

Если установлен CAMOFOX_URL, все инструменты браузера автоматически маршрутизируются через Camofox вместо Browserbase или агента-браузера.

Постоянные сеансы браузера

По умолчанию каждый сеанс Camofox получает случайный идентификатор — файлы cookie и логины не сохраняются после перезапуска агента. Чтобы включить постоянные сеансы браузера, добавьте следующее в ~/.hermes/config.yaml:

browser:
  camofox:
    managed_persistence: true

Затем полностью перезапустите Hermes, чтобы новая конфигурация была принята.

:::предупреждение Вложенный путь имеет значение Гермес читает browser.camofox.managed_persistence, не managed_persistence высшего уровня. Распространенной ошибкой является запись:

# ❌ Wrong — Hermes ignores this
managed_persistence: true

Если флаг установлен на неправильном пути, Hermes автоматически вернется к случайному эфемерному адресу userId, и ваше состояние входа будет потеряно при каждом сеансе.