Перейти к содержимому

ZuBrIQ для Chrome — агент в вашем браузере

ZuBrIQ для Chrome даёт агенту ваш настоящий браузер: открытые вкладки, сайты, в которые вы уже вошли, ваши расширения. Агент открывает свои вкладки в фоне, читает страницы, нажимает, заполняет формы, делает скриншоты — а когда нужен человек (вход, код из СМС, оплата), отдаёт вкладку вам и ждёт.

Работает с ZubrCode и ZuBrIQ Desktop, а также с Claude Code, Codex, Cursor и другими агентами, которые умеют подключать MCP-серверы. Браузеры: Chrome, Edge, Brave, Arc, Helium, Vivaldi, Opera и Chromium.

Три части на вашем компьютере:

  1. Расширение в браузере — выполняет команды во вкладках через встроенный в Chrome отладчик.
  2. Relay — небольшой локальный процесс zubriq-browse, слушает только 127.0.0.1. Запускается сам, когда агенту нужен браузер.
  3. MCP-сервер zubriq-browse — через него агент получает инструменты браузера. Установщик сам прописывает его вашим агентам.

Агент → MCP-сервер → relay → расширение → вкладка. Расширение и relay один раз сопрягаются и дальше на каждом подключении проверяют общий ключ, поэтому другая программа на компьютере не сможет управлять вашим браузером через relay.

  1. Поставьте команду zubriq-browse:

    Окно терминала
    # macOS и Linux
    curl -fsSL https://zubriq.ai/browse.sh | sh
    Окно терминала
    # Windows (PowerShell)
    irm https://zubriq.ai/browse.ps1 | iex

    Установщик кладёт zubriq-browse в ~/.local/bin и сразу запускает zubriq-browse install.

  2. Выберите агентов. Найденные на компьютере отмечены сразу: пробел — отметить, Enter — подтвердить. Установщик добавит им MCP-сервер zubriq-browse. Повторный запуск только добавляет — снятая галочка ничего не удаляет.

  3. Добавьте расширение. Установщик откроет страницу «ZuBrIQ для Chrome» в Chrome Web Store — нажмите «Установить». Как только расширение появится, установщик сам сопряжёт его с relay, ничего копировать не нужно.

  4. Перезапустите агента (или начните новую сессию), чтобы он увидел новый 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 запускают рядом с агентом и подключают к нему расширение по сети:

  1. На компьютере с агентом: zubriq-browse set hostname 0.0.0.0. Команда напечатает адрес, порт и код сопряжения.
  2. В браузере: Параметры расширения → дополнительно → в Адрес 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.