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:
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
Credenciales
Obtener un token
- Regístrate o inicia sesión en gologin.com
- Abre API & MCP en el panel
- Abre la pestaña API
- Haz clic en New Token
- Copia el token de acceso generado
Archivo de configuración
~/.gologin-agent-browser/config.json
Arquitectura
Consta de dos partes:- 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 - 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
connectOverCDPde Playwright, mantienen la página activa en memoria, generan snapshots, resuelven refs y registran los metadatos de la sesión
- Un socket Unix en
${TMPDIR:-/tmp}/gologin-agent-browser.sock - HTTP local en
127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777}
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:
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
Navegación
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.--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-hosty--proxy-port(además de--proxy-mode http|socks4|socks5,--proxy-user,--proxy-pass) - En el entorno de ejecución cloud,
openno 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-createyprofile-updateaceptan--proxy-country
Relacionado
- Gologin Web Access CLI — CLI unificada (scraping + navegador)
- Local runtime — ejecuta perfiles locales de Orbita con esta CLI
- Cloud Browser Getting Started — ejemplos de Puppeteer/Playwright
- AI Skills — skills listas para usar con Claude Code
Paquete de npm
gologin-agent-browser-cli
Código fuente
GologinLabs/agent-browser