Byob

Предоставьте AI-агентам возможность управлять вашим открытым браузером Chrome с помощью Byob. Выполняйте веб-задачи: чтение, клики, ввод текста и получение cookies без входа в систему или проверок на ботов. Быстро, безопасно и удобно.

Веб-скрапинг и сбор данных Автоматизация браузера Инструменты разработчика ★ 37 GitHub (37 ★)

Bring Your Own Browser (byob) позволяет AI-ассистентам, таким как Claude, Cursor и Cline, работать напрямую с вашим запущенным экземпляром Chrome. Это устраняет распространенные препятствия безголовых браузеров или WebFetch, такие как необходимость входа, CAPTCHA и сложное управление куками. byob позволяет вашему AI-агенту выполнять действия, такие как чтение лент социализированных сетей, навигация по сайтам, заполнение форм, создание скриншотов и даже извлечение сессионных куков — все это в браузерной среде, в которую вы уже вошли и аутентифицированы. Проект предназначен для быстрой настройки и гарантирует, что все операции остаются на вашем компьютере, повышая конфиденциальность и безопасность.

Ключевые возможности

01Делать скриншоты всей страницы и сохранять их на диск

0237 звезд на GitHub

03Вводить текст в поля ввода и отправлять формы

04Читать и прокручивать веб-страницы для извлечения содержимого

05Нажимать на интерактивные элементы, такие как кнопки и ссылки

06Получать куки для конкретных сайтов для внешнего использования (например, с помощью curl)

Варианты использования

01Поручить AI анализировать вашу персонализированную ленту Twitter для поиска лучших постов без повторной аутентификации.

02Автоматизация многоэтапной навигации по вебу, например, поиск в Google

byob

Bring Your Own Browser — let your AI assistant use the Chrome you already have open.

English · 中文

What can I do with this?

You ask Claude (or Cursor / Cline) to do something on the web. byob makes it happen in your real Chrome — the one where you're already logged into Twitter, GitHub, Gmail, your work tools, everything.

A few things people actually ask:

"read my Twitter timeline and tell me the top 5 posts"

byob opens a tab, scrolls through it, hands the text back. Because it's your real browser, your tweets show up — no fake account, no copy-pasting cookies, no captchas.

"google 'mcp protocol spec', click the first result, and read the page"

byob goes to google.com, types your search, hits Enter, waits for results, clicks the first link, reads it. All in one prompt.

"give me my github session cookie so I can use curl in a script"

byob hands you the cookie. Now curl https://github.com/... works just like you're logged in.

"take a screenshot of example.com"

byob saves a PNG to disk and tells Claude where it is. (Doesn't dump base64 into Claude's context — that would burn through your tokens.)

"open my Gmail tab and tell me how many unread"

Cloud headless browsers can't see your Gmail because they're not logged in. byob can — because it IS your browser.

Why not just `WebFetch` or Puppeteer?

	WebFetch	Headless Puppeteer	byob
Sees pages that need login	❌	⚠️ have to copy cookies in	✅ already logged in
Gets past "are you a bot?" checks	❌	❌	✅ it really is a human's browser
Setup time	0	hours	5 min
Costs cloud money	nope	yes	nope

5-minute install

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

Open a fresh Claude Code session and say "use byob to ...".

The 10 things byob can do

Tool	What it does
📖 `browser_read`	Open a page, scroll through it, read everything
📸 `browser_screenshot`	Take a screenshot, save to disk
🖱️ `browser_click`	Click a button or link
⌨️ `browser_type`	Type into a text box (and hit Enter if you want)
🍪 `browser_get_cookies`	Grab the cookies for a site so you can `curl` it later
🚀 `browser_navigate`	Go to a URL in a new or existing tab
⏳ `browser_wait_for`	Wait until something appears on the page
🗂️ `browser_list_tabs`	Show me all my open tabs
🎯 `browser_switch_tab`	Switch to a specific tab
⚡ `browser_eval`	Run any JavaScript on the page (off by default — see Security)

Full input/output shapes: shared/src/schemas.ts.

How it actually works

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

Four hops, all on your laptop. Nothing leaves your machine. Close Chrome and everything quits — no background processes hanging around.

Stuff to know about safety

🔒 browser_eval (run JS) is off by default — even Claude doesn't see it exists. Turn it on by setting BYOB_ALLOW_EVAL=1 when you register the MCP. When it's on, every call gets logged and pops a Chrome notification.
🚫 Some sites are blocked by default — chrome://, file://, your Google/Microsoft/Apple login pages. So Claude can't accidentally read your password manager or /etc/passwd.
🔑 You get your own extension key — when you install, byob makes a key just for you. Two people running byob get two different extension IDs, no clash.
📁 Files are private — sockets are 0600, folders are 0700. Other users on your computer can't read them.
📡 byob never phones home — no analytics, no auto-update pings, no crash reports. Zero outbound traffic.
⚠️ Chrome will show "byob is debugging this tab" at the top of the page. There is no way to hide it — that's a Chrome safety thing, not a byob bug. Every tool that uses Chrome's debugger has the same banner.

Day-to-day commands

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

Want to know more?

Design notes — how byob works under the hood and why
Changelog — what's done and what's coming
Contributing — how to send a PR
Test checklist — things to try before each release

Something's broken — what do I do?

What you see	What's probably wrong
`No live bridge`	Chrome isn't open, or the byob extension is disabled. Check `chrome://extensions`.
`cdp_attach_failed`	DevTools (F12) is open on that tab. Close it.
`url_forbidden` on a normal URL	The URL is on the default blocklist (see Safety). Use a different tab.
`extension_not_connected`	Reload the byob extension at `chrome://extensions`.
Just installed but nothing works	Fully quit Chrome (⌘Q) and reopen. Chrome only checks for the byob bridge when it starts up.

Still stuck? Run byob doctor — it tells you exactly which step is broken.

MIT licensed. byob has a lot of access to your browser — only run it on machines and accounts you own.

Byob — Bring Your Own Browser

Byob (Bring Your Own Browser) — MCP-сервер для работы с вашим реальным браузером Chrome. В отличие от headless-решений, Byob использует ту самую копию Chrome, в которой вы уже залогинены в Twitter, GitHub, Gmail и прочие сервисы. Никаких поддельных аккаунтов, ручного копирования cookie или капч.

Возможности

Byob предоставляет набор инструментов для Claude Code (или Cursor / Cline):

Инструмент	Что делает
`browser_read`	Открывает страницу, прокручивает, читает весь текст
`browser_screenshot`	Делает скриншот и сохраняет в файл
`browser_click`	Кликает по кнопке или ссылке
`browser_type`	Печатает текст в поле ввода (может нажать Enter)
`browser_get_cookies`	Забирает cookies для сайта (например, для curl)
`browser_navigate`	Переходит по URL в новой или существующей вкладке
`browser_wait_for`	Ждёт появления элемента на странице
`browser_list_tabs`	Показывает список открытых вкладок
`browser_switch_tab`	Переключается на указанную вкладку
`browser_eval`	Выполняет произвольный JavaScript на странице (по умолчанию выключено)

Полные спецификации входных/выходных данных: shared/src/schemas.ts.

Примеры запросов:

«Прочитай мою ленту Twitter и покажи топ‑5 постов» — Byob открывает вкладку, скроллит и возвращает текст.
«Загугли 'mcp protocol spec', кликни первый результат и прочитай страницу» — работает в один промпт.
«Дай куку GitHub, чтобы я мог использовать curl в скрипте» — получаете cookie и можете работать с GitHub через curl.
«Сделай скриншот example.com» — сохраняет PNG на диск (не забивает контекст base64).
«Открой вкладку Gmail и скажи, сколько непрочитанных» — headless-браузеры не могут этого сделать, Byob — может.

Как это работает

Claude Code → byob-mcp → byob-bridge → Chrome extension → ваша вкладка Chrome

Все четыре звена работают на вашем компьютере. Никакие данные не покидают машину. Закрыли Chrome — всё завершилось, фоновых процессов не осталось.

Установка за 5 минут

Клонируйте репозиторий:

git clone https://github.com/wxtsky/byob.git ~/code/byob
cd ~/code/byob && bun install

Соберите ключ и расширение:

cd packages/bridge && bun run dev:cli install --dev

Загрузите расширение в Chrome:
- Откройте chrome://extensions
- Включите «Режим разработчика» (Developer mode)
- Нажмите «Загрузить распакованное» (Load unpacked)
- Выберите папку packages/extension/.output/chrome-mv3
- Полностью перезапустите Chrome (⌘Q и открыть заново)
Проверьте, что всё работает:

cd packages/bridge && bun run dev:cli doctor

Должно быть четыре зелёные галочки.

Подключите Byob к Claude Code:

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 install — установка или восстановление после обновления Chrome
byob doctor — диагностика состояния
byob bridges — список запущенных мостов
byob logs [-f] — просмотр логов
byob uninstall — удаление лаунчера и манифестов

Вопросы безопасности

browser_eval выключен по умолчанию — даже Claude не знает о его существовании. Включите через BYOB_ALLOW_EVAL=1 при регистрации MCP. Все вызовы логируются и показывают уведомление в Chrome.
Заблокированные страницы: chrome://, file://, страницы входа Google/Microsoft/Apple — Claude не сможет случайно прочитать ваш менеджер паролей или /etc/passwd.
Уникальный ключ расширения — у каждого установщика свой ID, конфликтов с другими копиями Byob нет.
Файлы приватные — сокеты имеют права 0600, папки 0700.
Никаких «звонков домой» — нет аналитики, автообновлений, краш-репортов. Нулевой исходящий трафик.
Баннер Chrome «byob is debugging this tab» — это встроенная защита браузера, скрыть её нельзя.

Почему не WebFetch или Puppeteer?

	WebFetch	Headless Puppeteer	Byob
Видит страницы, требующие логина	❌	⚠️ (нужно копировать cookies)	✅
Проходит проверки «are you a bot?»	❌	❌	✅
Время настройки	0	часы	5 минут
Тратит облачные деньги	нет	да	нет

Возможные проблемы и решения

Что видите	Вероятная причина
No live bridge	Chrome не открыт или расширение выключено. Проверьте `chrome://extensions`
cdp_attach_failed	На вкладке открыт DevTools (F12). Закройте его
url_forbidden на обычном URL	URL в списке блокировки (см. раздел безопасности). Используйте другую вкладку
extension_not_connected	Перезагрузите расширение в `chrome://extensions`
Ничего не работает после установки	Полностью перезапустите Chrome (⌘Q). Chrome проверяет соединение при старте

Всё ещё не работает? Запустите byob doctor — он покажет точный шаг, который сломался.

Дополнительная информация

Дизайн-заметки — как Byob работает под капотом
Список изменений — что сделано и что планируется
Контрибьюция — как отправить PR
Тест-чеклист — что проверить перед релизом

Лицензия: MIT. Byob имеет широкий доступ к вашему браузеру — запускайте только на своих машинах и под своей учётной записью.

Источник: https://mcpmarket.com/server/byob

Byob

Ключевые возможности

Варианты использования

byob

What can I do with this?

Why not just `WebFetch` or Puppeteer?

5-minute install

The 10 things byob can do

How it actually works

Stuff to know about safety

Day-to-day commands

Want to know more?

Byob — Bring Your Own Browser

Возможности

Как это работает

Установка за 5 минут

Ежедневные команды

Вопросы безопасности

Почему не WebFetch или Puppeteer?

Возможные проблемы и решения

Дополнительная информация

Что такое Byob (Bring Your Own Browser)?

Чем Byob отличается от headless-браузеров или WebFetch?

Какие веб-задачи могут выполнять AI-агенты с Byob?

Безопасен и конфиденциален ли Byob?

Каковы основные преимущества использования Byob для AI-автоматизации веб-задач?

Комментарии

Ключевые возможности

Варианты использования

byob

What can I do with this?

Why not just WebFetch or Puppeteer?

5-minute install

The 10 things byob can do

How it actually works

Stuff to know about safety

Day-to-day commands

Want to know more?

Byob — Bring Your Own Browser

Возможности

Как это работает

Установка за 5 минут

Ежедневные команды

Вопросы безопасности

Почему не WebFetch или Puppeteer?

Возможные проблемы и решения

Дополнительная информация

Что такое Byob (Bring Your Own Browser)?

Чем Byob отличается от headless-браузеров или WebFetch?

Какие веб-задачи могут выполнять AI-агенты с Byob?

Безопасен и конфиденциален ли Byob?

Каковы основные преимущества использования Byob для AI-автоматизации веб-задач?

Комментарии

Why not just `WebFetch` or Puppeteer?