- Web Unlocker — leitura e extração sem estado. Ideal quando você quer o conteúdo de uma página rapidamente, sem manter uma sessão de navegador.
- Navegador na nuvem — interação com estado. Ideal quando você precisa de navegação, cliques, digitação, capturas de tela ou fluxos de várias etapas que persistem entre comandos.
Instalação
Credenciais
Duas credenciais diferentes da Gologin habilitam os dois modos:Arquivo de configuração
Armazene as credenciais em~/.gologin-web-access/config.json:
config init. O comando não é interativo: passe as chaves como flags ou ele as obtém das variáveis de ambiente acima. Em seguida, ele valida as chaves nas APIs da Gologin:
--no-validate para pular a validação das chaves. Se o arquivo de configuração já existir, o config init o mantém como está, a menos que você adicione --force.
Início rápido — ler uma página
Início rápido — interagir com um site
Referência de comandos — scraping / leitura
Esses comandos usam o Web Unlocker. Eles não têm estado — nenhuma sessão de navegador é mantida.Página única
Opções comuns:
--format text|markdown|html, --source auto|unlocker|browser, --fallback none|browser
Operações em lote
Opções de lote:
--format, --source, --only-main-content, --retry <n>, --backoff-ms <ms>, --summary, --output <path>, --strict
Por padrão, o batch-scrape retorna código de saída 0 em caso de sucesso parcial. Adicione --strict para falhar diante de qualquer erro.
Busca e descoberta
Opções:
--limit <n>, --max-depth <n>, --concurrency <n>, --only-main-content
Jobs de crawl assíncronos
Monitoramento de alterações
Runbooks
Referência de comandos — navegador / interação
Esses comandos usam o Navegador na nuvem. Eles mantêm uma sessão com estado por meio de um daemon local.Gerenciamento de sessões
Opções:
--profile <id> para usar um perfil específico da Gologin.
Leitura de páginas
Interação
Navegação
Abas
Cookies e armazenamento
Avançado
Casos de uso e exemplos
Fazer scraping da página de preços de um concorrente
nextActionHint sugere mudar para o modo navegador.
Criar um corpus de pesquisa a partir de um site de documentação
Monitorar alterações em páginas
Extrair dados estruturados com um esquema
Defina o que você quer extrair. O esquema associa cada campo de saída a um seletor CSS:selector— seletor CSStype—text(padrão),html,attrouexistsattribute— nome do atributo quandotypeéattrall—trueretorna todas as correspondências como uma listafields— um esquema aninhado aplicado dentro de cada correspondência
batch-extract.
Pesquisar na web e fazer scraping dos resultados
Fazer login em um site e interagir
Quando o scraping não basta — e você precisa clicar, digitar e navegar:Analisar documentos locais
Não só páginas da web — analise PDFs, documentos do Word e planilhas do Excel:Automatizar fluxos de várias etapas com runbooks
Defina uma sequência de etapas em JSON e reproduza-a:Roteamento de origem
Os comandos que aceitam--source podem passar por diferentes backends:
Saída estruturada
Oscrape-json retorna metadados completos, incluindo:
title,description,headings,headingsByLevel,links- Classificação do resultado:
ok,empty,incomplete,authwall,challenge,blocked,cookie_wall nextActionHint— próximo passo sugerido quando a página não está totalmente acessível
search retorna requestedLimit, returnedCount, warnings, cacheTtlMs e a position de cada resultado.
Veja também
- SDK do Web Unlocker — SDK em TypeScript para uso programático
- O que é o Web Unlocker — visão geral do produto
- CLI do Agent Browser — CLI somente de navegador para agentes de IA
- Runtime local — CLI do Agent Browser com perfis locais do Orbita
- Skills de IA — skills prontas para uso no Claude Code
Pacote npm
gologin-web-access
Código-fonte
GologinLabs/gologin-web-access