Local Agent Browser CLI теперь входит в Agent Browser CLI. Пакет npm
gologin-local-agent-browser-cli устарел: установите gologin-agent-browser-cli и используйте --runtime local. Скрипты, которые вызывают gologin-local-agent-browser, продолжат работать, см. Переход с Local Agent Browser CLI.cloud запускает сессии в Gologin Cloud Browser. Runtime local запускает их в Orbita, браузере Gologin, на вашем компьютере. На этой странице описан локальный runtime. Снимки страницы (snapshots), ссылки (refs) и остальные команды работают так, как описано на странице Agent Browser CLI.
Когда использовать local, а когда cloud
Требования
- Node.js 20 или новее. Локальный runtime запускает Orbita через Gologin Node.js SDK, которому нужен Node.js 20.
- Токен Gologin API в переменной
GOLOGIN_TOKEN. См. Получение токена. - ID профиля для каждой сессии. В отличие от облачного runtime, локальный не создаёт временные профили.
- Orbita. Если он ещё не установлен, Gologin SDK скачает его в
~/.gologin/browserпри первом запуске. Если Orbita находится в другом месте, задайтеGOLOGIN_EXECUTABLE_PATH.
Установка
gologin-agent-browserзапускает сессии браузера в облаке, если вы не выберете локальный runtime.gologin-local-agent-browser— псевдоним для совместимости, он выполняет команды в локальном runtime.
Выбор локального runtime
Добавьте--runtime local к команде или задайте runtime один раз для всей оболочки:
--local и слово local в начале команды: gologin-agent-browser local open https://example.com --profile your_profile_id.
Команды Gologin API, такие как
api, browser и proxy, всегда обращаются к API напрямую, независимо от runtime.
Переменные окружения
Локальный runtime хранит конфигурацию, список профилей и историю задач в
~/.gologin-local-agent-browser/ — в той же папке, которую использовал прежний CLI.
Быстрый старт
--visible (или --headed) и --headless (или --background) задают режим окна для одной команды open. open-visible и open-background — их сокращённые варианты.
Команды браузера
Команды сессии такие же, как в облачном runtime:snapshot, click, type, fill, find, wait, press, scroll, tabs, cookies, storage-export, eval, screenshot, pdf, upload и другие. См. справочник команд. Команды back, forward и reload пока работают только в облачном runtime.
find находит элемент на открытой странице и сразу выполняет с ним действие. Используйте её, когда ссылки (refs) устаревают на динамических страницах:
Команды профилей
Эти команды выполняются в локальном runtime даже без--runtime local:
profile-create и profile-update принимают шаблон для сценария использования и прокси. --proxy-country us добавляет прокси Gologin, а --proxy-host вместе с --proxy-port задаёт ваш собственный.
Ранбуки и пакетные задачи
Ранбук — это JSON-файл со списком шагов CLI:targets.json перечислены профили:
jobs и job <jobId>. Параметр --status принимает значения running, ok, partial или failed:
Переход с Local Agent Browser CLI
- Скрипты, которые вызывают
gologin-local-agent-browser, продолжат работать. Теперь эта команда устанавливается изgologin-agent-browser-cli. - Профили, конфигурация и история задач в
~/.gologin-local-agent-browser/остаются на месте. - Для ИИ-агентов установите навык Agent Browser. Он охватывает оба runtime, а отдельный навык Local Agent Browser устарел.
Связанные материалы
- Agent Browser CLI — полный справочник команд и облачный runtime
- Gologin Web Access CLI — скрейпинг и команды браузера в одном CLI
- AI Skills — навыки для Claude Code и других агентов
- Node.js SDK — запуск профилей из вашего кода
Пакет npm
gologin-agent-browser-cli
Исходный код
GologinLabs/agent-browser