Перейти к основному содержанию
Gologin Agent Browser CLI превращает профили браузера Gologin в постоянную среду выполнения со скриптовым управлением для ИИ-агентов. Сессии запускаются в Gologin Cloud Browser или в Orbita на вашем компьютере. CLI предоставляет компактные снимки страниц, взаимодействие через refs, память сессий и удобный для оболочки вывод. В отличие от написания кода на Puppeteer/Playwright с нуля, этот CLI даёт агентам готовый набор команд для автоматизации браузера — без шаблонного кода и без кода для управления сессиями.

Облачная или локальная среда выполнения

В CLI есть две среды выполнения с одинаковыми командами. Обе используют профили, отпечатки и прокси Gologin, а демон поддерживает сессии активными между вызовами CLI. Выбирайте среду выполнения для каждой команды с помощью --runtime cloud|local|auto или один раз задайте GOLOGIN_AGENT_BROWSER_RUNTIME:
По умолчанию (auto) команды для профилей, ранбуков и задач выполняются локально, а все остальные — в облаке. После открытия локальной сессии передавайте --runtime local и в следующие команды. Требования и команды, доступные только в локальной среде, описаны в разделе Локальная среда выполнения.

Установка

Или запуск без глобальной установки:
Требуется Node.js >= 18. Для локальной среды выполнения нужен Node.js 20 или новее.

Учётные данные

Получение токена

  1. Зарегистрируйтесь или войдите на gologin.com
  2. Откройте раздел API & MCP в личном кабинете
  3. Перейдите на вкладку API
  4. Нажмите Новый токен
  5. Скопируйте созданный токен доступа

Файл конфигурации

~/.gologin-agent-browser/config.json

Архитектура

Система состоит из двух частей:
  1. CLI gologin-agent-browser — разбирает команды, выбирает среду выполнения, автоматически запускает соответствующий демон и выводит компактный результат
  2. Постоянные локальные демоны, по одному на каждую среду выполнения — управляют активными сессиями браузера, подключаются к Gologin Cloud Browser или локальной Orbita через Playwright connectOverCDP, хранят активную страницу в памяти, создают снимки, разрешают refs и отслеживают метаданные сессий
Транспорт только локальный. Облачный демон слушает:
  • Unix-сокет ${TMPDIR:-/tmp}/gologin-agent-browser.sock
  • Локальный HTTP на 127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777}
В облачной среде выполнения, если вы не указали ID профиля, демон создаёт временный облачный профиль Gologin через API.

Как работают refs

Команда snapshot выводит компактное представление страницы и назначает интерактивным элементам refs вида @e1, @e2, @e3. С ними можно работать напрямую:
Refs работают по принципу «наилучшей попытки», поэтому после перехода на другую страницу или существенных изменений DOM их нужно создавать заново. Вместо refs команды также принимают CSS-селекторы. На динамических страницах вместо устаревших refs обычно лучше использовать find: он находит элемент на живой странице и выполняет действие за один шаг.

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


Пример цикла работы агента

Типичный цикл работы ИИ-агента:

Полный справочник команд

Диагностика

Управление сессиями

Чтение страницы

Взаимодействие

Клавиатура и прокрутка

Навигация

Вкладки

Cookies и хранилище

Расширенные возможности

Профили, прокси и API Gologin

Эти команды обращаются к API Gologin с вашим токеном и не требуют демона браузера.
Добавьте --help к любой команде, чтобы вывести справку по её использованию.

Только для локальной среды выполнения

Команды profiles, profile, profile-create, profile-update, profile-import, profile-sync, profile-delete, run, batch, jobs и job управляют локальными профилями, ранбуками и историей задач. См. Локальная среда выполнения.

Псевдонимы


Сценарии использования и примеры

Проверка, проходит ли ваш сайт антидетект-тесты

Вход в веб-приложение и извлечение данных из панели управления

Заполнение многошаговой формы

Скриншоты страниц конкурентов

Поиск на сайте, который блокирует скрапинг

Некоторые сайты требуют выполнения JavaScript, входа в аккаунт или действий пользователя, прежде чем показать результаты. Используйте для поиска браузер:

Сохранение и восстановление состояния сессии

Экспортируйте cookies и хранилище, чтобы использовать их в следующих сессиях:

Параллельные сессии

Для независимых облачных задач используйте явные ID --session. Для очистки применяйте close --all или sessions --prune --older-than-ms.

Правила для прокси

  • Предварительно настроенные профили: прокси задаётся в самом профиле через личный кабинет Gologin или API, например proxy add-gologin <profileId> --country us
  • Временные облачные профили: без прокси или с вашим собственным прокси через --proxy-host и --proxy-port (а также --proxy-mode http|socks4|socks5, --proxy-user, --proxy-pass)
  • В облачной среде выполнения open не принимает --proxy-country. Чтобы использовать трафик прокси Gologin из нужной страны, добавьте прокси Gologin в профиль и откройте его с помощью --profile
  • В локальной среде выполнения open, profile-create и profile-update принимают --proxy-country

См. также

Пакет npm

gologin-agent-browser-cli

Исходный код

GologinLabs/agent-browser