Проблема браузерного автоматизации
Большинство современных веб-сайтов, даже не имеющих официального API, используют внутренние (first-party) API для взаимодействия с бэкендом. Традиционные AI-агенты вынуждены использовать полные браузеры (Selenium, Puppeteer) для имитации действий пользователя, что ресурсоемко и медленно. Проект Unbrowse решает эту проблему, извлекая эти скрытые API через обратный инжиниринг.
Как это работает: Discover, Run, Learn
Система работает в три этапа:
- Discover (Поиск): Unbrowse проверяет локальные возможности агента и публичный реестр уже созданных инструментов для целевого сайта.
- Run (Запуск): Если инструмент найден, агент воспроизводит HTTP-запросы сайта напрямую, без запуска браузера. Результат верифицируется перед возвратом.
- Learn (Обучение): Если совпадений нет, агент выполняет задачу в облачном браузе Unbrowse или пользователь загружает два HAR-файла (записи трафика). Система компилирует их в новый инструмент «one-call capability» для будущего использования.
Ключевые метрики эффективности
По данным разработчиков, переход с браузерного автоматизирования на прямые API-запросы дает кратный прирост производительности:
| Метрика | Браузер (Selenium/Puppeteer) | Unbrowse (Direct API) |
|---|---|---|
| Скорость выполнения | Базовая | В 50-100 раз быстрее |
| Стоимость запроса | Базовая | На 95% дешевле |
| Безопасность паролей | Часто требуются полные куки/сессии | Пароли хранятся в менеджере Unbrowse, CLI их не видит |
Интеграция с AI-агентами
Unbrowse предоставляет SDK для TypeScript и CLI-инструмент. Поддержка интегрирована в популярные платформы через MCP (Model Context Protocol) и плагины:
- Поддерживаемые платформы: Claude Code, Codex, Grok Build, OpenClaw, Hermes, elizaOS.
- Методы подключения: REST API (через SDK), MCP (через
https://unbrowse.ai/mcp), или локальный stdio-прокси. - Пример команды:
npx unbrowse run 'top stories on hacker news'— выполнение задачи с верификацией результата.
Технические детали и безопасность
Проект открыт под лицензией MIT. Ключевые особенности CLI:
- Поддержка OAuth-авторизации через браузер (
npx unbrowse login). - Команды имеют четкие коды выхода: 0 (успех), 1 (ошибка), 2 (требуется ввод), 3 (нужен вход), 4 (результат не верифицирован).
- Возможность загрузки HAR-файлов для обучения системы новым сайтам через
unbrowse learn a.har b.har.
Полная документация и исходный код доступны на GitHub-репозитории unbrowse-ai/unbrowse.
Источник: Github ↗