OpenTiny WebMCP SDK CLI
webmcp-cli из OpenTiny управляет страницей в Chrome через MCP-инструменты, а навык из набора учит агента им пользоваться.
- 125 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент управляет настоящим окном Chrome: кликами, вводом и сессиями открытых сайтов.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/opentiny-webmcp-sdkОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент управляет настоящим окном Chrome: кликами, вводом и сессиями открытых сайтов.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
OpenTiny NEXT-SDKs реализует WebMCP: страница описывает свои действия как инструменты, а агент их вызывает. Для агентов в наборе два артефакта. Это `webmcp-cli`, который запускает в фоне Chrome через Puppeteer и превращает клики, ввод и прокрутку в вызовы MCP-инструментов, и каталог `packages/webmcp-skill` с навыками. Агент открывает страницу командой `webmcp-cli tabs open`, смотрит состояние с индексированным DOM через `webmcp-cli state` и действует через `webmcp-cli run`. Навык читает `SKILL.md`, а подчиненные навыки, например для Excalidraw, подсказывают формат команд на конкретном сайте. Полифил `document.modelContext` работает и на страницах без правки исходников.
Для кого. Фронтенд-разработчикам и тестировщикам, которые хотят дать агенту управлять веб-приложением без отдельного драйвера под каждый сайт.
Подходит, если
- Агент рисует диаграмму в Excalidraw, вызывая инструмент страницы.
- Нужно проверить сценарий в веб-приложении, управляя кнопками и полями по индексам DOM.
- Собственное приложение стоит открыть для ИИ-управления через `registerTool` с минимальной правкой кода.
- Внутренний сайт без API надо обойти агентом по схеме клика и ввода.
Не подходит, если
- Хватает скрейпинга без окна браузера или готового Playwright MCP.
- В окне Chrome открыты рабочие аккаунты, которые не должен трогать агент.
- Нужен промышленный сервис с поддержкой: нативный WebMCP в браузерах пока экспериментальный.
Пример запроса к агенту
Открой excalidraw.com, покажи состояние страницы и нарисуй прямоугольник, подписав его словом «вход».Ограничения
Нативный WebMCP в браузерах пока экспериментальный, и по умолчанию SDK принудительно использует свой полифил: нативная версия способна обрушить рендерер на вызове `getTools()`. Агент управляет настоящим Chrome, поэтому открывайте отдельный профиль без рабочих аккаунтов. Команды установки и полный список навыков держатся в документации проекта. Основная часть README посвящена SDK для разработчиков, а CLI занимает отдельный раздел.
Как отключить. Удалите навык `webmcp-skill` из каталога агента и пакет командой `npm uninstall -g @opentiny/webmcp-cli`. Закройте окно Chrome, которое открывала команда.
Частые вопросы
Что такое WebMCP?
Расширение протокола MCP для браузера: страница отдает агенту свои инструменты и ресурсы через `document.modelContext`. Пока нативный API экспериментальный, SDK добавляет полифил.
Как агент видит страницу?
Команда `webmcp-cli state` возвращает адрес, заголовок, вкладки, список MCP-инструментов и дерево DOM с индексами вида `[18]<button>`. Дальше `webmcp-cli run page-agent-tool` кликает по индексу или вводит текст.
Нужно ли менять код сайта?
Нет, полифил подхватывает чужие страницы без правки. Для собственных приложений инструменты объявляют через `registerTool` и получают точные действия вместо кликов по DOM.
Что лежит в webmcp-skill?
Каталог `packages/webmcp-skill` с `SKILL.md` и подчиненными навыками. Один описывает рисование в Excalidraw, другой поиск на Baidu.
Какой браузер нужен?
Chrome: `webmcp-cli` запускает его в фоне через Puppeteer. Страницу открывают командой `webmcp-cli tabs open` с нужным адресом.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер и расширение Chrome, которые дают агенту управлять вашим уже открытым браузером с вашими авторизованными сессиями, все локально
Локальный веб-поиск для агентов: ищет, читает страницы и отдает сжатые фрагменты с источниками, экономя токены контекста
CLI, расширение Chrome, SDK и MCP-сервер, которые дают агенту управлять вашим настоящим Chrome вне зависимости от среды агента
Официальный MCP-сервер команды Chrome DevTools: агент управляет живым Chrome, смотрит сеть, консоль и записывает трейсы производительности
Расширение Chrome с MCP-сервером: агент управляет вашим обычным браузером с его сессиями, вкладками, закладками и историей
Консольный браузер mb для агентов: переход по адресу, снимок страницы, клики, формы, скриншоты и запись экрана
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| OpenTiny WebMCP SDK (эта карточка) | нет | 125 | ||
| Playwright MCP | да | не нужна | 39 570 | управляет браузером через снимки доступности; webmcp-cli работает по индексам DOM и вызывает инструменты WebMCP самой страницы |
| Chrome DevTools MCP | да | не нужна | 55 199 | отладка и профилирование страниц; здесь управление страницей и полифил WebMCP |
Коротко о README
Набор состоит из WebMCP-полифила, пакетов для клиента и сервера, чат-компонента и CLI с навыками для агентов.