Octop Browser CLI
Браузер для агента на прямом CDP без Playwright: профили с логинами, CLI, MCP-сервер и запись сценариев в скилл
- 75 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент действует в браузере от вашего имени там, где вы вошли в профиле
- Действие `eval_js` выполняет произвольный JavaScript на открытой странице
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/octop-browserОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент действует в браузере от вашего имени там, где вы вошли в профиле
- Действие `eval_js` выполняет произвольный JavaScript на открытой странице
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Octop Browser запускает настоящий Chromium с флагом `--remote-debugging-port` и разговаривает с ним по протоколу Chrome DevTools сам, без прослойки Playwright. Элементы страницы агент получает как ссылки `ref` из живого дерева DOM, и эти ссылки остаются верными после перерисовки. Дерево DOM многоуровневое и компактное, поэтому на запрос уходит меньше токенов. Действий около двадцати: переход, клик, ввод, заполнение поля, нажатие клавиши, ожидание, прокрутка, снимок экрана, работа с вкладками, выполнение JavaScript. Каждое доступно командой `octop-browser` и инструментом MCP. Профиль с именем хранит логины на диске, поэтому повторный вход не нужен. Запись сценария снимает ваши действия в браузере и превращает их в черновик скилла командой `record generate-skill`. Воспроизведение идет через агента по смыслу шагов, без привязки к координатам. В папке `skills/` лежат готовые файлы скиллов на английском и китайском.
Для кого. Разработчикам агентов и тестировщикам, которым нужен управляемый браузер с постоянными логинами и малым расходом токенов.
Подходит, если
- Агент промахивается по элементам в Playwright после перерисовки страницы, и нужны ссылки из живого DOM
- Надо один раз войти в сервис вручную и дальше пускать агента в той же сессии профиля
- Повторяющееся действие в веб-интерфейсе хочется записать и превратить в черновик скилла
- Нужен MCP-сервер браузера для Claude Code или Cursor с запуском одной командой
Не подходит, если
- Нужен готовый набор для сквозных тестов с отчетами: это инструмент управления браузером, тестовой обвязки в нем нет
- Нужна поддержка Firefox или WebKit: запускается только Chromium
- Нужно закрыть доступ агента к браузеру с вашими логинами: профиль хранит вход на диске
Пример запроса к агенту
Открой страницу входа в профиле work, подожди, пока я войду, затем зайди в раздел отчетов и сделай снимок экранаОграничения
Нужен Python 3.11 или новее и бинарник Chromium, который команда `octop-browser install-browser` скачивает один раз; для этого она может разово подтянуть Playwright, но на выполнении он не нужен. Профиль хранит входы на диске, и агент действует от вашего имени в тех сервисах, куда вы вошли. Параметр `BROWSER_USE_IDLE_TIMEOUT_MINUTES` по умолчанию равен нулю, и Chrome не останавливается сам. Автор не публикует сравнений точности с другими инструментами, заявление о меньшем расходе токенов остается утверждением из README.
Как отключить. Закройте сеанс командой `octop-browser close-session --kill --profile <имя>` и удалите пакет `pip uninstall octop-browser`. Убрать записи MCP из конфига агента нужно отдельно. Данные профиля лежат на диске, удалите папку профиля, если логины больше не нужны.
Частые вопросы
Чем Octop Browser отличается от Playwright?
Он не использует Playwright во время работы и общается с Chromium по CDP напрямую. Playwright нужен только один раз, чтобы скачать бинарник браузера командой `install-browser`.
Как запустить MCP-сервер?
Командой `python -m octop_browser.mcp_server` или `make mcp` из клона. Транспорт stdio, каждое действие вынесено отдельным инструментом: `browser_navigate`, `browser_click` и так далее.
Где хранятся логины?
В профиле на диске. Его имя вы задаете ключом `--profile`, например `work`. Закрытие сеанса вход не стирает, и следующая команда подключится к тому же профилю.
Что делает запись сценариев?
Команда `record start` снимает действия в браузере, `record generate-steps` показывает смысловые шаги, а `record generate-skill` выдает черновик скилла `draft.skill.md`. Воспроизведение `replay run` ведет агент по смыслу шагов.
Нужны ли готовые скиллы?
В папке `skills/octop-browser` лежит английский SKILL.md, в `skills/octop-browser-zh` китайский. В них описано безопасное использование: ссылки вместо координат и отдельные профили для входа.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыБраузер и MCP-сервер для агентов: работа во вкладках с вашими входами, наблюдение за каждым шагом и ручной перехват
Локальный драйвер Playwright для вашего обычного Chromium-браузера: агент работает в живом профиле с логинами через расширение и relay
Плагин для Claude Code с MCP-сервером и семью скиллами: агент управляет настоящим браузером, написав код на Python
Отдельный браузер для агентов со скиллом и MCP: Claude Code и Codex работают в ваших аккаунтах, каждый сеанс записывается и доступен для просмотра
MCP и CLI, которые дают агенту управлять вашим настоящим Chrome с его логинами и расширениями через Playwright
Быстрый CLI на Rust для автоматизации браузера агентами: снимки доступности со ссылками на элементы, MCP-сервер и скиллы
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Octop Browser (эта карточка) | нет | 75 | ||
| Playwright MCP | да | не нужна | 39 570 | работает через Playwright |
| Browser Use | нет | 120 809 | CLI, скилл и Python-библиотека поверх CDP, без записи сценариев в скилл | |
| chrome-devtools-cli | нет | 256 | бинарник на Rust для вашего открытого Chrome, без профилей и записи |
Коротко о README
README подает инструмент как легкий браузер в духе browser-use с прямым CDP. Дальше идут таблицы действий, команды CLI, запись и воспроизведение сценариев, MCP-сервер и справочник по Python API. Отдельно сказано, что Playwright нужен лишь для первичной загрузки Chromium.