Перейти к основному содержанию
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.
В Agent Browser CLI есть два runtime с одинаковыми командами. Runtime 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.
Команды сессии, такие как snapshot, click и close, выполняются в облачном runtime, если вы не выбрали локальный. После открытия локальной сессии добавляйте --runtime local ко всем следующим командам или задайте GOLOGIN_AGENT_BROWSER_RUNTIME=local.
Команды 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