Saltar al contenido principal
Local Agent Browser CLI ahora forma parte de Agent Browser CLI. El paquete npm gologin-local-agent-browser-cli está obsoleto: instala gologin-agent-browser-cli y usa --runtime local. Los scripts que llaman a gologin-local-agent-browser siguen funcionando, consulta Migrar desde Local Agent Browser CLI.
Agent Browser CLI tiene dos runtimes con los mismos comandos. El runtime cloud ejecuta las sesiones en Gologin Cloud Browser. El runtime local las ejecuta en Orbita, el navegador de Gologin, en tu propio equipo. Esta página trata sobre el runtime local. Los snapshots, las refs y el resto de comandos funcionan como se describe en la página de Agent Browser CLI.

Cuándo usar local y cuándo cloud


Requisitos

  • Node.js 20 o posterior. El runtime local inicia Orbita mediante el SDK de Node.js de Gologin, que requiere Node.js 20.
  • Un token de la API de Gologin en GOLOGIN_TOKEN. Consulta Obtener un token.
  • Un ID de perfil para cada sesión. A diferencia del runtime cloud, el runtime local no crea perfiles temporales.
  • Orbita. Si aún no está instalado, el SDK de Gologin lo descarga en ~/.gologin/browser en el primer inicio. Si Orbita está en otra ubicación, define GOLOGIN_EXECUTABLE_PATH.

Instalación

El paquete instala dos comandos:
  • gologin-agent-browser ejecuta las sesiones de navegador en la nube, a menos que elijas local.
  • gologin-local-agent-browser es un alias de compatibilidad que ejecuta los comandos en el runtime local.

Elegir el runtime local

Pasa --runtime local a un comando, o define el runtime una sola vez para toda la shell:
--local y un local al principio también funcionan: gologin-agent-browser local open https://example.com --profile your_profile_id.
Los comandos de sesión como snapshot, click y close van al runtime cloud a menos que elijas local. Después de abrir una sesión local, pasa --runtime local a cada comando siguiente, o define GOLOGIN_AGENT_BROWSER_RUNTIME=local.
Los comandos de la API de Gologin como api, browser y proxy siempre llaman directamente a la API, sea cual sea el runtime.

Variables de entorno

El runtime local guarda su configuración, la lista de perfiles y el historial de trabajos en ~/.gologin-local-agent-browser/, la misma carpeta que usaba la CLI anterior.

Inicio rápido

--visible (o --headed) y --headless (o --background) eligen el modo de ventana para un solo open. open-visible y open-background son atajos para ellos.

Comandos de navegador

Los comandos de sesión son los mismos que en el runtime cloud: snapshot, click, type, fill, find, wait, press, scroll, tabs, cookies, storage-export, eval, screenshot, pdf, upload y más. Consulta la referencia de comandos. Por ahora, back, forward y reload solo funcionan en el runtime cloud. find localiza un elemento en la página activa y actúa sobre él en un solo paso. Úsalo cuando las refs queden obsoletas en páginas dinámicas:

Comandos de perfil

Estos comandos se ejecutan en el runtime local incluso sin --runtime local: profile-create y profile-update aceptan una plantilla según el caso de uso y un proxy. --proxy-country us añade un proxy de Gologin; --proxy-host junto con --proxy-port define el tuyo.

Runbooks y trabajos por lotes

Un runbook es un archivo JSON con una lista de pasos de la CLI:
Ejecútalo en un perfil, o en muchos perfiles en paralelo:
targets.json lista los perfiles:
Consulta los resultados con jobs y job <jobId>. --status acepta running, ok, partial o failed:

Migrar desde Local Agent Browser CLI

  • Los scripts que llaman a gologin-local-agent-browser siguen funcionando. El comando ahora procede de gologin-agent-browser-cli.
  • Los perfiles, la configuración y el historial de trabajos en ~/.gologin-local-agent-browser/ se mantienen donde están.
  • Para agentes de IA, instala la skill de Agent Browser. Cubre ambos runtimes, y la skill independiente de Local Agent Browser está obsoleta.

Relacionado

Paquete npm

gologin-agent-browser-cli

Código fuente

GologinLabs/agent-browser