byob

Bring Your Own Browser (Принеси свой браузер) — позвольте вашему ИИ-ассистенту использовать Chrome, который у вас уже открыт.

English · 中文

Что я могу с этим делать?

Вы просите Claude (или Cursor / Cline) сделать что-то в интернете. byob воплощает это в вашем реальном Chrome — том самом, где вы уже вошли в Twitter, GitHub, Gmail, рабочие инструменты и всё остальное.

Несколько примеров того, о чем люди обычно просят:

"прочитай мою ленту Twitter и назови 5 лучших постов"

byob открывает вкладку, прокручивает её и возвращает текст. Поскольку это ваш реальный браузер, ваши твиты отображаются — никаких фейковых аккаунтов, копирования куки или капч.

"найди в google 'mcp protocol spec', нажми на первый результат и прочитай страницу"

byob переходит на google.com, вводит ваш запрос, нажимает Enter, ждет результатов, кликает по первой ссылке и читает её. Всё в одном запросе.

"дай мне мой cookie сессии github, чтобы я мог использовать curl в скрипте"

byob передает вам cookie. Теперь curl https://github.com/... работает так, будто вы вошли в систему.

"сделай скриншот example.com"

byob сохраняет PNG на диск и сообщает Claude, где он находится. (Не выгружает base64 в контекст Claude — это быстро исчерпало бы ваши токены.)

"открой мою вкладку Gmail и скажи, сколько там непрочитанных писем"

Облачные headless-браузеры не видят ваш 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 ...".

10 вещей, которые умеет byob

Полные схемы ввода/вывода: shared/src/schemas.ts.

Как это работает на самом деле

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

Четыре этапа, всё происходит на вашем ноутбуке. Ничего не покидает вашу машину. Закройте Chrome, и всё завершится — никаких фоновых процессов.

Что нужно знать о безопасности

• 🔒 browser_eval (выполнение JS) отключено по умолчанию — даже Claude не видит, что оно существует. Включите его, установив BYOB_ALLOW_EVAL=1 при регистрации MCP. Когда оно включено, каждый вызов логируется и вызывает уведомление Chrome.

• 🚫 Некоторые сайты заблокированы по умолчанию — chrome://, file://, страницы входа Google/Microsoft/Apple. Так что Claude не сможет случайно прочитать ваш менеджер паролей или /etc/passwd.

• 🔑 Вы получаете свой собственный ключ расширения — при установке byob создает ключ специально для вас. У двух людей, использующих byob, будут разные ID расширений, конфликтов не будет.

• 📁 Файлы приватны — сокеты имеют права 0600, папки — 0700. Другие пользователи на вашем компьютере не могут их прочитать.

• 📡 byob никогда не отправляет данные на сервер — никакой аналитики, никаких пингов автообновления, никаких отчетов о сбоях. Нулевой исходящий трафик.

• ⚠️ 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 имеет широкий доступ к вашему браузеру — запускайте его только на машинах и аккаунтах, которыми вы владеете.