- Web Unlocker — lectura y extracción sin estado. Es la mejor opción cuando quieres obtener el contenido de una página rápidamente sin mantener una sesión de navegador.
- Cloud Browser — interacción con estado. Es la mejor opción cuando necesitas navegar, hacer clic, escribir, tomar capturas de pantalla o ejecutar flujos de varios pasos que se mantienen entre comandos.
Instalación
Credenciales
Dos credenciales distintas de Gologin dan acceso a los dos modos:Archivo de configuración
Guarda las credenciales en~/.gologin-web-access/config.json:
config init. Este comando no es interactivo: pasa las claves como flags o las toma de las variables de entorno indicadas arriba. Después, comprueba las claves con las API de Gologin:
--no-validate para omitir la comprobación de las claves. Si el archivo de configuración ya existe, config init lo deja tal como está, a menos que añadas --force.
Inicio rápido — leer una página
Inicio rápido — interactuar con un sitio
Referencia de comandos — scraping / lectura
Estos comandos usan Web Unlocker. No tienen estado: no se mantiene ninguna sesión de navegador.Una sola página
Opciones comunes:
--format text|markdown|html, --source auto|unlocker|browser, --fallback none|browser
Operaciones por lotes
Opciones por lotes:
--format, --source, --only-main-content, --retry <n>, --backoff-ms <ms>, --summary, --output <path>, --strict
De forma predeterminada, batch-scrape devuelve el código de salida 0 si el éxito es parcial. Añade --strict para que falle ante cualquier error.
Búsqueda y descubrimiento
Opciones:
--limit <n>, --max-depth <n>, --concurrency <n>, --only-main-content
Trabajos de rastreo asíncronos
Seguimiento de cambios
Runbooks
Referencia de comandos — navegador / interacción
Estos comandos usan Cloud Browser. Mantienen una sesión con estado a través de un daemon local.Gestión de sesiones
Opciones:
--profile <id> para usar un perfil concreto de Gologin.
Lectura de la página
Interacción
Navegación
Pestañas
Cookies y almacenamiento
Avanzado
Casos de uso y ejemplos
Hacer scraping de la página de precios de un competidor
nextActionHint sugiere cambiar al modo navegador.
Crear un corpus de investigación a partir de un sitio de documentación
Supervisar cambios en páginas
Extraer datos estructurados con un esquema
Define qué quieres extraer. El esquema asigna cada campo de salida a un selector CSS:selector— selector CSStype—text(predeterminado),html,attroexistsattribute— nombre del atributo cuandotypeesattrall—truedevuelve todas las coincidencias como una listafields— un esquema anidado que se aplica dentro de cada coincidencia
batch-extract.
Buscar en la web y hacer scraping de los resultados
Iniciar sesión en un sitio e interactuar
Cuando el scraping no es suficiente y necesitas hacer clic, escribir o navegar:Analizar documentos locales
No solo páginas web: también puedes analizar archivos PDF, documentos de Word y hojas de Excel:Automatizar flujos de varios pasos con runbooks
Define una secuencia de pasos en JSON y reprodúcela:Enrutamiento de origen
Los comandos que admiten--source pueden enrutarse a través de distintos backends:
Salida estructurada
scrape-json devuelve metadatos completos, entre ellos:
title,description,headings,headingsByLevel,links- Clasificación del resultado:
ok,empty,incomplete,authwall,challenge,blocked,cookie_wall nextActionHint— siguiente paso sugerido cuando la página no es totalmente accesible
search devuelve requestedLimit, returnedCount, warnings, cacheTtlMs y la position de cada resultado.
Relacionado
- Web Unlocker SDK — SDK de TypeScript para uso programático
- Qué es Web Unlocker — descripción general del producto
- Agent Browser CLI — CLI solo de navegador para agentes de IA
- Entorno de ejecución local — Agent Browser CLI con perfiles locales de Orbita
- AI Skills — skills listas para usar con Claude Code
Paquete de npm
gologin-web-access
Código fuente
GologinLabs/gologin-web-access