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
- Se o plugin
ChromeouChrome [Internal]do Codex puder ser chamado na sessão atual, use sua skill integrada de controle do Chrome. - Caso contrário, use a rota
chrome-devtoolsdo 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.