ZuBrIQ для Chrome — агент в вашем браузере
ZuBrIQ для Chrome даёт агенту ваш настоящий браузер: открытые вкладки, сайты, в которые вы уже вошли, ваши расширения. Агент открывает свои вкладки в фоне, читает страницы, нажимает, заполняет формы, делает скриншоты — а когда нужен человек (вход, код из СМС, оплата), отдаёт вкладку вам и ждёт.
Работает с ZubrCode и ZuBrIQ Desktop, а также с Claude Code, Codex, Cursor и другими агентами, которые умеют подключать MCP-серверы. Браузеры: Chrome, Edge, Brave, Arc, Helium, Vivaldi, Opera и Chromium.
Как это устроено
Заголовок раздела «Как это устроено»Три части на вашем компьютере:
- Расширение в браузере — выполняет команды во вкладках через встроенный в Chrome отладчик.
- Relay — небольшой локальный процесс
zubriq-browse, слушает только127.0.0.1. Запускается сам, когда агенту нужен браузер. - MCP-сервер
zubriq-browse— через него агент получает инструменты браузера. Установщик сам прописывает его вашим агентам.
Агент → MCP-сервер → relay → расширение → вкладка. Расширение и relay один раз сопрягаются и дальше на каждом подключении проверяют общий ключ, поэтому другая программа на компьютере не сможет управлять вашим браузером через relay.
Установка
Заголовок раздела «Установка»-
Поставьте команду
zubriq-browse:Окно терминала # macOS и Linuxcurl -fsSL https://zubriq.ai/browse.sh | shОкно терминала # Windows (PowerShell)irm https://zubriq.ai/browse.ps1 | iexУстановщик кладёт
zubriq-browseв~/.local/binи сразу запускаетzubriq-browse install. -
Выберите агентов. Найденные на компьютере отмечены сразу: пробел — отметить, Enter — подтвердить. Установщик добавит им MCP-сервер
zubriq-browse. Повторный запуск только добавляет — снятая галочка ничего не удаляет. -
Добавьте расширение. Установщик откроет страницу «ZuBrIQ для Chrome» в Chrome Web Store — нажмите «Установить». Как только расширение появится, установщик сам сопряжёт его с relay, ничего копировать не нужно.
-
Перезапустите агента (или начните новую сессию), чтобы он увидел новый MCP-сервер, и попросите, например: «открой zubriq.ai и расскажи, что на главной».
Проверить, что всё на месте: zubriq-browse status — покажет relay,
расширение и вкладки, доступные агентам, и подскажет, чего не хватает.
Если сопряжение не прошло само
Заголовок раздела «Если сопряжение не прошло само»Запустите zubriq-browse pair — команда напечатает код вида XXXX-XXXX
(действует один раз, 10 минут). В браузере: правый клик по значку расширения →
Параметры → дополнительно (или Сопрячь по коду) → введите код в
Код сопряжения → Подключить. Команда подтвердит, какой браузер сопряжён.
zubriq-browse pair --list— сопряжённые браузеры и когда каждый был на связи;zubriq-browse pair --revoke <браузер>— отозвать ключ браузера и отключить его.
Как с ним работать
Заголовок раздела «Как с ним работать»Агент работает в своих вкладках
Заголовок раздела «Агент работает в своих вкладках»- Агент открывает вкладки в фоне окна, которым вы пользовались последним, и собирает их в свёрнутую группу в начале полосы вкладок. Переключить вас на свою вкладку или вывести окно поверх вашей работы агент не может.
- Всплывающие окна, которые открывает страница агента, попадают в ту же группу.
- Вкладки, которых агент не касался 10 минут, закрываются сами (настраивается).
- Перезапуск relay вкладки агента не теряет — сессия заберёт их обратно.
Пока расширение подключено, Chrome показывает плашку «…начал отладку этого браузера» — так и должно быть. Кнопка Отмена на ней отключает расширение от всех вкладок сразу.
Дать агенту свою вкладку
Заголовок раздела «Дать агенту свою вкладку»Нажмите значок расширения на панели, находясь на нужной вкладке — на значке появится ON, вкладка доступна агенту. Нажмите ещё раз — вкладка снова только ваша. Значок показывает состояние:
| Значок | Что значит |
|---|---|
| ON | вкладка отдана агенту |
| RUN | агент сейчас в ней работает |
| WAIT | агент ждёт вас (см. ниже) |
| … | relay ещё не запущен — вкладка перейдёт агенту, как только он начнёт работу |
Нажатие на значок всегда возвращает вкладку вам и останавливает то, что агент
в ней делал. Закрыть вашу вкладку агент не может. Служебные страницы браузера
(chrome://…, магазин расширений) отдать нельзя; для локальных файлов включите
«Разрешить доступ к URL файлов» в карточке расширения на chrome://extensions.
Когда нужен человек: вход, код, оплата
Заголовок раздела «Когда нужен человек: вход, код, оплата»Если на странице вход, двухфакторный код, оплата или проверка «я не робот», агент не решает это сам — он передаёт вкладку вам. На странице появится небольшая карточка с адресом сайта: сделайте свою часть и нажмите Продолжить на карточке или значок расширения. Агент продолжит с того же места. Завершить передачу может только настоящий клик — страница подделать его не может.
Примеры запросов
Заголовок раздела «Примеры запросов»- «Открой наш личный кабинет на example.by и выгрузи таблицу заказов за неделю в orders.csv» — агент пройдёт по страницам; если попросит войти, войдите сами и нажмите «Продолжить».
- «Проверь форму регистрации на localhost:3000: отправь пустую и с неверной почтой, расскажи, какие ошибки показываются».
- «Открой страницу дашборда и посмотри ошибки в консоли при загрузке».
- «Сделай скриншот страницы оплаты и сохрани на диск».
- «Запиши видео, как оформить заказ, от корзины до подтверждения».
- «Сравни цены на этот товар на трёх сайтах и сведи в таблицу».
Что ещё умеет агент
Заголовок раздела «Что ещё умеет агент»- Сессии — у каждой свои вкладки, переживают перезапуски
(
zubriq-browse session …). - Ограничить сайты — сессии можно разрешить только перечисленные сайты: агент не уйдёт по ссылке, редиректу или всплывающему окну на чужой адрес. Попросите агента: «работай только на example.by».
- Сеть — запись запросов страницы; заголовки с ключами, куки и пароли
заменяются на
[redacted]. - Запись экрана — видео вкладки в MP4 или WebM. В запись попадает всё, что видно на странице, включая данные вашего аккаунта, — проверьте, прежде чем кому-то отправлять.
- Несколько браузеров — можно подключить, например, Chrome и Edge; новые сессии открываются в первом подключённом, если не указан другой.
Настройки
Заголовок раздела «Настройки»Правый клик по значку расширения → Параметры. Изменения действуют сразу.
- Где агент открывает вкладки — в вашем окне (по умолчанию) или в отдельном окне рядом, которое не забирает фокус.
- Группировка — одна общая группа для всех агентов (по умолчанию), своя свёрнутая группа на каждую сессию или без групп.
- Закрывать вкладки, которых агент не касался — через 10 минут (по умолчанию), 30, 60 или никогда. Вкладки, где идёт работа, ожидание вас или запись, не закрываются.
- Ввод как у человека — по умолчанию включён: плавное движение мыши и набор текста в темпе человека. Выключенный быстрее, но сайты легче распознают бота.
- Уведомления о передаче — только когда вкладка записывается (по умолчанию) или при каждой передаче.
- Обновления — ставить сами (по умолчанию), только сообщать или не проверять.
Агент тоже может менять эти настройки, если вы его попросите. Настройки безопасности и обновлений агенту недоступны.
Безопасность
Заголовок раздела «Безопасность»Агент работает в браузере, где вы вошли в свои аккаунты, поэтому расширение исходит из того, что прочитанная агентом страница или письмо могут пытаться им управлять, а другие программы на компьютере — подключиться к relay.
- Только свои вкладки. Агент видит и трогает только вкладки, которые открыл сам или которые вы ему отдали. Остальные ему недоступны.
- Relay — только для вас. Слушает лишь
127.0.0.1, каждый запрос требует токен из файла, доступного только вашему пользователю; запросы с чужих сайтов отклоняются. - Ключ на каждый браузер. Код сопряжения работает один раз; пять неверных кодов подряд аннулируют все ожидающие. Дальше браузер и relay на каждом подключении доказывают друг другу, что знают общий ключ.
- Ограничения отладчика. Агент читает и пишет куки только своих страниц; очистка кук, кэша и данных сайтов, закрытие браузера, выдача сайтам разрешений (камера, геолокация и т. п.) и вывод окна поверх — запрещены.
- Проверки «я не робот» агент не проходит — он сообщает о них и передаёт вкладку вам.
- Меньше следов на диске. Журналы сессий доступны только вам, введённые пароли и коды в них заменены, хранятся 14 дней.
- Код агента — это код от вашего имени. Сценарии агента выполняются в ограниченной среде (без доступа к файлам вне рабочих папок и к сети в обход браузера), но это не песочница: давайте браузер агенту, которому доверяете.
Что видит модель: страницы, которые агент читает, уходят модели, с которой работает агент, — как любые данные в его сессии. Расширение и relay ничего никуда больше не отправляют.
Разрешения расширения: debugger (управлять вкладками), tabs и tabGroups
(свои вкладки и их группа), scripting (карточка передачи — только во вкладках
агента), webNavigation (всплывающие окна агента — в его группу), storage,
alarms, notifications (сообщить, что агент ждёт вас) и доступ ко всем
сайтам — чтобы агент мог работать там, где вы попросите.
Браузер на другом компьютере
Заголовок раздела «Браузер на другом компьютере»Если агент работает на одном компьютере (например, на сервере), а браузер — на другом, relay запускают рядом с агентом и подключают к нему расширение по сети:
- На компьютере с агентом:
zubriq-browse set hostname 0.0.0.0. Команда напечатает адрес, порт и код сопряжения. - В браузере: Параметры расширения → дополнительно → в Адрес relay впишите адрес и порт того компьютера, введите код → Подключить.
Сама связь расширением не шифруется — используйте защищённую сеть (WireGuard,
Tailscale), а не открытый интернет. Вернуть всё на один компьютер:
zubriq-browse set hostname 127.0.0.1.
Команды
Заголовок раздела «Команды»| Команда | Что делает |
|---|---|
zubriq-browse install |
выбрать агентов, добавить им MCP-сервер, поставить и сопрячь расширение |
zubriq-browse status |
relay, расширение, вкладки агентов и что исправить (--json — для программ) |
zubriq-browse pair |
код для ручного сопряжения; --list, --revoke <браузер> |
zubriq-browse update |
обновить сейчас |
zubriq-browse relay restart |
перезапустить relay (после смены переменных окружения) |
zubriq-browse session … |
сессии: new, list, current, use, reset, delete; adopt — подключить к сессии вкладку, отданную кнопкой на панели, allow — ограничить сайты |
zubriq-browse settings get / settings set … |
настройки из командной строки |
zubriq-browse extension |
папка расширения для загрузки распакованным |
zubriq-browse uninstall |
убрать MCP-сервер из конфигов агентов |
zubriq-browse --help |
краткое руководство для агента и все команды |
Если что-то не так
Заголовок раздела «Если что-то не так»- Агент не видит браузер.
zubriq-browse statusскажет, чего не хватает: расширение не установлено, не сопряжено или устарело. После установки перезапустите агента — MCP-серверы подхватываются при старте. - «The browser isn’t answering» при сильно загруженном компьютере —
браузер просто медленный. Увеличьте
OPENCODE_BROWSER_EXTENSION_TIMEOUT_MSиOPENCODE_BROWSER_PING_TIMEOUT_MSи выполнитеzubriq-browse relay restart. - Расширение пишет, что не сопряжено —
zubriq-browse pairи введите код (см. выше). - Страница «зависла» — проверьте, нет ли на ней окна
alert/confirm: такие окна блокируют вкладку, закройте его и скажите агенту продолжать. - Журнал relay:
~/.local/state/zubriq-browse/logs/relay.log.