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 делает аннотированный скриншот с виртуальным курсором.
Скриншот команды selftest: визуальные метки элементов и отображение позиции виртуального курсора в реальном времени.
Установка за 5 простых шагов
- Скачайте пакет: загрузите agent-chrome-bridge-2.2.0.zip или склонируйте репозиторий с GitHub.
- Откройте расширения Chrome: перейдите по адресу
chrome://extensionsи включите тумблер «Режим разработчика» (Developer mode) в правом верхнем углу. - Загрузите расширение: нажмите «Загрузить распакованное» (Load unpacked) и выберите папку
extension/. - Запустите сервер моста: запустите
start.bat(на Windows) или выполните./start.sh(на macOS / Linux). Скрипт проверит окружение Python 3.9+ и запустит локальный демон на127.0.0.1:8766. - Проверьте работу: откройте терминал и выполните команду:
Все 12 автоматических тестов должны завершиться со статусом 12/12 PASS.python server/br.py selftest
Справочник команд (CLI `br.py`)
python server/br.py status— проверка подключения расширения и статуса активной вкладки.python server/br.py open <url>— открытие адреса в новой вкладке агента.python server/br.py look— чтение видимого текста и списка интерактивных элементов с номерами.python server/br.py shot— создание скриншота страницы с метками в папкуserver/shots/.python server/br.py click <N>— клик по элементу с номеромNчерез доверенное CDP-событие.python server/br.py type <N> "текст"— ввод текста в поле номерN(поддерживает флаги--enterи--keys).python server/br.py key <Enter|Tab|Escape>— отправка аппаратного нажатия клавиши.python server/br.py scroll down [px]— плавная прокрутка страницы вниз или вверх.python server/br.py hover <N>— наведение курсора мыши на выпадающее меню.python server/br.py drag <A> <B>— перетаскивание элементаAна элементB.
Безопасность и ограничения
- 100% локально: сервер слушает исключительно петлевой интерфейс
127.0.0.1:8766. Сессии, куки и снимки экрана не передаются сторонним серверам. - Защита от сайтов: WebSocket проверяет заголовок Origin и принимает соединения только от установленного расширения. Чужие веб-страницы не могут отправлять команды мосту.
- Человек у руля: агенту категорически запрещено самостоятельно решать капчи, вводить мастер-пароли или подтверждать финансовые транзакции. Эти действия всегда выполняет владелец.
- Системные вкладки: Chrome не позволяет расширениям вмешиваться во внутренние страницы (
chrome://и магазин Chrome Web Store).
Часто задаваемые вопросы (FAQ)
Работает ли это с Claude Code, Cursor и Antigravity?
Да! Любой локальный агент, умеющий выполнять команды в терминале, может вызывать python server/br.py <команда>. В репозитории есть готовый файл AGENT_RULES.md, который достаточно скопировать в правила вашего агента.
Почему не Playwright или Selenium?
Playwright по умолчанию запускает чистый профиль без кук, закладок и расширений. Agent Chrome Bridge работает прямо в вашей открытой рабочей копии браузера, избавляя от повторных входов и двухфакторных авторизаций.
Что означает жёлтая полоса «управляется отладчиком»?
Это стандартное системное уведомление Chromium при подключении к Chrome DevTools Protocol. Оно подтверждает, что события мыши и клавиатуры генерируются на уровне движка браузера, а не через синтетические скрипты.