CommunityImagengithub.com

steipete/browser-use

Automatización de Chrome existente: plugin Chrome primero, fallback mcporter.

¿Qué es browser-use?

Esta skill proporciona una forma fiable y segura de controlar la sesión de Chrome existente del usuario, priorizando el plugin `Chrome` o `Chrome [Internal]` de Codex cuando está disponible, y utilizando `mcporter` como respaldo. Es especialmente útil para interacciones que requieren inicio de sesión, captchas, o perfiles de extensión, donde los navegadores aislados suelen fallar. La skill gestiona la detección de sesiones reales, adjunta automáticamente el perfil de Chrome del usuario, y recupera prompts de autorización (como "Allow remote debugging") usando `Peekaboo`. Ofrece flujos típicos de navegación: listar páginas, seleccionar pestañas, hacer clic, rellenar formularios, ejecutar JavaScript, y tomar capturas. También incluye manejo de errores para fallos de conexión, y reglas estrictas para evitar el uso de alternativas como Playwright, Puppeteer o AppleScript a menos que el usuario lo solicite explícitamente.

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

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

  1. Si el plugin Chrome o Chrome [Internal] de Codex es invocable en la sesión actual, usa su skill integrada de control de Chrome.
  2. De lo contrario, usa la ruta chrome-devtools de 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.

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.

Skills relacionados