Agent Chrome Bridge

Обновлено: 16 ноября 2026

Бесплатный открытый инструмент, дающий локальным ИИ-ассистентам (Google Antigravity, Claude Code, Cursor, Codex) возможность взаимодействовать с реальным браузером Google Chrome, где уже выполнены все ваши входы и сохранены рабочие сессии.

Зачем это нужно

Обычные песочницы для ИИ (headless Playwright, изолированные контейнеры) запускают пустой браузер. В нём нет ваших авторизаций в Google Search Console, Яндекс Вебмастере, GitHub, Cloudflare или внутренних панелях. Если попросить агента проверить индексацию или настроить DNS, ему придётся либо запрашивать пароли, либо задача останется нерешённой.

Agent Chrome Bridge решает эту проблему: расширение подключается к вашему обычному Chrome через Chrome DevTools Protocol (CDP). Агент получает доступ к открытым вкладкам, видит интерактивные элементы и может нажимать на кнопки с помощью доверенных аппаратных событий.

Как это выглядит для агента

Вместо хрупких CSS-селекторов команда look размечает все кнопки и поля ввода на странице порядковыми номерами ([1], [2]), а команда shot делает аннотированный скриншот с виртуальным курсором.

Интерфейс самотестирования Agent Chrome Bridge: нумерация элементов и визуальный курсор

Скриншот команды selftest: визуальные метки элементов и отображение позиции виртуального курсора в реальном времени.

Установка за 5 простых шагов

  1. Скачайте пакет: загрузите agent-chrome-bridge-2.2.0.zip или склонируйте репозиторий с GitHub.
  2. Откройте расширения Chrome: перейдите по адресу chrome://extensions и включите тумблер «Режим разработчика» (Developer mode) в правом верхнем углу.
  3. Загрузите расширение: нажмите «Загрузить распакованное» (Load unpacked) и выберите папку extension/.
  4. Запустите сервер моста: запустите start.bat (на Windows) или выполните ./start.sh (на macOS / Linux). Скрипт проверит окружение Python 3.9+ и запустит локальный демон на 127.0.0.1:8766.
  5. Проверьте работу: откройте терминал и выполните команду:
    python server/br.py selftest
    Все 12 автоматических тестов должны завершиться со статусом 12/12 PASS.

Справочник команд (CLI `br.py`)

Безопасность и ограничения

Часто задаваемые вопросы (FAQ)

Работает ли это с Claude Code, Cursor и Antigravity?

Да! Любой локальный агент, умеющий выполнять команды в терминале, может вызывать python server/br.py <команда>. В репозитории есть готовый файл AGENT_RULES.md, который достаточно скопировать в правила вашего агента.

Почему не Playwright или Selenium?

Playwright по умолчанию запускает чистый профиль без кук, закладок и расширений. Agent Chrome Bridge работает прямо в вашей открытой рабочей копии браузера, избавляя от повторных входов и двухфакторных авторизаций.

Что означает жёлтая полоса «управляется отладчиком»?

Это стандартное системное уведомление Chromium при подключении к Chrome DevTools Protocol. Оно подтверждает, что события мыши и клавиатуры генерируются на уровне движка браузера, а не через синтетические скрипты.