CommunityImagegithub.com

steipete/browser-use

Automatisation du navigateur existant : d'abord le plugin Chrome, puis repli mcporter.

Qu'est-ce que browser-use ?

Cette compétence permet d'automatiser des tâches de navigateur en utilisant la session Chrome existante de l'utilisateur, plutôt que de lancer une session isolée. Elle fonctionne sur Codex (via le plugin Chrome intégré) et, en cas d'indisponibilité, bascule vers le mécanisme mcporter `chrome-devtools`. L'objectif principal est d'éviter les échecs de connexion, les captchas et les contrôles d'appareil qui surviennent inévitablement dans les profils frais. La compétence fournit des commandes pour inspecter les pages, cliquer sur des éléments, naviguer, remplir des formulaires et exécuter du JavaScript, tout en s'appuyant sur l'outil Peekaboo pour gérer les popups d'autorisation de débogage de Chrome. Ce choix est essentiel pour résoudre les problèmes d'interface utilisateur (rendu, captures d'écran) ou pour interagir avec des sites nécessitant une authentification. L'outil insiste sur le fait de ne pas utiliser Playwright, Puppeteer ou AppleScript à la place, sauf demande explicite.

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

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Browser Use

Utilisez cette compétence pour les tâches de navigateur sur la session Chrome existante.

Les détails de réparation de la configuration se trouvent dans mcporter-config.md.

Route

  1. Si le plugin Codex Chrome ou Chrome [Internal] est appelable dans la session en cours, utilisez sa compétence de contrôle Chrome intégrée.
  2. Sinon, utilisez la route mcporter chrome-devtools ci-dessous.

Le fait d'être installé sur le disque ne signifie pas qu'il est disponible ; le plugin doit être appelable dans la session active. Les deux routes doivent utiliser le profil Chrome existant de l'utilisateur.

Pour le repli mcporter, utilisez cette cible :

mcporter call chrome-devtools.<tool>

La plupart des sites nécessitant une connexion échouent dans des profils isolés car les nouvelles sessions déclenchent des captchas, des vérifications d'appareil ou un état SSO/extension manquant. Préférez fortement le profil Chrome existant pour tout site web qui nécessite une connexion.

N'utilisez jamais chrome-isolated, Playwright, Puppeteer, le navigateur intégré de Codex, AppleScript, osascript, les scripts GUI, ou open macOS pour le contrôle du navigateur, sauf si l'utilisateur demande explicitement un navigateur isolé/nouveau.

Les bugs de capture d'écran/interface utilisateur en direct nécessitent ce chemin Chrome existant. curl, l'inspection de source, les tests Worker, ou Playwright local ne sont que des preuves de support ; ne les traitez pas comme équivalents lorsque l'utilisateur a montré un problème de rendu de navigateur ou que la page peut dépendre de l'état de connexion/profil.

Vérifier MCP

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

list_pages doit afficher les onglets ouverts réels de l'utilisateur. Si elle affiche un Chrome isolé vide par défaut, arrêtez et dites que la reconnexion a échoué.

Si l'appel semble bloqué pendant que Chrome affiche une invite d'authentification/attachement/mise à jour, gérez l'alerte d'attachement avant de passer au repli. Préférez Peekaboo pour appuyer sur un bouton explicite Allow de Chrome lorsqu'il est visible ; sinon, attendez l'humain. Ne redémarrez pas les démons et ne tuez pas les processus MCP simplement parce que la première sortie est lente.

Récupération testée d'invite d'attachement :

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 l'interface montre Chrome "Allow remote debugging?", cliquez uniquement sur le bouton Allow visible.
"$PB" click --coords <allow_x>,<allow_y> --json
mcporter call chrome-devtools.list_pages --args '{}' --output text

Utilisez les coordonnées de l'instantané Peekaboo actuel, pas de notes obsolètes. Le succès signifie que list_pages renvoie les onglets Chrome réels de l'utilisateur.

Règle d'alerte d'attachement : lorsque l'instantané actuel montre clairement Chrome demandant l'autorisation de l'attachement DevTools/MCP/automatisation du navigateur, cliquez une fois sur le bouton Allow visible, puis réexécutez list_pages. Si le bouton n'est pas visible ou si l'invite est ambiguë, arrêtez et demandez ; ne passez pas silencieusement à Playwright/Puppeteer.

Si list_pages échoue avec DevToolsActivePort, demandez à l'utilisateur de redémarrer Chrome ou le pont DevTools, puis réessayez une fois :

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

Si cela échoue encore, arrêtez et dites que Chrome DevTools MCP est indisponible. N'utilisez pas AppleScript.

Évitez les boucles de récupération bruyantes. Les redémarrages répétés de MCP/navigateur peuvent déclencher des invites de reconnexion/connexion et des alertes. Essayez une fois, puis faites une pause et choisissez un chemin plus silencieux.

Flux Typique

# sélectionner l'ID de page depuis list_pages
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text

# inspecter la page
mcporter call chrome-devtools.take_snapshot --args '{}' --output text

# naviguer vers la page sélectionnée
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text

# cliquer sur un uid d'élément depuis le dernier instantané
mcporter call chrome-devtools.click --args '{"uid":"1_38","includeSnapshot":true}' --output text

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

# exécuter JS, garder les secrets hors de la sortie
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.title"}' --output json

Utilisez take_snapshot avant les actions et n'utilisez que les valeurs actuelles de uid. Évitez take_screenshot sauf si la disposition visuelle est importante.

Preuve d'interface Utilisateur en Direct

Pour les régressions de capture d'écran, les vérifications de tableau de bord déployé, ou tout ce où le navigateur rendu est le 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

Utilisez l'ensemble d'onglets existant (connecté/porteur de profil). Si l'automatisation du navigateur est indisponible, signalez-le comme un écart de vérification au lieu de substituer un outil de navigateur isolé.

Gestion des Secrets

N'imprimez jamais les jetons/mots de passe depuis le DOM de la page, les journaux réseau, ou les entrées. Pour les vérifications de jetons, renvoyez uniquement la forme : présent/absent, longueur, code d'état, nom de compte/organisation.

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 associés