byob

Bring Your Own Browser — AIアシスタントに、あなたが既に開いているChromeを使わせましょう。

English · 中文

これで何ができるの？

Claude（またはCursor / Cline）にWeb上で何かをするよう頼むことができます。byobは、Twitter、GitHub、Gmail、仕事用ツールなど、あなたが既にログインしている実際のChromeでそれを実行します。

実際に人々が依頼していることの例：

「Twitterのタイムラインを読んで、上位5件の投稿を教えて」

byobがタブを開き、スクロールしてテキストを返します。実際のブラウザを使うため、あなたのツイートが表示されます。偽のアカウントも、クッキーのコピー＆ペーストも、CAPTCHAも必要ありません。

「'mcp protocol spec'をググって、最初の結果をクリックして、ページを読んで」

byobがgoogle.comにアクセスし、検索ワードを入力してEnterを押し、結果を待ち、最初のリンクをクリックして読み取ります。すべて1つのプロンプトで完結します。

「スクリプトでcurlを使えるように、GitHubのセッションクッキーを教えて」

byobがクッキーを渡します。これで、curl https://github.com/... がログイン状態と同じように動作します。

「example.comのスクリーンショットを撮って」

byobがPNGをディスクに保存し、Claudeにその場所を伝えます。（Claudeのコンテキストにbase64をダンプしないため、トークンを浪費しません。）

「Gmailのタブを開いて、未読がいくつあるか教えて」

クラウド上のヘッドレスブラウザはログインしていないためGmailを見ることができません。byobなら可能です。なぜなら、それが「あなたのブラウザ」だからです。

Related MCP server: agent-browser-mcp

なぜ WebFetch や Puppeteer ではないのか？

5分でインストール

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

Claude Codeの新しいセッションを開き、「use byob to ...」と話しかけてください。

byobができる10のこと

入出力の完全な形式: shared/src/schemas.ts

実際の仕組み

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

すべてあなたのラップトップ上で完結する4つのホップです。マシンからデータが出ることはありません。Chromeを閉じればすべて終了し、バックグラウンドプロセスが残ることもありません。

安全性について知っておくべきこと

• 🔒 browser_eval (JS実行) はデフォルトでオフ — Claudeでさえその存在を認識できません。MCPを登録する際に BYOB_ALLOW_EVAL=1 を設定することでオンにできます。オンにすると、すべての呼び出しがログに記録され、Chromeの通知が表示されます。

• 🚫 一部のサイトはデフォルトでブロック — chrome://、file://、Google/Microsoft/Appleのログインページなど。そのため、Claudeが誤ってパスワードマネージャーや /etc/passwd を読み取ることはありません。

• 🔑 独自の拡張機能キーを取得 — インストール時に、byobはあなた専用のキーを作成します。2人がbyobを実行しても拡張機能IDは異なり、競合しません。

• 📁 ファイルはプライベート — ソケットは 0600、フォルダは 0700 です。コンピュータ上の他のユーザーは読み取れません。

• 📡 byobは外部通信を行いません — 分析も、自動更新のpingも、クラッシュレポートもありません。アウトバウンドトラフィックはゼロです。

• ⚠️ Chromeのページ上部に「byobがこのタブをデバッグしています」と表示されます — これを隠す方法はありません。これはChromeの安全機能であり、byobのバグではありません。Chromeのデバッガーを使用するすべてのツールに同じバナーが表示されます。

日常的なコマンド

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

もっと知りたいですか？

• 設計メモ — byobの内部構造とその理由

• 変更履歴 — 完了したことと今後の予定

• 貢献 — PRの送り方

• テストチェックリスト — 各リリース前に試すべきこと

それでも解決しない場合は、byob doctor を実行してください。どのステップが壊れているかを正確に教えてくれます。

MITライセンス。byobはブラウザへの広範なアクセス権を持つため、所有しているマシンとアカウントでのみ実行してください。