Облачная или локальная среда выполнения
В CLI есть две среды выполнения с одинаковыми командами. Обе используют профили, отпечатки и прокси Gologin, а демон поддерживает сессии активными между вызовами CLI.
Выбирайте среду выполнения для каждой команды с помощью
--runtime cloud|local|auto или один раз задайте GOLOGIN_AGENT_BROWSER_RUNTIME:
auto) команды для профилей, ранбуков и задач выполняются локально, а все остальные — в облаке. После открытия локальной сессии передавайте --runtime local и в следующие команды. Требования и команды, доступные только в локальной среде, описаны в разделе Локальная среда выполнения.
Установка
Учётные данные
Получение токена
- Зарегистрируйтесь или войдите на gologin.com
- Откройте раздел API & MCP в личном кабинете
- Перейдите на вкладку API
- Нажмите Новый токен
- Скопируйте созданный токен доступа
Файл конфигурации
~/.gologin-agent-browser/config.json
Архитектура
Система состоит из двух частей:- CLI
gologin-agent-browser— разбирает команды, выбирает среду выполнения, автоматически запускает соответствующий демон и выводит компактный результат - Постоянные локальные демоны, по одному на каждую среду выполнения — управляют активными сессиями браузера, подключаются к Gologin Cloud Browser или локальной Orbita через Playwright
connectOverCDP, хранят активную страницу в памяти, создают снимки, разрешают refs и отслеживают метаданные сессий
- Unix-сокет
${TMPDIR:-/tmp}/gologin-agent-browser.sock - Локальный HTTP на
127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777}
Как работают refs
Командаsnapshot выводит компактное представление страницы и назначает интерактивным элементам refs вида @e1, @e2, @e3. С ними можно работать напрямую:
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
См. также
- Gologin Web Access CLI — единый CLI (скрапинг + браузер)
- Локальная среда выполнения — запуск локальных профилей Orbita с помощью этого CLI
- Начало работы с Cloud Browser — примеры для Puppeteer/Playwright
- AI Skills — готовые навыки для Claude Code
Пакет npm
gologin-agent-browser-cli
Исходный код
GologinLabs/agent-browser