axuse — MCP-сервер для управления браузером и рабочим столом
axuse
MCP-сервер без зависимостей: агент ведет Chrome по дереву доступности и CDP и получает разницу снимков вместо скриншотов
- 804 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент кликает, вводит текст и загружает файлы от вашего имени, а в режиме моста работает в браузере с вашими входами в сервисы
- Инструмент выполняет произвольный код на страницах через `ax_evaluate` и управляет окнами рабочего стола, включая ввод на уровне системы
- Возможности вроде скрытия признаков автоматизации и подключения решателей капч двойного назначения: автоматизация вопреки правилам сайта ведет к блокировке аккаунтов и может нарушать закон
Установка
- Работает в
Ручная установка
git clone https://github.com/ctoldigital/axuse.git && cd axuse && node src/cli.js doctorНужен Node.js 22 или новее. Команда doctor находит браузер, запускает его и делает пробный снимок. Для сервера без браузера и без прав администратора есть `node src/cli.js install-browser`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент кликает, вводит текст и загружает файлы от вашего имени, а в режиме моста работает в браузере с вашими входами в сервисы
- Инструмент выполняет произвольный код на страницах через `ax_evaluate` и управляет окнами рабочего стола, включая ввод на уровне системы
- Возможности вроде скрытия признаков автоматизации и подключения решателей капч двойного назначения: автоматизация вопреки правилам сайта ведет к блокировке аккаунтов и может нарушать закон
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
axuse дает агенту работать в браузере через дерево доступности страницы и протокол CDP без цикла из скриншотов. Вызов `ax_open` возвращает полный снимок страницы с устойчивыми ссылками вроде `[ref=e7]`, а каждое следующее действие (`ax_click`, `ax_fill`, `ax_type`) отвечает только разницей: что убрано, что добавлено, что изменилось. Ввод идет настоящими событиями CDP, ошибки приходят типизированными кодами вроде `REF_NOT_FOUND` и `STALE_STATE` с подсказкой, стоит ли повторять. Инструментов браузера больше двадцати: открытие списка адресов за раз (`ax_open_many`), заполнение целой формы одним вызовом (`ax_fill`), поиск строки на большой странице, прокрутка до текста, загрузка файлов, работа с диалогами и вкладками. Для настольных окон есть отдельная группа `ax_desktop_*`: скриншоты, клики, ввод, окна. На Windows ее проверил автор, на Linux она включается сама в сессиях X11 и XWayland, на macOS ее открывают переменная `AXUSE_ENABLE_MACOS_CUA=1` и системные права. Можно управлять и вашим обычным Chrome или Edge: расширение с нативным мостом подключается к уже открытому профилю, где вы вошли в сервисы. Файл `SKILL.md` в репозитории описывает для модели порядок работы с инструментами.
Для кого. Для разработчиков и тестировщиков, у которых Claude Code, Codex или OpenCode ходят по сайтам и интерфейсам, и скриншотный цикл тратит слишком много токенов и ошибается мимо кнопок.
Подходит, если
- Агенту нужно пройти многошаговый сценарий в браузере: форму, оформление заказа или регистрацию с ошибками валидации
- Нужно пакетно открыть список ссылок и получить заголовки с выдержками из дерева доступности, для этого есть `ax_open_many` и команда `open-urls`
- Требуется работа в уже открытом Chrome или Edge с вашей авторизацией
- Вы тестируете локальное приложение с вложенными iframe, виртуализированными таблицами и выбором дат
- Нужен контроль расходов: лимиты на размер снимка, число узлов и размер скриншота заданы в коде
Не подходит, если
- Основная задача — визуальная сверка макета или рисование на элементе `canvas`: скриншоты в axuse вспомогательные и ограничены бюджетом по размеру
- Нужно решать капчи сразу после установки: ядро решателей не содержит, они ставятся отдельными платными пакетами
- Вы собираетесь обходить защиту от ботов: сайты, которые распознают автоматизацию, все равно могут заблокировать axuse, а условия сервисов часто запрещают автоматизированные действия
- На машине нет Node.js 22 или новее и поставить его нельзя: зависимостей у сервера нет, но версия рантайма задана жестко
Пример запроса к агенту
Открой http://localhost:3000, заполни форму регистрации тестовыми данными одним вызовом ax_fill, нажми «Создать аккаунт» и покажи, какие ошибки валидации появилисьMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
AXUSE_BROWSER- Путь к бинарному файлу браузера, если сервер не нашел его сам
AXUSE_PROXYсекрет- Прокси для всех запускаемых браузеров, учетные данные допускаются
AXUSE_ENABLE_MACOS_CUA- Значение 1 включает инструменты рабочего стола на macOS
Ограничения
Лицензия PolyForm Noncommercial 1.0.0: бесплатно только для некоммерческих целей, правообладатель CTOL Digital Solutions. Для работы нужен Node.js 22 или новее и браузер семейства Chromium, который сервер находит сам или берет из `AXUSE_BROWSER`.
В режиме расширения нет домена Target, поэтому фреймы из других источников там только перечисляются, а входит в них режим CDP. Автор отмечает, что настоящий Chrome с версии 137 тихо игнорирует автоматическую загрузку расширений, и ее нужно выполнять на Edge, Chromium или Chrome for Testing, а вручную распакованное расширение работает везде. Сайты, которые распознают автоматизацию, могут заблокировать сервер: он не ставит на свой трафик пометку в стиле Codex.
Управление рабочим столом macOS включается явно, потому что оно создает события ввода уровня системы. Решатели капч и функции вроде хранилища сессий поставляются отдельными платными плагинами с общим интерфейсом в `src/plugins`.
Как отключить. Удалите сервер из агента: `claude mcp remove axuse` в Claude Code или `codex mcp remove axuse` в Codex. Если вы подключали мост к своему браузеру, снимите нативный хост по документации репозитория и отключите распакованное расширение на странице расширений.
Частые вопросы
Как подключить axuse к Claude Code?
Склонируйте репозиторий и проверьте окружение командой `node src/cli.js doctor`. Затем выполните `claude mcp add --scope user axuse -- node /абсолютный/путь/axuse/src/cli.js mcp`. Для Codex подходит `codex mcp add axuse -- node /абсолютный/путь/axuse/src/cli.js mcp`.
Чем axuse отличается от управления браузером по скриншотам?
Вместо картинок он читает дерево доступности: после каждого действия агент получает только изменившиеся строки. Автор сообщает о замерах на 16 заданиях с тем же агентом и моделью: медиана времени и расход токенов оказались ниже, чем у расширения Chrome для Codex и у browser-use.
Можно ли управлять своим обычным Chrome?
Да. Выполните `axuse bridge install`, загрузите распакованное расширение из `bridge/extension` в Chrome или Edge и вызовите `ax_open`: пока расширение подключено, сервер выбирает его сам. Вкладки, куда вы вошли в сервисы, остаются вашими, `ax_close` закрывает только вкладки axuse.
Нужен ли браузер, если сервер без графики?
Да, но его можно поставить без прав администратора командой `node src/cli.js install-browser`: она кладет закрепленную версию Chrome for Testing в `~/.cache/axuse`. На сервере без экрана по умолчанию поднимается собственный Xvfb, и браузер работает с окном: безголовый режим сервер не использует.
Подходит ли axuse для коммерческих проектов?
Только по отдельной лицензии. Публичная лицензия PolyForm Noncommercial 1.0.0 разрешает некоммерческое использование, а для бизнеса нужно договориться с CTOL Digital Solutions.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-мост для управления вашим браузером из кодового агента: расширение Chrome и набор инструментов автоматизации вкладок и страниц
CLI и скилл для управления Chrome из агента: снимок страницы, клики, консоль, сеть и аудит производительности в экономном выводе
Агент работает в вашем настоящем Chrome с уже выполненными входами: CLI, MCP и расширение с отдельной группой вкладок
MCP-сервер и расширение Chrome дают агенту 22 инструмента для вашего браузера с входами и проверкой каждого действия.
MCP-сервер и расширение Chrome, которые дают агенту управлять вашим уже открытым браузером с вашими авторизованными сессиями, все локально
CLI и MCP-сервер, через которые агент управляет вашим настоящим Chrome с сохраненными входами: 103 команды к 36 сайтам и автоматизация браузера
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| axuse — MCP-сервер для управления браузером и рабочим столом (эта карточка) | нет | не нужна | 804 | |
| Chrome DevTools MCP | да | не нужна | 55 199 | официальный MCP команды Chrome DevTools с упором на отладку, сеть и трассы производительности |
| Playwright CLI | да | 15 167 | официальный CLI Playwright, который управляет браузером короткими командами без схем MCP |
Коротко о README
Документ сравнивает цикл на скриншотах с подходом axuse по восьми признакам: наблюдение, адресация, ввод, ошибки, обнаружение изменений, контроль стоимости. Дальше идут архитектура с общим ядром и двумя бэкендами, список инструментов и примечания по объему поддержки. В конце названы тесты и условия лицензии.