Pulse
ae39e45460
NOVAS SKILLS: - next-best-practices v0.1.0 (CLEAN) — Next.js App Router, RSC, caching, data - nextjs-patterns v1.0.0 (CLEAN) — Next.js 15: Server Actions, route handlers - vite v1.0.0 (CLEAN) — env vars, aliases, proxy, CJS compat - uncle-bob v1.0.0 (CLEAN) — Clean Code, SOLID, Clean Architecture - clean-code-review v1.0.0 (CLEAN) — naming, guard clauses, anti-patterns, refactoring - vue v1.0.0 (CLEAN) — Vue framework - vue-composition-api-best-practices v1.0.0 (CLEAN) — composables, Pinia, reactivity BIBLIOTECA INTELIGENTE libs/ (10 dominios, 11 arquivos): - typescript/ — TS safe + generics gotchas - react/ — Next.js App Router + Vite config - vue/ — Composition API + Pinia - linux/ — System diagnostic cheatsheet - database/ — PostgreSQL + MySQL patterns - browser/ — Chromium CLI + E2E testing - security/ — SAST audit (OWASP Top 10) - best-practices/ — Clean Code + SOLID + Clean Architecture - deploy/ — Docker multi-stack + OpenClaw ops - + INDEX.md como guia de navegacao .learnings/ — LRN-20260519-003 criado (biblioteca compartilhada)
2.5 KiB
2.5 KiB
Browser Automation — Chromium CLI (agent-browser)
CLI headless Chromium para navegação, login, raspagem e screenshots.
Fluxo Padrão
agent-browser open https://exemplo.com/form
agent-browser snapshot -i # Descobre elementos → @e1, @e2, @e3
agent-browser fill @e1 "user@exemplo.com"
agent-browser fill @e2 "senha123"
agent-browser click @e3
agent-browser wait --load networkidle
agent-browser snapshot -i # Re-snapshot após mudança de DOM
Comandos Essenciais
# Navegação
agent-browser open <url>
agent-browser close
# Snapshot (sempre primeiro)
agent-browser snapshot -i # Elementos interativos + @refs
agent-browser snapshot -i -C # + cursor-interactive elements
# Interação com @refs
agent-browser click @e1
agent-browser fill @e2 "text" # Clear + type
agent-browser type @e2 "text" # Type sem limpar
agent-browser select @e1 "option"
agent-browser check @e1
agent-browser press Enter
agent-browser scroll down 500
agent-browser hover @e1
# Extração
agent-browser get text @e1
agent-browser get text body > page.txt
agent-browser get html @e1
agent-browser get url
agent-browser get title
# Espera
agent-browser wait @e1
agent-browser wait --load networkidle
agent-browser wait --url "**/dashboard"
# Captura
agent-browser screenshot page.png
agent-browser screenshot --full # Página inteira
agent-browser pdf relatorio.pdf
# Download
agent-browser download @e1 ./file.pdf
agent-browser wait --download ./output.zip
🔐 Login + Persistência de Sessão
# Login
agent-browser open https://app.exemplo.com/login
agent-browser fill @e1 "$USERNAME" && agent-browser fill @e2 "$PASSWORD"
agent-browser click @e3
agent-browser wait --url "**/dashboard"
agent-browser state save ~/auth.json # Salva cookies + sessão
# Reutilizar
agent-browser state load ~/auth.json
agent-browser open https://app.exemplo.com/dashboard
🔒 Segurança (ambiente)
export AGENT_BROWSER_ALLOWED_DOMAINS="exemplo.com"
export AGENT_BROWSER_MAX_OUTPUT=50000
export AGENT_BROWSER_CONTENT_BOUNDARIES=1
⚠️ Ref Lifecycle
Refs (
@e1,@e2) são invalidados após qualquer mudança de DOM. Sempre façasnapshot -ide novo após:
- Cliques que navegam
- Submissão de formulário
- Conteúdo dinâmico (dropdowns, modais)
Sessões Paralelas
agent-browser --session site1 open https://site-a.com
agent-browser --session site2 open https://site-b.com
agent-browser session list