Как дать ИИ-агенту (Claude Code, Antigravity, Cursor) глаза и руки в вашем Chrome — без headless-браузеров
Большинство ИИ-ассистентов для разработки (Claude Code, Cursor, Google Antigravity, Codex) работают в песочнице терминала. Как только агенту нужно заглянуть в Google Search Console, Яндекс Вебмастер или панель Cloudflare, он упирается в вход в аккаунт: в его браузере нет ваших сессий.
Мы сделали бесплатный открытый инструмент Agent Chrome Bridge. Это расширение для Chrome и маленький локальный сервер: агент работает в вашем обычном браузере, где вы уже вошли во все нужные сервисы.
Почему не Playwright или Selenium
Headless Playwright и изолированные контейнеры запускают пустой профиль: без кук, закладок и расширений. Если попросить агента проверить индексацию или настроить DNS, ему придётся просить пароли, или задача останется нерешённой.
Agent Chrome Bridge подключается к вашему открытому Chrome через Chrome DevTools Protocol (CDP). Агент видит открытые вкладки и кнопки, вводит текст и нажимает кнопки доверенными событиями мыши и клавиатуры — сайт видит их так же, как действия человека.
Как агент видит страницу
Вместо хрупких CSS-селекторов команда look размечает все кнопки и поля на странице номерами: [1], [2], [3]. Агенту достаточно сказать «нажми 3» или «введи текст в 5».
Команда shot делает скриншот с этими номерами и виртуальным курсором — агент видит, куда он сейчас наведён, и может проверить результат своего действия.
Установка за 5 шагов
- Скачайте архив agent-chrome-bridge-2.2.0.zip со страницы проекта и распакуйте его.
- Откройте chrome://extensions и включите «Режим разработчика».
- Нажмите «Загрузить распакованное» и выберите папку extension.
- Запустите start.bat на Windows или bash start.sh на macOS / Linux.
- Выполните python server/br.py selftest — должно быть 12/12 PASS.
Проверено на Windows 11 и Linux, на macOS пока не тестировалось. На macOS / Linux вместо python используйте python3. Нужен Python 3.9 или новее — стартовый скрипт сам создаст для моста отдельное окружение.
Основные команды
- br.py status — подключено ли расширение и какая вкладка активна.
- br.py open адрес — открыть страницу в новой вкладке агента.
- br.py look — видимый текст и список кнопок и полей с номерами.
- br.py shot — скриншот с номерами и курсором агента.
- br.py click N — клик по элементу номер N.
- br.py type N "текст" — ввод текста в поле номер N.
- br.py key Enter, scroll down, hover N, drag A B — клавиши, прокрутка, наведение и перетаскивание.
Безопасность и ограничения
- Только локально: сервер слушает лишь 127.0.0.1:8766, куки и скриншоты никуда не отправляются. Пока сервер запущен, им может воспользоваться любая программа на вашем компьютере, поэтому выключайте его, когда агент не работает.
- Защита от сайтов: сервер отклоняет запросы с веб-страниц (проверка заголовков Origin и Host), поэтому открытый в браузере сайт не может отправить команду мосту.
- Решения за человеком: мост не обходит капчи, а готовые правила AGENT_RULES.md из архива запрещают агенту вводить пароли и подтверждать оплату.
- Системные страницы chrome:// и Chrome Web Store расширениям недоступны — это ограничение самого Chrome.
Пока агент работает, Chrome показывает жёлтую полосу «управляется отладчиком». Это нормально: так Chrome сообщает о подключении через DevTools Protocol. Если закрыть полосу, мост отключится от вкладки.
Где скачать
Инструмент бесплатный, код открыт (лицензия MIT). Страница проекта с инструкцией: vault-pro.rashid-salimov96.workers.dev/agent-chrome-bridge. Архив можно скачать напрямую: agent-chrome-bridge-2.2.0.zip (56 КБ).
Вопросы и предложения пишите в комментариях или мне в Telegram: @Rashid_Salimov.