gsd-browser CLI
Нативный CLI на Rust для Chrome через CDP: более 90 команд, MCP-сервер на 50 инструментов и постоянный демон со снимками.
- 60 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Управляет настоящим Chrome и хранит входы и состояние сессий, а значит открывает агенту аккаунты.
- Размещенный MCP по HTTP, открытый в сеть, защищен лишь токеном доступа.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/gsd-browserОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Управляет настоящим Chrome и хранит входы и состояние сессий, а значит открывает агенту аккаунты.
- Размещенный MCP по HTTP, открытый в сеть, защищен лишь токеном доступа.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
gsd-browser управляет Chrome и Chromium по протоколу CDP. Фоновый демон стартует при первом вызове и держит сессию, а команды покрывают навигацию, взаимодействие, снимки со ссылками на элементы, проверки, структурное извлечение, сетевые правила, визуальное сравнение, трассировку и запись. Он рассчитан на агентов, CI и разработчиков, которым нужен детерминированный контроль браузера без тяжелого тестового фреймворка. Команда `gsd-browser mcp` запускает MCP-сервер с более чем 50 инструментами, живыми ресурсами и готовыми сценариями, например для входа, аудита страницы и сбора доказательств. Есть режимы stdio и размещенный HTTP с токеном доступа. Дополнительно доступны зашифрованное хранилище входов, сохранение состояния, имитация устройств и проверка страниц на скрытые инструкции для модели.
Для кого. Разработчикам агентов и тестировщикам, которым нужен быстрый детерминированный контроль настоящего браузера с общим просмотром и записью доказательств.
Подходит, если
- Агент проходит многошаговый сценарий в вебе, а результат надо подтвердить записью и снимками.
- Нужны проверки на странице: ожидания, утверждения и сравнение скриншотов с эталоном.
- Сеть надо подменить или заблокировать при проверке, а потом выгрузить HAR или PDF.
- Облачный клиент MCP подключается к размещенному серверу по HTTP с токеном.
Не подходит, если
- Нужен браузер без Chrome или Chromium: инструмент работает через CDP.
- Нужны готовые тесты уровня большого фреймворка: это инструмент управления, а не набор тестов.
- Сервер должен быть открыт в сеть без защиты: HTTP-режим требует токена.
Пример запроса к агенту
Открой страницу входа в тестовое окружение, пройди форму, сними снимок и сохрани запись шагов с доказательствами.Ограничения
Инструмент ведет живой Chrome, поэтому вход, куки и сохраненные сессии дают агенту доступ к аккаунтам, и это стоит держать в отдельном профиле. HTTP-режим MCP открывают в сеть только с `GSD_BROWSER_MCP_AUTH_TOKEN` и по HTTPS. Опциональная проверка токенов `GSD_BROWSER_MCP_AUTH_VERIFY_URL` отправляет запросы консоли OpenGSD и учитывает бесплатную квоту. Релизы идут быстро: у npm `latest` версия 0.1.29, а `dev` совпадает с релизом 0.1.31. Последний коммит в репозитории сделан в сентябре 2026.
Как отключить. Остановите демон, удалите пакет командой `npm uninstall -g @opengsd/gsd-browser` и уберите запись `gsd-browser` из конфигурации MCP. Для плагина Codex снимите папку `~/plugins/gsd-browser`.
Частые вопросы
Как подключить к Cursor или Claude Desktop?
Запустите `gsd-browser mcp` как stdio-сервер и укажите его в конфигурации клиента. Для быстрой настройки есть `./scripts/mcp-quickstart.sh` с вариантами claude, cursor, vscode и generic.
Как открыть сервер для удаленных клиентов?
Задайте `GSD_BROWSER_MCP_AUTH_TOKEN` и выполните `gsd-browser mcp --http --host 0.0.0.0 --port 8788`. Адрес `/mcp` выставляют по HTTPS, клиент передает заголовок `Authorization: Bearer`.
Как поставить плагин Codex?
Командой `curl -fsSL https://raw.githubusercontent.com/open-gsd/gsd-browser/main/install.sh | bash -s -- --codex-plugin`. Она ставит CLI, пишет плагин в `~/plugins/gsd-browser` и регистрирует его.
Что такое снимок с версионными ссылками?
Снимок страницы, где элементы получают ссылки с версией. Агент обращается к элементам по ссылкам и не теряет их при перерисовке страницы.
Нужна ли установка без npm?
Нет. Есть готовые бинарники в релизах GitHub и сборка через `cargo install --path cli`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыБыстрый CLI на Rust для автоматизации браузера агентами: снимки доступности со ссылками на элементы, MCP-сервер и скиллы
Бинарник на Rust без MCP-сервера: агент ведет ваш открытый Chrome или Edge, а вкладки закрепляются метками target.
browser-debugger-cli (bdg)
browser-debugger-cli
CLI bdg держит Chrome открытым в фоне и отдает агенту сеть, консоль, куки и стили короткими командами, без скриншотов и MCP.
Агент работает в вашем настоящем Chrome с уже выполненными входами: CLI, MCP и расширение с отдельной группой вкладок
CLI, скилл и MCP для управления Chrome короткими скриптами Puppeteer, вкладки сохраняют состояние между вызовами
Скилл для Amp, Claude Code и Cursor: агент управляет вашим живым Chrome с открытыми вкладками и входами в аккаунты через один переключатель отладки
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| gsd-browser (эта карточка) | нет | 60 | ||
| agent-browser | да | не нужна | 50 530 | быстрый CLI на Rust для автоматизации браузера со снимками доступности и MCP; gsd-browser добавляет запись доказательств, хранилище входов и совместный просмотр |
| Browser Harness | нет | 19 048 | управляет вашим настоящим Chrome через DevTools Protocol от Browser Use; gsd-browser держит постоянный демон и более 50 инструментов MCP |
Коротко о README
Проект собран на Rust и держит постоянный демон, поэтому следующие команды быстры. Основной путь для агентов лежит через MCP: ресурсы возвращают живой снимок, состояние и хронологию, а промпты задают многошаговые сценарии.