CommunityBildgithub.com

steipete/browser-use

Vorhandene Chrome-Automatisierung: Primär über Chrome-Plugin, mit mcporter als Fallback.

Was ist browser-use?

Diese Skill ermöglicht die Automatisierung von Browseraufgaben gegen die bestehende Chrome-Sitzung des Benutzers, anstatt eine isolierte Browser-Umgebung zu nutzen. Sie ist besonders nützlich für Websites, die eine Anmeldung erfordern oder bei denen die Darstellung relevant ist (z. B. Screenshot-Regressionen, Dashboard-Prüfungen). Die Skill unterstützt Codex und mcporter als Ausführungsplattformen und priorisiert die Verwendung des vorhandenen Chrome-Profils über das Codex-Plugin. Falls das Plugin nicht verfügbar ist, wird ein mcporter-Fallback über das `chrome-devtools`-Tool verwendet. Die Skill enthält detaillierte Anweisungen zur Fehlerbehebung bei Authentifizierungsaufforderungen, zur Wiederherstellung von Verbindungen und zur Vermeidung von lauten Wiederholungsschleifen. Sie implementiert eine Reihe von Befehlen zur Seitenauswahl, Navigation, Klicken, Ausfüllen und Ausführen von JavaScript sowie zur Aufnahme von Screenshots und Snapshot-Inspektionen. Wichtig ist, dass alle Aktionen auf dem bestehenden Profil ausgeführt werden, um Captchas, Geräteprüfungen oder fehlende SSO/Erweiterungszustände zu vermeiden.

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

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Browser Use

Verwenden Sie dies für Browseraufgaben gegen die bestehende Chrome-Sitzung.

Details zur Konfigurationsreparatur befinden sich in mcporter-config.md.

Route

  1. Wenn das Codex Chrome- oder Chrome [Internal]-Plugin in der aktuellen Sitzung aufrufbar ist, verwenden Sie dessen gebündelte Chrome-Control-Skill.
  2. Andernfalls verwenden Sie die mcporter chrome-devtools-Route unten.

Gebündelt oder auf der Festplatte installiert bedeutet nicht verfügbar; das Plugin muss in der aktiven Sitzung aufrufbar sein. Beide Routen müssen das vorhandene Chrome-Profil des Benutzers verwenden.

Für den mcporter-Fallback verwenden Sie dieses Ziel:

mcporter call chrome-devtools.<tool>

Die meisten anmeldeintensiven Websites schlagen in isolierten Profilen fehl, weil neue Sitzungen Captchas, Geräteprüfungen oder fehlende SSO/Erweiterungszustände auslösen. Bevorzugen Sie stark das vorhandene Chrome-Profil für jede Website, die eine Anmeldung erfordert.

Verwenden Sie niemals chrome-isolated, Playwright, Puppeteer, den Codex-In-App-Browser, AppleScript, osascript, GUI-Scripting oder macOS open zur Browsersteuerung, es sei denn, der Benutzer fordert explizit einen isolierten/neuen Browser an.

Screenshot-/Live-UI-Fehler erfordern diesen vorhandenen Chrome-Pfad. curl, Quelltextinspektion, Worker-Smoke-Tests oder lokales Playwright sind nur unterstützende Beweise; behandeln Sie sie nicht als gleichwertig, wenn der Benutzer ein gerendertes Browserproblem gezeigt hat oder die Seite möglicherweise vom Anmelde-/Profilzustand abhängt.

MCP prüfen

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

list_pages muss die echten geöffneten Tabs des Benutzers anzeigen. Wenn ein leerer/standardmäßiger isolierter Chrome angezeigt wird, stoppen Sie und melden Sie, dass das Wiederanhängen fehlgeschlagen ist.

Wenn der Aufruf zu hängen scheint, während Chrome eine Authentifizierungs-/Anhänge-/Aktualisierungsaufforderung anzeigt, behandeln Sie den Anhänge-Alarm, bevor Sie auf den Fallback zurückgreifen. Bevorzugen Sie Peekaboo, um eine explizite Chrome Allow-Schaltfläche zu drücken, wenn sie sichtbar ist; warten Sie andernfalls auf den Menschen. Starten Sie keine Dienste neu oder töten Sie MCP-Prozesse nur, weil die erste Ausgabe langsam ist.

Getestete Wiederherstellung nach Anhänge-Aufforderung:

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
# Wenn die Benutzeroberfläche Chrome "Remote-Debugging zulassen?" anzeigt, klicken Sie nur auf die sichtbare Allow-Schaltfläche.
"$PB" click --coords <allow_x>,<allow_y> --json
mcporter call chrome-devtools.list_pages --args '{}' --output text

Verwenden Sie Koordinaten aus dem aktuellen Peekaboo-Snapshot, nicht aus veralteten Notizen. Erfolg bedeutet, dass list_pages die echten Chrome-Tabs des Benutzers zurückgibt.

Anhänge-Alarm-Regel: Wenn der aktuelle Snapshot deutlich zeigt, dass Chrome fragt, ob DevTools/MCP/Browser-Automatisierungs-Anhänge zugelassen werden sollen, klicken Sie einmal auf die sichtbare Allow-Schaltfläche und führen Sie dann list_pages erneut aus. Wenn die Schaltfläche nicht sichtbar oder die Aufforderung mehrdeutig ist, stoppen Sie und fragen Sie nach; wechseln Sie nicht stillschweigend zu Playwright/Puppeteer.

Wenn list_pages mit DevToolsActivePort fehlschlägt, bitten Sie den Benutzer, Chrome oder die DevTools-Brücke neu zu starten, und wiederholen Sie es dann einmal:

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

Wenn es immer noch fehlschlägt, stoppen Sie und melden Sie, dass Chrome DevTools MCP nicht verfügbar ist. Verwenden Sie kein AppleScript.

Vermeiden Sie laute Wiederholungsschleifen. Wiederholte MCP-/Browser-Neustarts können erneute Verbindungs-/Anmeldeaufforderungen und Alarme auslösen. Versuchen Sie es einmal, pausieren Sie dann und wählen Sie einen leiseren Pfad.

Typischer Ablauf

# Wählen Sie die Seiten-ID aus list_pages aus
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text

# Seite inspizieren
mcporter call chrome-devtools.take_snapshot --args '{}' --output text

# Ausgewählte Seite navigieren
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text

# Ein Element-UID aus dem letzten Snapshot anklicken
mcporter call chrome-devtools.click --args '{"uid":"1_38","includeSnapshot":true}' --output text

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

# JS ausführen, Geheimnisse aus der Ausgabe heraushalten
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.title"}' --output json

Verwenden Sie take_snapshot vor Aktionen und verwenden Sie nur aktuelle uid-Werte. Vermeiden Sie take_screenshot, es sei denn, das visuelle Layout ist wichtig.

Live-UI-Nachweis

Für Screenshot-Regressionen, bereitgestellte Dashboard-Prüfungen oder alles, bei dem der gerenderte Browser der Fehler ist:

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

Verwenden Sie den vorhandenen, angemeldeten/profil-tragenden Tab-Satz. Wenn die Browser-Automatisierung nicht verfügbar ist, melden Sie dies als Verifikationslücke, anstatt isolierte Browser-Werkzeuge zu ersetzen.

Umgang mit Geheimnissen

Geben Sie niemals Tokens/Passwörter aus dem Seiten-DOM, Netzwerkprotokollen oder Eingaben aus. Geben Sie für Token-Prüfungen nur die Form zurück: vorhanden/nicht vorhanden, Länge, Statuscode, Konto-/Organisationsname.

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.

Verwandte Skills