// gsd-build/gsd-browser GSD Browser

01Зачем это нужно

AI-агенты упираются в стену, когда нужно протестировать UI или провзаимодействовать с веб-приложением. Playwright тяжёл, требует Node.js рантайма и драйверов. Selenium — наследие. Готовые SaaS — стоят денег и ограничены.

gsd-browser — single Rust binary. Без рантайма, без драйверов, без зависимостей. 63 команды покрывают всю поверхность браузер-автоматизации. Запустил, использовал, забыл.

02Установка

One-liner (macOS / Linux)

$ curl -fsSL https://raw.githubusercontent.com/gsd-build/gsd-browser/main/install.sh | bash

Скачивает бинарник + Chromium автоматически. Работает в CI.

npm

$ npm install -g @gsd-build/gsd-browser

Cargo (из исходников)

$ cargo install gsd-browser

Pre-built бинарники

Скачать с GitHub Releases:

03Быстрый старт

# Перейти на страницу $ gsd-browser navigate https://example.com

# Сделать скриншот $ gsd-browser screenshot --output page.png --format png

# Получить дерево accessibility $ gsd-browser accessibility-tree # Кликнуть на кнопку по CSS-селектору $ gsd-browser click "button.submit" # Извлечь структурированные данные $ gsd-browser extract --schema '{"title": {"_selector": "h1"}}'

0463 команды в 15 категориях

Полный набор для любых задач браузер-автоматизации. Каждая команда поддерживает --json для структурированного вывода.

05Ключевые отличия

06Конфигурация

5-слойный merge конфигов:

1. Built-in defaults — разумные значения для всего
2. User config — ~/.gsd-browser/config.toml
3. Project config — ./gsd-browser.toml в корне проекта
4. Environment variables — префикс GSD_BROWSER_*
5. CLI flags — высший приоритет, перебивают всё

Пример gsd-browser.toml

[browser]
path = "/usr/bin/chromium"
headless = true

[daemon]
port = 9222
host = "127.0.0.1"

[screenshot]
quality = 90
full_page = false

[settle]
timeout_ms = 500
poll_ms = 40
quiet_window_ms = 100

Через переменные окружения

$ export GSD_BROWSER_BROWSER_PATH=/usr/bin/chromium
$ export GSD_BROWSER_DAEMON_PORT=9333

07Архитектура

┌─────────────┐     IPC/HTTP      ┌──────────┐      CDP       ┌─────────┐
│  CLI (clap) │ ───────────────→ │  Daemon   │ ────────────→ │ Chrome  │
│  browser-   │ ←─────────────── │  (tokio)  │ ←──────────── │  (CDP)  │
│  tools      │   JSON response  │           │   events       │         │
└─────────────┘                  └──────────┘                └─────────┘
       │                                │
       │ --json flag                    │ manages
       ▼                                ▼
  Структурированный             Browser lifecycle
  JSON-вывод для агентов        Изоляция сессий
                                 Page/frame routing

CLI парсит команды и делегирует daemon'у через локальный HTTP-канал. Daemon поддерживает persistent CDP-соединение с Chrome, управляет lifecycle браузера, маршрутизирует команды к нужной странице/фрейму. Daemon стартует автоматически при первом использовании и сохраняется между командами для быстрого выполнения.

08JSON-вывод

Каждая команда поддерживает --json для структурированного вывода:

$ gsd-browser navigate https://example.com --json # {"title":"Example Domain","url":"https://example.com/","status":"ok"} $ gsd-browser find --text "More information" --json # {"elements":[{"role":"link","name":"More information...","selector":"a"}]}

09Для AI-агентов

gsd-browser шипится с SKILL.md и AGENTS.md для автоматического discovery агентами. Агенты могут:

10Глоссарий