AIPex — браузерный агент, который живёт в вашем браузере

AIPex — это браузерный агент, который работает прямо в том браузере, где вы уже сидите. Ставится расширением для Chrome или Edge. Отдельный браузер не нужен, сессии никуда не переносятся. Команды можно вводить обычными словами прямо в окне расширения. А Cursor, Claude Code и другие агенты получают те же возможности через MCP.

Репозиторий открытый, лицензия MIT. У проекта около 1,3 тысячи звёзд и 133 форка. Основной язык — TypeScript.

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

Авторы AIPex сформулировали проблему просто. Большинство инструментов автоматизации браузера просят от вас одного и того же:

• поставить отдельный браузер, например Dia или Comet;
• платить ежемесячную подписку, как у ChatGPT Atlas;
• отдать свои данные о посещениях стороннему сервису.

Ответ проекта на это простой: зачем вообще переезжать, если автоматизация может работать в вашем браузере? Ставите расширение, подносите свой API-ключ и получаете автоматизацию на том же месте, где уже открыты нужные сайты.

Четыре обещания из README:

• Ноль миграции. Ничего не нужно устанавливать заново и ничему не придётся учиться.
• Открытый код. MIT-лицензия, весь код видно и можно править.
• Приватность. Данные не покидают вашу машину, ключ от модели свой (BYOK).
• Готовность к агентам. MCP, навыки и встроенный browser-cli работают через один и тот же локальный браузерный рантайм.

Почему это быстро

AIPex не запускает удалённый браузер и не открывает отдельный профиль автоматизации. Расширение работает внутри вашего браузера и выполняет действия напрямую через его API. Агент при этом общается с локальным демоном по WebSocket.

Есть четыре причины, почему такая схема быстрее:

• Локальный путь управления. Агент говорит с локальным демоном по WebSocket, а расширение сразу обращается к API браузера. Картинки по сети передавать не нужно.
• Сначала структура страницы, потом картинки. Агент ищет по текстовому снимку страницы шаблонами вида glob и grep и работает с элементами по их постоянным идентификаторам. Медленные циклы со скриншотами нужны только когда без них не обойтись.
• Нет цены переезда. Авторизации, cookie, вкладки, история и расширения уже на месте.
• Меньше токенов и задержек. Текстовый снимок и точечная работа с одним элементом обходятся дешевле, чем постоянная пересылка картинок всей страницы.

Быстрый старт

1. Поставьте расширение из Chrome Web Store или из Edge Add-ons.
2. Нажмите иконку AIPex на панели браузера.
3. Напишите голосом или текстом, что нужно сделать.

Сторонние ключи не нужны: расширение спрашивает API-ключ модели, который вы приносите сами.

Подключение к агентам через MCP

AIPex умеет отдавать браузер агентам, которые пишут код. Соединение идёт через Model Context Protocol (MCP). Схема такая:

AI-агент ──stdio──▶ aipex-mcp-bridge ──WebSocket──▶ AIPex Extension ──▶ Браузер

Сначала добавляете сервер в файл конфигурации агента.

Для Cursor (.cursor/mcp.json), Claude Desktop (claude_desktop_config.json) и Windsurf (mcp_config.json) блок одинаковый:

{
  "mcpServers": {
    "aipex-browser": {
      "command": "npx",
      "args": ["-y", "aipex-mcp-bridge"]
    }
  }
}

Для Claude Code есть одна команда:

claude mcp add aipex-browser -- npx -y aipex-mcp-bridge

Для VS Code Copilot (.vscode/mcp.json) используется ключ servers вместо mcpServers:

{
  "servers": {
    "aipex-browser": {
      "command": "npx",
      "args": ["-y", "aipex-mcp-bridge"]
    }
  }
}

Потом подключаете само расширение:

1. Откройте Chrome, нажмите иконку AIPex и перейдите в Options.
2. Укажите адрес WebSocket: ws://localhost:9223/extension.
3. Нажмите Connect.

После этого у агента появляется более 30 инструментов для работы с браузером. Подробности про дополнительные настройки — в файле mcp-bridge/README.md.

Работа из терминала: browser-cli

browser-cli раньше был отдельным проектом. Теперь он входит в пакет aipex-mcp-bridge и обращается к тому же локальному демону, что и MCP. Скрипты, задачи CI и агенты управляют вашим браузером без отдельного сервиса.

npm install -g aipex-mcp-bridge

browser-cli status
browser-cli tab list
browser-cli tab new https://example.com
browser-cli page search "button*" --tab 123
browser-cli interact click btn-42 --tab 123

Группы команд:

• tab — список, открытие, закрытие, переключение вкладок и просмотр их состояния;
• page — поиск по снимкам DOM, скриншоты, метаданные страницы, подсветка элементов;
• interact — клик, ввод текста, наведение, загрузка файлов и действия по координатам;
• download — сохранение картинок и картинок из чатов;
• intervention — запрос или отмена вмешательства человека во время автоматизации;
• skill — список, просмотр, загрузка и запуск навыков AIPex.

Нужен Node.js версии 18 или новее. Демон aipex-mcp-daemon поднимается сам, когда это нужно, один раз на всех клиентов и выключается после простоя. Порт по умолчанию — 9223, хост — 127.0.0.1. Для низкоуровневых вызовов инструментов остаётся aipex-cli.

Навык aipex-browser

В проекте есть готовый навык aipex-browser для рантаймов с протоколом навыков. Внутри собраны стратегия работы с инструментами, полные схемы параметров для всех более чем 30 инструментов и типовые сценарии автоматиции. Агенту не приходится разбираться с инструментами с нуля.

Полное описание навыка лежит в файле skill/SKILL.md.

Демонстрации

В репозитории есть демо с короткими видео. Задачи в них звучат так:

• «У меня открыто 100 вкладок, помоги»;
• «Исследуй эту тему, не выходя из моего браузера»;
• «Напиши твит за меня»;
• «Помоги сдать этот экзамен».

Что в планах

В разделе Roadmap перечислены четыре направления работы.

Понимание страниц. Дерево доступности и оптимизированный DOM уже сделаны. Работа с картинками (vision) пока в плане.

Работа с контекстом. Поиск по странице, выбрасывание ненужных частей снимка и работа по идентификаторам готовы.

Интеграции. Cursor и Claude Code уже подключены.

Навыки. Работа с файловой системой и выполнение скриптов уже реализованы.

Отдельно в плане оценка качества на наборе Online-Mind2Web.

Как устроен репозиторий

Проект собран как монорепозиторий на pnpm. Внутри шесть пакетов:

В разработке используются Biome для форматирования и проверок, knip для анализа зависимостей, TypeScript и vitest для тестов.

Ссылки

• AIPex на GitHub
• Документация к mcp-bridge
• Навык aipex-browser
• Расширение в Chrome Web Store
• Расширение в Edge Add-ons
• Model Context Protocol
• Лицензия MIT