Browser Use
Utiliza esta skill para tareas de navegador en la sesión de Chrome existente.
Los detalles de reparación de configuración están en mcporter-config.md.
Ruta
- Si el plugin
ChromeoChrome [Internal]de Codex es invocable en la sesión actual, usa su skill integrada de control de Chrome. - De lo contrario, usa la ruta
chrome-devtoolsde mcporter descrita a continuación.
Que esté instalado en disco no significa que esté disponible; el plugin debe ser invocable en la sesión activa. Ambas rutas deben usar el perfil de Chrome existente del usuario.
Para el fallback de mcporter, usa este objetivo:
mcporter call chrome-devtools.<tool>
La mayoría de sitios con inicio de sesión fallan en perfiles aislados porque las sesiones nuevas activan captchas, comprobaciones de dispositivo, o estado SSO/extensión faltante. Prefiere firmemente el perfil de Chrome existente para cualquier sitio web que requiera inicio de sesión.
Nunca uses chrome-isolated, Playwright, Puppeteer, el navegador integrado de Codex, AppleScript, osascript, scripting de GUI, o macOS open para controlar el navegador a menos que el usuario solicite explícitamente un navegador aislado/nuevo.
Los errores de captura de pantalla/UI en vivo requieren esta ruta de Chrome existente. curl, inspección de código fuente, pruebas de humo de Worker, o Playwright local son solo soporte complementario; no los trates como equivalentes cuando el usuario muestra un problema de navegador renderizado o la página puede depender del estado de inicio de sesión/perfil.
Verificar MCP
mcporter list chrome-devtools --schema
mcporter call chrome-devtools.list_pages --args '{}' --output text
list_pages debe mostrar las pestañas abiertas reales del usuario. Si muestra un Chrome aislado en blanco/por defecto, detente e informa que la reconexión falló.
Si la llamada parece colgarse mientras Chrome muestra un aviso de autorización/conexión/actualización, maneja la alerta de conexión antes de recurrir. Prefiere Peekaboo para presionar un botón explícito de Allow de Chrome cuando sea visible; de lo contrario, espera al humano. No reinicies demonios ni mates procesos MCP solo porque la primera salida sea lenta.
Recuperación probada de aviso de conexión:
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
# Si la UI muestra Chrome "Allow remote debugging?", haz clic solo en el botón Allow visible.
"$PB" click --coords <allow_x>,<allow_y> --json
mcporter call chrome-devtools.list_pages --args '{}' --output text
Usa coordenadas de la instantánea actual de Peekaboo, no notas desactualizadas. El éxito significa que list_pages devuelve las pestañas reales de Chrome del usuario.
Regla de alerta de conexión: cuando la instantánea actual muestre claramente a Chrome preguntando si permitir la conexión de DevTools/MCP/automatización, haz clic en el botón Allow visible una vez, luego vuelve a ejecutar list_pages. Si el botón no está visible o el aviso es ambiguo, detente y pregunta; no cambies silenciosamente a Playwright/Puppeteer.
Si list_pages falla con DevToolsActivePort, pide al usuario que reinicie Chrome o el puente DevTools, luego reintenta una vez:
mcporter daemon restart
mcporter call chrome-devtools.list_pages --args '{}' --output text
Si aún falla, detente e informa que Chrome DevTools MCP no está disponible. No uses AppleScript.
Evita bucles de recuperación ruidosos. Los reinicios repetidos de MCP/navegador pueden activar avisos de reconexión/inicio de sesión y alertas. Intenta una vez, luego pausa y elige una ruta más silenciosa.
Flujo Típico
# elige el id de página de list_pages
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text
# inspecciona página
mcporter call chrome-devtools.take_snapshot --args '{}' --output text
# navega a página seleccionada
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text
# haz clic en un uid de elemento de la última instantánea
mcporter call chrome-devtools.click --args '{"uid":"1_38","includeSnapshot":true}' --output text
# escribe/rellena
mcporter call chrome-devtools.fill --args '{"uid":"1_13","value":"text","includeSnapshot":true}' --output text
# ejecuta JS, mantén secretos fuera de la salida
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.title"}' --output json
Usa take_snapshot antes de acciones y solo usa valores uid actuales. Evita take_screenshot a menos que el diseño visual importe.
Prueba de UI en Vivo
Para regresiones de capturas de pantalla, comprobaciones de dashboards desplegados, o cualquier cosa donde el navegador renderizado sea el error:
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
Usa el conjunto de pestañas existente con inicio de sesión/perfil. Si la automatización del navegador no está disponible, repórtalo como una brecha de verificación en lugar de sustituir herramientas de navegador aislado.
Manejo de Secretos
Nunca imprimas tokens/contraseñas del DOM de la página, registros de red o entradas. Para comprobaciones de tokens, devuelve solo la forma: presente/ausente, longitud, código de estado, nombre de cuenta/org.