agent-browser-cli — скилл

Скилл подключает агента к вашему Chrome через расширение и CLI для чтения страниц, управления вкладками и проверки действий.

  • 649 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Широкий доступ

Почему такой уровень

  • CLI получает куки и содержимое открытых сайтов, выполняет JavaScript и может отправлять формы с правами вошедшего пользователя.
Все причины и проверки

sleepinginsummer/agent-browser-cli

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/agent-browser-cli

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • CLI получает куки и содержимое открытых сайтов, выполняет JavaScript и может отправлять формы с правами вошедшего пользователя.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

agent-browser-cli использует уже открытый Chrome с его вкладками и авторизованными сайтами. Агент может прочитать структуру страницы, выполнить JavaScript и получить снимок. Подключение поддерживает переходы, формы и загрузку файлов. Rust-процесс и расширение образуют локальный мост, который запускается по необходимости. Скилл объясняет выбор команды под задачу и разбор сбоев соединения. Для работы не требуется создавать отдельный тестовый браузер, поэтому область доступа совпадает с выбранным реальным сеансом.

Для кого. Для разработчиков и QA, которым нужно проверить разрешенный сценарий в собственном авторизованном браузере.

Подходит, если

  • Нужно проверить интерфейс сайта с существующим входом.
  • Агенту требуется найти нужную вкладку среди открытых.
  • Перед отправкой формы нужно прочитать DOM и проверить состояние.
  • Нужно сопоставить результат действия со снимком страницы.

Не подходит, если

  • Нужна изолированная песочница без доступа к вашим рабочим сайтам.
  • Пользователь не разрешал читать куки или содержимое выбранного аккаунта.
  • В браузере нельзя установить поддерживаемое расширение.

Пример запроса к агенту

Найди мою тестовую вкладку Chrome, прочитай заголовок и сделай снимок без изменения страницы.

Ограничения

Нужен Chrome или Chromium с установленным расширением-мостом: один CLI не подключит агента к вкладкам. Для работы из WSL нужна версия самого WSL 2.0.0 или новее и соединение с Chrome на стороне Windows. Локальные файлы открываются после отдельного разрешения расширению, поэтому доступ к диску выбирается дополнительно. CLI использует реальные куки и позволяет выполнять JS через CDP; для первого задания возьмите тестовый профиль, иначе агент получит доступ к вашим рабочим сайтам и данным аккаунтов.

Как отключить. Отключите расширение-мост и удалите скилл из агента. Перед закрытием рабочих вкладок проверьте незавершенные формы и загрузки.

Частые вопросы

Когда запускается фоновый процесс?

По необходимости при обычной команде. Отсутствие постоянного процесса до первого действия не считается сбоем.

Что проверяет `agent-browser-cli doctor`?

Состояние соединения с браузером. Команда не запускает фоновый процесс и не меняет конфигурацию.

Можно ли открыть локальный HTML?

Да. Нужно расширение версии 2.1 или новее с разрешенным доступом к файловым URL. Включите это разрешение в настройках расширения Chrome.

Как увидеть упрощенную страницу?

Командой `agent-browser-cli scan --text-only`. Она возвращает текстовое представление текущей страницы.

Поддерживается ли другой профиль браузера автоматически?

Не следует это предполагать. Состояние и разрешения проверяются для подключенного профиля, а действия должны указывать нужную вкладку.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Агент работает в вашем настоящем Chrome с уже выполненными входами: CLI, MCP и расширение с отдельной группой вкладок

CLIШирокий доступ257Звезды репозитория
Официальный

Быстрый CLI на Rust для автоматизации браузера агентами: снимки доступности со ссылками на элементы, MCP-сервер и скиллы

CLIШирокий доступ50,5 тыс.Звезды репозитория

Скилл для Amp, Claude Code и Cursor: агент управляет вашим живым Chrome с открытыми вкладками и входами в аккаунты через один переключатель отладки

СкиллШирокий доступ3,3 тыс.Звезды репозитория

Бинарник на Rust без MCP-сервера: агент ведет ваш открытый Chrome или Edge, а вкладки закрепляются метками target.

CLIШирокий доступ256Звезды репозитория

CLI и MCP-сервер, через которые агент управляет вашим настоящим Chrome с сохраненными входами: 103 команды к 36 сайтам и автоматизация браузера

CLIШирокий доступ6,3 тыс.Звезды репозитория

BrowserSkill подключает агента к Chrome или Edge с текущими входами и дает чтение, клики и сбор данных в отдельном окне.

СкиллШирокий доступ10,3 тыс.Звезды репозитория

Коротко о README

Браузерный мост выделен из GenericAgent в отдельный инструмент. Несколько CLI-вызовов используют общее соединение, поэтому не подключаются к расширению заново для каждой команды.

Бейдж для README

Исходный SKILL.md

---
name: agent-browser-cli
description: 使用 agent-browser-cli 进行浏览器感知与控制、页面交互、截图/PDF、Cookie/CDP 和排障。
---

# agent-browser-cli

使用 `agent-browser-cli` 控制用户真实 Chrome。底层是 Rust daemon + Chrome 扩展桥,保留登录态和 Cookie;不是 Selenium/Playwright。

## 正常流程直接执行命令

每次开始浏览器任务,不要先做健康检查,直接执行最贴近目标的命令。`tabs` / `open` / `exec` / `scan` 会按需自动启动 daemon;daemon 未常驻是正常状态,不是故障。

```bash
agent-browser-cli open https://example.com
agent-browser-cli scan --text-only
agent-browser-cli snapshot --limit 200
agent-browser-cli exec --tab <tabId> 'return document.title'
```

只有目标命令失败、输出明确提示连接异常、扩展未连接、端口不一致、无可用标签页,或用户明确要求排障时,才进入状态检查:

```bash
agent-browser-cli status
agent-browser-cli doctor
agent-browser-cli logs --tail 100
```

`status` 中 `daemon_not_running` / `running=false` 不能单独作为停止操作的理由;优先继续执行目标命令让 CLI 自动拉起 daemon。`doctor` 只检查状态,不自动启动 daemon、不改配置、不安装 skill。

补充一个容易误判的点:`status` / `doctor` 里看到 `daemon_not_running`,如果此时还没有执行 `tabs` / `open` / `exec` / `scan`,通常只是 daemon 按需常驻而未启动,不代表故障。只有目标命令已经失败,或者日志/输出明确提示端口、扩展、标签页异常时,才进入排障。

## 打开本地文件

`open` 支持 HTTP(S) URL、绝对 `file://` URL 和本机文件路径。相对路径以执行 CLI 时的当前目录为基准;支持 `~`、中文、空格和符号链接,符号链接会解析到真实文件。所有普通文件类型均可打开,目录会被拒绝。

```bash
agent-browser-cli open ./demo.html
agent-browser-cli open ~/Documents/report.pdf
agent-browser-cli open 'file:///Users/me/My%20Files/demo.html#intro'
agent-browser-cli open ./demo.html --timeout 15
```

本地文件要求 Chrome 扩展版本至少为 2.1,并在 `chrome://extensions` → Agent Browser CLI Bridge → 详情中开启“允许访问文件网址”。权限关闭时 `open` 会在创建标签前失败;`status` / `doctor` 会按 Profile 报告 `file_scheme_access`,但该可选能力不影响普通 HTTP(S) 健康状态。

Сообщить о проблеме