pagouse

По ссылке, а не по пикселям. pagouse — это агент страницы для агентов кодирования: расширение Chromium в ежедневном профиле, которое читает дерево доступности, передаёт вашему агенту стабильные метки ref_N и — только с разрешением — кликает, заполняет и перемещается по этим узлам.

По умолчанию он наблюдает. Изменения требуют --allow-input. Дополнительный MCP-сервер работает только на наблюдение и его нельзя уговорить вводить текст.

$ pagouse --json snapshot --tab 1840 | jq -r '.snapshot.tree' | head
RootWebArea "Inbox" [ref_1]
  textbox "Search" [ref_2]
  button "Compose" [ref_3]

Как это работает

• Расширение MV3 строит дерево доступности внутри страницы, где ссылки остаются действительными между отдельными вызовами CLI.

• Нативный обмен сообщениями запускает pagoused, локальный демон на unix-сокете, доступном только владельцу. Никакого порта удалённой отладки, никакого chrome.debugger.

• Ядро на Python без зависимостей оборачивает всё это в версионированный конверт --json (schema: 1).

Слои и не-цели: docs/architecture.md.

Related MCP server: DevTools Lens MCP

Требования

• Linux

• Python 3.13+ и uv

• Браузер семейства Chromium (Chrome, Chromium, Brave, Edge) в ежедневном профиле

Само ядро имеет ноль зависимостей. magick необязателен для уменьшения масштаба --fit.

Установка

git clone https://github.com/gianlucamazza/pagouse
cd pagouse
./install.sh

install.sh устанавливает pagouse как инструмент uv, записывает ~/.config/pagouse/config.toml, если его нет, связывает навык агента с любым существующим корнем навыков и регистрирует хост нативного обмена сообщениями. Он идемпотентен. Подробности в docs/quickstart.md.

Затем загрузите extension/ распакованным (chrome://extensions → Режим разработчика). pagouse --json doctor должен сообщить ready, как только всплывающее окно станет зелёным.

Использование

Наблюдение — никогда не требует разрешения:

pagouse --json tabs
pagouse --json snapshot --tab ID

Управление — добавьте --allow-input, кликайте по ref, никогда по координатам:

pagouse --json --allow-input click --ref ref_4 --tab ID --then snapshot

Каждая команда и флаг: docs/cli-reference.md. Конверт и коды ошибок: docs/json-contract.md.

Дополнение MCP и навык агента

uv tool install 'pagouse[mcp]' предоставляет pagouse-mcp: только инструменты наблюдения для чтения (doctor, tabs, snapshot, shot, wait, wait_ref). Инструмента изменения нет; управляйте страницей через CLI и разрешение.

install.sh также связывает skills/pagouse/SKILL.md с любым существующим корнем навыков агента, чтобы ваши агенты получали руководство без настройки.

Безопасность

Наблюдение никогда не запрашивает разрешения; изменение отказывается без явного разрешения. Запрет схем, политика происхождения и редактирование секретов применяются в ядре. Заголовки вкладок, URL-адреса, текст дерева и пиксели снимков — недоверенный ввод. Прочтите docs/security-model.md перед включением ввода. Сообщайте об уязвимостях согласно SECURITY.md.

Документация

Лицензия

MIT. См. LICENSE.