Saltar al contenido principal
Gologin Agent Browser CLI convierte los perfiles de navegador de Gologin en un entorno de ejecución persistente y programable para agentes de IA. Las sesiones se ejecutan en Gologin Cloud Browser o en Orbita en tu propio equipo. Ofrece snapshots compactos de la página, interacción basada en refs, memoria de sesión y una salida pensada para la terminal. A diferencia de escribir código de Puppeteer/Playwright desde cero, esta CLI da a los agentes un conjunto de comandos listo para usar en la automatización del navegador, sin código repetitivo ni lógica de gestión de sesiones.

Entorno de ejecución en la nube o local

La CLI tiene dos entornos de ejecución con los mismos comandos. Ambos usan perfiles, fingerprints y proxies de Gologin, y un daemon mantiene las sesiones activas entre llamadas a la CLI. Elige el entorno de ejecución en cada comando con --runtime cloud|local|auto, o define GOLOGIN_AGENT_BROWSER_RUNTIME una sola vez:
De forma predeterminada (auto), los comandos de perfiles, runbooks y trabajos se ejecutan en local, y todo lo demás se ejecuta en la nube. Una vez que abras una sesión local, indica también --runtime local en los comandos siguientes. Consulta Local runtime para ver los requisitos y los comandos exclusivos del entorno local.

Instalación

O ejecútala sin instalación global:
Requiere Node.js >= 18. El entorno de ejecución local necesita Node.js 20 o posterior.

Credenciales

Obtener un token

  1. Regístrate o inicia sesión en gologin.com
  2. Abre API & MCP en el panel
  3. Abre la pestaña API
  4. Haz clic en New Token
  5. Copia el token de acceso generado

Archivo de configuración

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

Arquitectura

Consta de dos partes:
  1. La CLI gologin-agent-browser: interpreta los comandos, elige el entorno de ejecución, inicia automáticamente el daemon correspondiente e imprime una salida compacta
  2. Daemons locales persistentes, uno por cada entorno de ejecución: gestionan las sesiones de navegador activas, se conectan a Gologin Cloud Browser o a Orbita local mediante connectOverCDP de Playwright, mantienen la página activa en memoria, generan snapshots, resuelven refs y registran los metadatos de la sesión
El transporte es solo local. El daemon de cloud escucha en:
  • Un socket Unix en ${TMPDIR:-/tmp}/gologin-agent-browser.sock
  • HTTP local en 127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777}
En el entorno de ejecución cloud, si no indicas un ID de perfil, el daemon crea un perfil temporal de Gologin en la nube a través de la API.

Cómo funcionan los refs

snapshot imprime una vista compacta de la página y asigna refs como @e1, @e2, @e3 a los elementos interactivos. Puedes actuar directamente sobre ellos:
Los refs funcionan con el mejor esfuerzo y conviene regenerarlos tras navegar o después de cambios importantes en el DOM. Los comandos también aceptan selectores CSS en lugar de refs. En páginas dinámicas, find suele ser una mejor alternativa que los refs obsoletos: localiza el elemento en la página activa y actúa sobre él en un solo paso.

Inicio rápido


Ejemplo de bucle de un agente

Un bucle típico de un agente de IA:

Referencia completa de comandos

Diagnóstico

Gestión de sesiones

Lectura de la página

Interacción

Teclado y desplazamiento

Pestañas

Cookies y almacenamiento

Avanzado

Perfiles, proxies y la API de Gologin

Estos comandos llaman a la API de Gologin con tu token y no necesitan el daemon del navegador.
Añade --help a cualquier comando para ver cómo se usa.

Solo entorno de ejecución local

profiles, profile, profile-create, profile-update, profile-import, profile-sync, profile-delete, run, batch, jobs y job gestionan perfiles locales, runbooks y el historial de trabajos. Consulta Local runtime.

Alias


Casos de uso y ejemplos

Comprueba si tu sitio supera las pruebas anti-detección

Inicia sesión en una aplicación web y extrae datos del panel

Rellena un formulario de varios pasos

Captura pantallas de las páginas de la competencia

Busca en un sitio que bloquea el scraping

Algunos sitios exigen ejecutar JavaScript, iniciar sesión o interactuar antes de mostrar resultados. Usa el navegador para buscar:

Guarda y restaura el estado de la sesión

Exporta las cookies y el almacenamiento para reutilizarlos entre sesiones:

Sesiones en paralelo

Usa IDs de --session explícitos para tareas independientes en la nube. Limpia con close --all o sessions --prune --older-than-ms.

Reglas de proxy

  • Perfiles preconfigurados: el proxy se define en el perfil desde el panel de Gologin o la API, por ejemplo proxy add-gologin <profileId> --country us
  • Perfiles temporales en la nube: sin proxy, o con tu propio proxy mediante --proxy-host y --proxy-port (además de --proxy-mode http|socks4|socks5, --proxy-user, --proxy-pass)
  • En el entorno de ejecución cloud, open no acepta --proxy-country. Para usar tráfico de proxy de Gologin de un país, añade un proxy de Gologin a un perfil y ábrelo con --profile
  • En el entorno de ejecución local, open, profile-create y profile-update aceptan --proxy-country

Relacionado

Paquete de npm

gologin-agent-browser-cli

Código fuente

GologinLabs/agent-browser