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.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/browseren el primer inicio. Si Orbita está en otra ubicación, defineGOLOGIN_EXECUTABLE_PATH.
Instalación
gologin-agent-browserejecuta las sesiones de navegador en la nube, a menos que elijas local.gologin-local-agent-browseres 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 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:targets.json lista los perfiles:
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-browsersiguen funcionando. El comando ahora procede degologin-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
- Agent Browser CLI — referencia completa de comandos y el runtime cloud
- Gologin Web Access CLI — comandos de scraping y de navegador en una sola CLI
- AI Skills — skills para Claude Code y otros agentes
- Node.js SDK — ejecuta perfiles desde tu propio código
Paquete npm
gologin-agent-browser-cli
Código fuente
GologinLabs/agent-browser