CommunityImagemgithub.com

steipete/browser-use

Automação do Chrome existente: plugin Chrome primeiro, fallback mcporter.

O que é browser-use?

Esta skill permite que agentes de IA (como Codex) controlem uma sessão ativa do Chrome, utilizando o perfil e login existentes do usuário. Ela prioriza o uso do mecanismo 'Chrome plugin' interno do Codex, mas recorre ao `mcporter` para comandos Chrome DevTools quando o plugin não está disponível. O objetivo principal é evitar navegadores isolados, que frequentemente falham em sites com login, devido a CAPTCHAs ou falta de estado SSO. A skill fornece comandos para listar abas, navegar, clicar, preencher formulários e executar JavaScript, sempre usando a sessão real do Chrome. Também inclui recuperação de prompts de permissão do Chrome (Allow remote debugging) usando a ferramenta Peekaboo, e trata erros como `DevToolsActivePort` com reinicialização controlada do daemon.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/browser-use

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Uso do Navegador

Use esta skill para tarefas de navegador na sessão Chrome existente.

Detalhes de reparo de configuração estão em mcporter-config.md.

Rota

  1. Se o plugin Chrome ou Chrome [Internal] do Codex puder ser chamado na sessão atual, use sua skill integrada de controle do Chrome.
  2. Caso contrário, use a rota chrome-devtools do mcporter descrita abaixo.

Estar empacotado ou instalado no disco não significa que está disponível; o plugin precisa ser chamável na sessão ativa. Ambas as rotas devem usar o perfil Chrome existente do usuário.

Para o fallback do mcporter, use este destino:

mcporter call chrome-devtools.<tool>

A maioria dos sites com login pesado falha em perfis isolados porque novas sessões disparam captcha, verificações de dispositivo ou estado SSO/extensão ausente. Prefira fortemente o perfil Chrome existente para qualquer site que precise de login.

Nunca use chrome-isolated, Playwright, Puppeteer, o navegador interno do Codex, AppleScript, osascript, script de GUI ou open do macOS para controle de navegador, a menos que o usuário peça explicitamente um navegador isolado/novo.

Bugs de screenshot/UI ao vivo exigem este caminho do Chrome existente. curl, inspeção de código-fonte, testes smoke do Worker ou Playwright local são apenas provas de suporte; não os trate como equivalentes quando o usuário mostrou um problema de navegador renderizado ou a página pode depender de estado de login/perfil.

Verificar MCP

mcporter list chrome-devtools --schema
mcporter call chrome-devtools.list_pages --args '{}' --output text

list_pages deve mostrar as abas abertas reais do usuário. Se mostrar um Chrome isolado em branco/padrão, pare e informe que a reconexão falhou.

Se a chamada parecer travar enquanto o Chrome mostra um prompt de autenticação/conexão/atualização, lide com o alerta de anexação antes de fazer fallback. Prefira Peekaboo para pressionar um botão Allow explícito do Chrome quando visível; caso contrário, aguarde o humano. Não reinicie daemons nem mate processos MCP só porque a primeira saída é lenta.

Recuperação testada de prompt de anexação:

PB="${PEEKABOO_BIN:-$HOME/bin/peekaboo}"
[ -x "$PB" ] || PB="$(command -v peekaboo)"
"$PB" permissions status --json
"$PB" see --app frontmost --path /tmp/chrome-attach.png --json --annotate
# Se a UI mostrar o Chrome "Allow remote debugging?", clique apenas no botão Allow visível.
"$PB" click --coords <allow_x>,<allow_y> --json
mcporter call chrome-devtools.list_pages --args '{}' --output text

Use coordenadas do snapshot atual do Peekaboo, não de anotações antigas. Sucesso significa que list_pages retorna as abas reais do Chrome do usuário.

Regra de alerta de anexação: quando o snapshot atual mostrar claramente o Chrome pedindo para permitir anexação DevTools/MCP/automação de navegador, clique no botão Allow visível uma vez e depois execute novamente list_pages. Se o botão não estiver visível ou o prompt for ambíguo, pare e pergunte; não mude silenciosamente para Playwright/Puppeteer.

Se list_pages falhar com DevToolsActivePort, peça ao usuário para reiniciar o Chrome ou a ponte DevTools e tente novamente uma vez:

mcporter daemon restart
mcporter call chrome-devtools.list_pages --args '{}' --output text

Se ainda falhar, pare e informe que o Chrome DevTools MCP não está disponível. Não use AppleScript.

Evite loops de recuperação ruidosos. Reinicializações repetidas de MCP/navegador podem disparar prompts de reconexão/login e alertas. Tente uma vez, depois pause e escolha um caminho mais silencioso.

Fluxo Típico

# pegar o id da página de list_pages
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text

# inspecionar página
mcporter call chrome-devtools.take_snapshot --args '{}' --output text

# navegar na página selecionada
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text

# clicar em um uid de elemento do snapshot mais recente
mcporter call chrome-devtools.click --args '{"uid":"1_38","includeSnapshot":true}' --output text

# digitar/preencher
mcporter call chrome-devtools.fill --args '{"uid":"1_13","value":"text","includeSnapshot":true}' --output text

# executar JS, manter segredos fora da saída
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.title"}' --output json

Use take_snapshot antes das ações e use apenas valores uid atuais. Evite take_screenshot a menos que o layout visual seja importante.

Prova de UI ao Vivo

Para regressões de screenshot, verificações de dashboard implantado ou qualquer coisa onde o navegador renderizado é o bug:

mcporter call chrome-devtools.list_pages --args '{}' --output text
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text
mcporter call chrome-devtools.take_snapshot --args '{}' --output text
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.body.innerText"}' --output json

Use o conjunto de abas existente com login/perfil carregado. Se a automação do navegador estiver indisponível, relate isso como uma lacuna de verificação em vez de substituir por ferramentas de navegador isolado.

Manuseio de Segredos

Nunca imprima tokens/senhas do DOM da página, logs de rede ou inputs. Para verificações de token, retorne apenas a forma: presente/ausente, comprimento, código de status, nome da conta/organização.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Habilidades Relacionadas