Execução na nuvem ou local
A CLI tem dois ambientes de execução com os mesmos comandos. Ambos usam perfis, fingerprints e proxies do Gologin, e um daemon mantém as sessões ativas entre as chamadas da CLI.
Escolha o ambiente de execução por comando com
--runtime cloud|local|auto, ou defina GOLOGIN_AGENT_BROWSER_RUNTIME uma única vez:
auto), os comandos de perfil, runbook e job rodam localmente e todo o resto roda na nuvem. Depois de abrir uma sessão local, passe --runtime local também aos comandos seguintes. Consulte Ambiente local para ver os requisitos e os comandos exclusivos do modo local.
Instalação
Credenciais
Obtenha um token
- Cadastre-se ou faça login em gologin.com
- Abra API & MCP no painel
- Abra a aba API
- Clique em Novo Token
- Copie o token de acesso gerado
Arquivo de configuração
~/.gologin-agent-browser/config.json
Arquitetura
Duas partes:- CLI
gologin-agent-browser— interpreta os comandos, escolhe o ambiente de execução, inicia automaticamente o daemon correspondente e imprime uma saída compacta - Daemons locais persistentes, um por ambiente de execução — controlam as sessões ativas do navegador, conectam-se ao Gologin Cloud Browser ou ao Orbita local por meio do
connectOverCDPdo Playwright, mantêm a página ativa na memória, geram snapshots, resolvem refs e acompanham os metadados da sessão
- Socket Unix em
${TMPDIR:-/tmp}/gologin-agent-browser.sock - HTTP em localhost, em
127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777}
Como funcionam as refs
Osnapshot imprime uma visão compacta da página e atribui refs como @e1, @e2, @e3 aos elementos interativos. Você age diretamente sobre elas:
find costuma ser uma alternativa melhor do que refs desatualizadas: ele localiza o elemento na página ativa e age sobre ele em uma única etapa.
Início rápido
Exemplo de loop de agente
Um loop típico de agente de IA:Referência completa de comandos
Diagnóstico
Gerenciamento de sessões
Leitura da página
Interação
Teclado e rolagem
Navegação
Abas
Cookies e armazenamento
Avançado
Perfis, proxies e a API do Gologin
Estes comandos chamam a API do Gologin com o seu token e não precisam do daemon do navegador.--help a qualquer comando para exibir seu modo de uso.
Somente no ambiente local
profiles, profile, profile-create, profile-update, profile-import, profile-sync, profile-delete, run, batch, jobs e job gerenciam perfis locais, runbooks e o histórico de jobs. Consulte Ambiente local.
Aliases
Casos de uso e exemplos
Verifique se o seu site passa nos testes anti-detect
Faça login em um aplicativo web e extraia dados do painel
Preencha um formulário de várias etapas
Tire capturas de tela de páginas de concorrentes
Pesquise em um site que bloqueia scraping
Alguns sites exigem execução de JavaScript, login ou interação antes de mostrar os resultados. Use o navegador para pesquisar:Salve e restaure o estado da sessão
Exporte cookies e armazenamento para reutilizá-los entre sessões:Sessões paralelas
Use IDs--session explícitos para tarefas independentes na nuvem. Faça a limpeza com close --all ou sessions --prune --older-than-ms.
Regras de proxy
- Perfis pré-configurados: o proxy é definido no perfil pelo painel do Gologin ou pela API, por exemplo
proxy add-gologin <profileId> --country us - Perfis temporários na nuvem: sem proxy, ou com o seu próprio proxy usando
--proxy-hoste--proxy-port(além de--proxy-mode http|socks4|socks5,--proxy-user,--proxy-pass) - No ambiente de nuvem, o
opennão aceita--proxy-country. Para usar tráfego de proxy do Gologin de um país, adicione um proxy do Gologin a um perfil e abra-o com--profile - No ambiente local,
open,profile-createeprofile-updateaceitam--proxy-country
Veja também
- Gologin Web Access CLI — CLI unificada (scraping + navegador)
- Ambiente local — execute perfis locais do Orbita com esta CLI
- Primeiros passos com o Cloud Browser — exemplos com Puppeteer/Playwright
- AI Skills — skills prontas para usar com o Claude Code
Pacote npm
gologin-agent-browser-cli
Código-fonte
GologinLabs/agent-browser