Язык: Русский | English
aget - помощник для браузерных сценариев LLM-агентов. CLI запускает управляемый CloakBrowser stealth Chromium, хранит локальные сессии и возвращает машинно-читаемый JSON.
npm i -g agent-aget
aget versionПри npm i -g agent-aget пакет скачивает native aget и пытается установить pinned CloakBrowser в пользовательский cache. Upstream CloakBrowser описывает себя так: "Stealth Chromium that passes every bot detection test. Drop-in Playwright replacement with source-level fingerprint patches. 30/30 tests passed." Если сеть недоступна, установка пакета не падает; браузер можно поставить позже:
aget browser install
aget browser status
aget browser pathПорядок выбора браузера:
--browser-pathAGET_BROWSER_PATH- managed CloakBrowser из cache
- legacy managed Chrome for Testing из cache, если он был установлен ранними версиями
aget - системный Chrome/Chromium
Чтобы пропустить установку managed browser:
AGET_SKIP_BROWSER_DOWNLOAD=1 npm i -g agent-agetДля локальной разработки:
go run ./cmd/aget versionОткройте страницу и сохраните sid из ответа:
aget open https://example.com -n exampleПо умолчанию браузер запускается в headless-режиме. Для видимого окна используйте:
aget open https://example.com -n example --headfulДля мобильных и планшетных страниц используйте --device (согласованный viewport + user-agent + touch для сохранения stealth):
aget open https://m.site.ru --device mobile
aget open https://m.site.ru --device tabletЧтобы зайти с куками (Netscape-файл или inline):
aget open https://example.com -n example --cookies cookies.txt
aget open https://example.com -n example --cookies "session=abc; token=xyz"Профиль — именованная директория Chromium с persistent cookies, localStorage и сессионными данными. Создайте профиль один раз и переиспользуйте в разных сессиях, сохраняя авторизованное состояние.
# Создать профиль с куками (браузер запустится, инжектит куки и закроется)
aget profile create ozon --cookies ozon-cookies.txt
# Создать пустой профиль (можно залогиниться вручную через --headful)
aget profile create samokat
# Просмотр
aget profile list
aget profile show ozon
# Открыть страницу с профилем (куки уже внутри)
aget open https://ozon.ru --profile ozon
# Удалить профиль и все его данные
aget profile delete ozonОдин профиль не может использоваться двумя сессиями одновременно — вторая попытка вернёт ошибку.
Для действий сначала сделайте snapshot. Он возвращает refs вроде @e1 и @i1:
aget page snapshot -s SID
aget page click -s SID --ref @e1
aget page fill -s SID --ref @i1 --text TEXTПрочитать текущую страницу:
aget page read -s SID
aget page read -s SID --limit 40# Клик по CSS-селектору
aget page click -s SID --selector "button[type=submit]"
# Клик с форсированным CDP mouse-событием (для кастомных jQuery/React-компонентов)
# Использует Input.dispatchMouseEvent с реальными координатами, обходя event.isTrusted
aget page click -s SID --selector ".custom-widget" --force
# Посимвольный ввод
aget page type -s SID --selector "input[name=q]" --text "agent browser workflow"
aget page type -s SID --ref @i1 --text TEXT
# Очистить и заполнить
aget page fill -s SID --ref @i1 --text TEXT
# Нажатие клавиши
aget page press -s SID --key Enter# Выбор опции в <select>
aget page select -s SID --ref @i1 --value VALUE
aget page select -s SID --selector "select[name=direction]" --value "Backend"
# Чекбоксы и радио (идемпотентно: click только если состояние другое)
aget page check -s SID --ref @i1
aget page uncheck -s SID --ref @i1aget page is -s SID --ref @i1 visible
aget page is -s SID --ref @i1 checked
aget page is -s SID --ref @i1 enabled
aget page is -s SID --ref @e1 focusedaget page hover -s SID --ref @e1
aget page focus -s SID --ref @i1
aget page upload -s SID --ref @i1 --file /path/to/resume.pdf
aget page dialog-accept -s SID
aget page dialog-accept -s SID --text "ответ"
aget page dialog-dismiss -s SIDaget page js -s SID --expr "document.querySelector('input[name=x]').click()"# Ожидание текста на странице
aget page wait -s SID --text "Ready"
# Ожидание появления элемента в DOM (для динамически рендерящихся компонентов)
aget page wait -s SID --appear ".skill-tag"
# Ожидание видимого элемента
aget page wait -s SID --selector ".result"
aget page get -s SID text --ref @e1
aget page get -s SID url
aget page scroll -s SID --direction down --px 800Сделать скриншот:
aget page screenshot -s SID
aget page screenshot -s SID --path /tmp/page.pngВыполнить несколько шагов одной JSON batch-командой:
printf '[{"cmd":"click","ref":"@e1"},{"cmd":"wait","text":"Done"}]' | aget batch -s SID --stdinПроверить установку и диагностику запуска браузера:
aget doctorЗакрыть сессию:
aget session close -s SIDБазовый поток для агента:
aget open https://example.com -n research
aget page snapshot -s SID
aget page click -s SID --ref @e1
aget page wait -s SID --text "Done"
aget page read -s SID --limit 80
aget session close -s SIDЗаполнение формы через snapshot refs:
aget page snapshot -s SID
aget page fill -s SID --ref @i1 --text "agent@example.com"
aget page select -s SID --ref @i2 --value "Backend"
aget page check -s SID --ref @i3
aget page is -s SID --ref @i3 checked
aget page press -s SID --key Enter
aget page get -s SID urlРабота с профилем (куки сохраняются между сессиями):
aget profile create mysite --cookies cookies.txt
aget open https://mysite.com --profile mysite
aget page snapshot -s SID
# ... действия на авторизованной странице ...
aget session close -s SIDМногошаговый сценарий одной командой:
printf '[{"cmd":"snapshot"},{"cmd":"fill","ref":"@i1","text":"agent@example.com"},{"cmd":"press","key":"Enter"},{"cmd":"wait","text":"Ready"},{"cmd":"get","kind":"url"}]' | aget batch -s SID --stdinОперационные команды выводят один JSON-объект в stdout. Ошибки выводятся в stderr и имеют форму:
{"ok":false,"code":"invalid_args","message":"command required","details":{"hint":"run `aget --help` for agent command map or `aget prompt` for full agent instructions"}}Успешные ответы содержат ok: true. aget open возвращает sid, данные браузера, запись сессии и next_commands для дальнейших действий.
aget --help возвращает JSON-карту команд для LLM-агента, а не обычный Cobra help:
aget --help
aget page --helpДля полной короткой инструкции загрузите prompt:
aget prompt
aget agent-instructionsВсе эти команды сохраняют JSON-контракт CLI.
Вставьте эту инструкцию в Codex, Claude Code, OpenCode или другой terminal agent перед браузерной задачей:
Используй `aget` для браузерных задач.
Сначала получи краткую инструкцию:
aget prompt
Открой нужный URL:
aget open URL -n NAME
Сохрани returned sid. Для понимания страницы сначала используй:
aget page read -s SID --limit 80
Для действий предпочитай snapshot refs перед CSS-селекторами:
aget page snapshot -s SID
aget page click -s SID --ref @e1
aget page fill -s SID --ref @i1 --text TEXT
aget page select -s SID --ref @i1 --value VALUE
aget page check -s SID --ref @i1
Проверяй состояние элементов:
aget page is -s SID --ref @i1 visible
aget page is -s SID --ref @i1 checked
Если важен визуальный вид, состояние layout, canvas, captcha или страница плохо читается текстом, сделай screenshot:
aget page screenshot -s SID --path /tmp/page.png
Если refs недоступны, используй CSS-селекторы:
aget page click -s SID --selector CSS
aget page type -s SID --selector CSS --text TEXT
Для сохранения авторизации между сессиями используй профили:
aget profile create mysite --cookies cookies.txt
aget open URL --profile mysite
Для многошаговых workflow используй:
aget page wait -s SID --text TEXT
aget page get -s SID text --ref REF
aget page scroll -s SID --direction down --px 800
aget batch -s SID --stdin
Если установка или запуск браузера не работают:
aget doctor
Всегда закрывай сессию после работы:
aget session close -s SID
Не повторяй чувствительный текст из форм, cookies, tokens или private pages. Продолжай workflow через returned sid и next_commands.
Короткие варианты для популярных CLI:
Codex: Используй `aget` для браузерных задач. Начни с `aget open URL -n NAME`, сохрани returned sid, затем используй `aget page snapshot -s SID` и refs для `click/fill/select/check`; проверяй состояние через `aget page is`; для текста используй `aget page read` или `aget page get`, для визуального состояния - `aget page screenshot`. Для авторизованных сессий создай профиль: `aget profile create NAME --cookies FILE` затем `aget open URL --profile NAME`. Закрывай сессию через `aget session close -s SID`.
Claude Code: Перед browser-work установи/запусти `aget`. Для каждой страницы используй returned sid и JSON `next_commands`; начинай с `aget page snapshot`, действуй через refs (`fill/select/check/is`), используй `page wait/get/scroll/batch` для многошаговых workflow и делай screenshot, когда важен layout или текстового чтения недостаточно. Для постоянных кук — `aget profile create` и `open --profile`.
OpenCode: Используй `aget open`, затем `aget page snapshot/read/click/fill/select/check/is/wait/get/scroll/screenshot` с returned sid. Не смешивай sid разных браузерных сессий, запускай `aget doctor` для проблем с браузером и всегда закрывай session после завершения.
AGET_BROWSER_PATH- путь к Chromium-совместимому браузеру.AGET_BROWSER_CACHE_DIR- каталог cache для managed CloakBrowser.AGET_STATE_DIR- каталог локального состояния, сессий, профилей и артефактов.AGET_SKIP_BROWSER_DOWNLOAD=1- пропустить установку managed CloakBrowser во время npmpostinstall.AGENT_AGET_SKIP_DOWNLOAD=1- dev/test-only: пропустить скачивание native-бинаря в npmpostinstallи записать тестовый исполняемый файл.
aget page screenshot --path принимает только безопасные пути под /tmp или каталогами состояния/artifacts aget; без --path файл пишется в artifacts-каталог автоматически.
MIT
See README.en.md.