byob

Bring Your Own Browser — lassen Sie Ihren KI-Assistenten den Chrome-Browser verwenden, den Sie bereits geöffnet haben.

Englisch · 中文

Was kann ich damit tun?

Sie bitten Claude (oder Cursor / Cline), etwas im Web zu erledigen. byob setzt dies in Ihrem echten Chrome um – dem Browser, in dem Sie bereits bei Twitter, GitHub, Gmail, Ihren Arbeitstools und allem anderen angemeldet sind.

Einige Dinge, die Leute tatsächlich fragen:

"lies meine Twitter-Timeline und nenne mir die Top 5 Beiträge"

byob öffnet einen Tab, scrollt durch ihn und gibt den Text zurück. Da es Ihr echter Browser ist, werden Ihre Tweets angezeigt – kein Fake-Account, kein Kopieren von Cookies, keine Captchas.

"google 'mcp protocol spec', klicke auf das erste Ergebnis und lies die Seite"

byob geht zu google.com, gibt Ihre Suche ein, drückt die Eingabetaste, wartet auf die Ergebnisse, klickt auf den ersten Link und liest ihn. Alles in einer einzigen Aufforderung.

"gib mir mein GitHub-Sitzungs-Cookie, damit ich curl in einem Skript verwenden kann"

byob gibt Ihnen das Cookie. Jetzt funktioniert curl https://github.com/... genau so, als wären Sie angemeldet.

"mache einen Screenshot von example.com"

byob speichert ein PNG auf der Festplatte und sagt Claude, wo es sich befindet. (Es wird kein Base64 in Claudes Kontext geladen – das würde Ihre Token verbrauchen.)

"öffne meinen Gmail-Tab und sag mir, wie viele ungelesene Nachrichten ich habe"

Cloud-Headless-Browser können Ihr Gmail nicht sehen, da sie nicht angemeldet sind. byob kann das – weil es IHR Browser ist.

Related MCP server: agent-browser-mcp

Warum nicht einfach WebFetch oder Puppeteer?

5-Minuten-Installation

git clone https://github.com/<you>/byob ~/code/byob
cd ~/code/byob && bun install

# one command does everything: makes a key, builds the extension,
# tells Chrome about it
( cd packages/bridge && bun run dev:cli install --dev )

# load the extension in Chrome:
#   chrome://extensions  →  Developer mode  →  Load unpacked
#   pick: packages/extension/.output/chrome-mv3
# then fully quit Chrome (⌘Q) and open it again

# check it works
( cd packages/bridge && bun run dev:cli doctor )
# four green ✓ means you're good

# tell Claude Code about byob
claude mcp add byob -s user -- /Users/$USER/code/byob/packages/mcp-server/node_modules/.bin/tsx /Users/$USER/code/byob/packages/mcp-server/bin/byob-mcp.ts

Öffnen Sie eine neue Claude Code-Sitzung und sagen Sie "use byob to ...".

Die 10 Dinge, die byob tun kann

Vollständige Eingabe-/Ausgabe-Schemata: shared/src/schemas.ts.

Wie es tatsächlich funktioniert

Claude Code  ─→  byob-mcp  ─→  byob-bridge  ─→  Chrome extension  ─→  your Chrome tab

Vier Hops, alles auf Ihrem Laptop. Nichts verlässt Ihren Rechner. Schließen Sie Chrome und alles wird beendet – keine Hintergrundprozesse, die hängen bleiben.

Wichtige Sicherheitshinweise

• 🔒 browser_eval (JS ausführen) ist standardmäßig deaktiviert – selbst Claude sieht nicht, dass es existiert. Aktivieren Sie es, indem Sie BYOB_ALLOW_EVAL=1 setzen, wenn Sie das MCP registrieren. Wenn es aktiviert ist, wird jeder Aufruf protokolliert und löst eine Chrome-Benachrichtigung aus.

• 🚫 Einige Seiten sind standardmäßig blockiert – chrome://, file://, Ihre Google-/Microsoft-/Apple-Anmeldeseiten. So kann Claude nicht versehentlich Ihren Passwort-Manager oder /etc/passwd lesen.

• 🔑 Sie erhalten Ihren eigenen Erweiterungsschlüssel – bei der Installation erstellt byob einen Schlüssel nur für Sie. Zwei Personen, die byob ausführen, erhalten zwei verschiedene Erweiterungs-IDs, keine Konflikte.

• 📁 Dateien sind privat – Sockets sind 0600, Ordner sind 0700. Andere Benutzer auf Ihrem Computer können sie nicht lesen.

• 📡 byob telefoniert nie nach Hause – keine Analysen, keine Auto-Update-Pings, keine Absturzberichte. Null ausgehender Datenverkehr.

• ⚠️ Chrome zeigt oben auf der Seite "byob debuggt diesen Tab" an. Es gibt keine Möglichkeit, dies zu verbergen – das ist eine Sicherheitsfunktion von Chrome, kein Fehler von byob. Jedes Tool, das den Debugger von Chrome verwendet, hat dasselbe Banner.

Tägliche Befehle

byob install     # set everything up (or fix it after Chrome breaks)
byob doctor      # check what's working and what's not
byob bridges     # show me the running bridges
byob logs [-f]   # tail the log
byob uninstall   # nuke the launcher and manifests

Möchten Sie mehr wissen?

• Design-Notizen – wie byob unter der Haube funktioniert und warum

• Changelog – was erledigt ist und was kommt

• Mitwirken – wie man einen PR sendet

• Test-Checkliste – Dinge, die vor jedem Release ausprobiert werden sollten

Immer noch nicht weiter? Führen Sie byob doctor aus – es sagt Ihnen genau, welcher Schritt kaputt ist.

MIT-lizenziert. byob hat weitreichenden Zugriff auf Ihren Browser – führen Sie es nur auf Computern und Konten aus, die Ihnen gehören.