chrome-cdp — скилл
Скилл для Amp, Claude Code и Cursor: агент управляет вашим живым Chrome с открытыми вкладками и входами в аккаунты через один переключатель отладки
- 3 284 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент получает доступ к вкладкам, где вы уже вошли в почту, GitHub и рабочие сервисы, и видит их содержимое
- Команды `eval`, `click` и `type` выполняют код и действия на реальных страницах с вашими правами
- Включенная удаленная отладка Chrome открывает порт, через который браузером можно управлять, пока она включена
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/chrome-cdpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент получает доступ к вкладкам, где вы уже вошли в почту, GitHub и рабочие сервисы, и видит их содержимое
- Команды `eval`, `click` и `type` выполняют код и действия на реальных страницах с вашими правами
- Включенная удаленная отладка Chrome открывает порт, через который браузером можно управлять, пока она включена
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
chrome-cdp — скилл с небольшой консольной утилитой cdp.mjs, которая подключается напрямую к WebSocket удаленной отладки Chrome и дает агенту доступ к вкладкам, открытым прямо сейчас. Отдельный браузер не запускается, Puppeteer не нужен, заново входить в аккаунты не требуется: агент видит страницы, где вы уже авторизованы, и состояние посреди рабочего процесса. Работает с Chrome, Chromium, Brave, Edge и Vivaldi на macOS, Linux и Windows. Команды утилиты: `list` показывает вкладки, `shot` снимает скриншот видимой области, `snap` выдает компактное дерево доступности, `html` возвращает код страницы или фрагмента, `eval` выполняет JavaScript, `nav` переходит по адресу, `click` и `clickxy` нажимают по селектору или координатам, `type` вводит текст, `loadall` нажимает «показать еще» до конца, а `evalraw` пропускает сырые команды CDP. Для каждой вкладки запускается фоновый процесс, который держит сессию. Окно разрешения отладки Chrome появляется один раз на вкладку, а процесс завершается после 20 минут простоя.
Для кого. Для разработчиков и тестировщиков, которым нужно, чтобы агент отлаживал страницу прямо в рабочем браузере, где уже выполнены вход и настройка.
Подходит, если
- Нужно разобрать страницу, доступную только после входа: Gmail, GitHub или внутренний инструмент
- Нужно посмотреть живое состояние страницы посреди сценария, а не после чистой перезагрузки
- Вкладок больше сотни, и инструменты на Puppeteer зависают при их перечислении
- Нужно выгрузить дерево доступности или сетевые тайминги вкладки для отладки
- Требуется нажимать «показать еще» на длинной ленте, пока она не закончится
Не подходит, если
- Нужен изолированный браузер без ваших входов: этот скилл подключается к вашему живому сеансу
- Нужна безголовая автоматизация в CI: скилл рассчитан на запущенный Chrome с включенной отладкой
- Агент не должен видеть почту и рабочие сервисы, открытые в других вкладках
- Node.js 22 недоступен: утилита использует встроенный WebSocket
Пример запроса к агенту
Посмотри открытые вкладки Chrome, найди вкладку с панелью администратора и сними дерево доступности, чтобы найти кнопку экспортаОграничения
Нужны Node.js 22 или новее и включенная удаленная отладка в chrome://inspect/#remote-debugging. Скриншот снимает только видимую область, поэтому для содержимого ниже сгиба страницу сначала прокручивают командой eval. Если файл DevToolsActivePort браузера лежит в нестандартном месте, укажите путь в переменной CDP_PORT_FILE. Описание SKILL.md разрешает работать с браузером только по явному согласию пользователя, а прежде чем обращаться к вкладке, агент ждет подтверждения в окне Chrome. Установка через pi есть в описании, для остальных агентов скилл копируют вручную.
Как отключить. Удалите папку skills/chrome-cdp из каталога скиллов агента и выключите переключатель на chrome://inspect/#remote-debugging. Фоновые процессы завершаются сами через 20 минут простоя, остановить их сразу позволяет команда `stop`.
Частые вопросы
Как подключить агента к уже открытому Chrome?
Откройте chrome://inspect/#remote-debugging и включите переключатель. Больше ничего ставить не нужно, только Node.js 22 или новее. Утилита сама находит Chrome, Chromium, Brave, Edge и Vivaldi на macOS, Linux и Windows.
Как поставить chrome-cdp в Claude Code?
Скопируйте или клонируйте каталог skills/chrome-cdp туда, откуда агент берет скиллы. Для pi есть команда pi install git:github.com/pasky/chrome-cdp-skill@v1.0.1. Установка npm не нужна.
Чем chrome-cdp отличается от chrome-devtools-mcp?
Chrome-devtools-mcp заново подключается при каждой команде, поэтому окно разрешения отладки может появляться снова и снова, а перечисление вкладок при большом их числе уходит в таймаут. Chrome-cdp держит один фоновый процесс на вкладку: окно появляется один раз, и работа со сотней вкладок идет стабильно.
Что видит агент?
Любую вкладку, которой вы разрешили доступ: страницы с вашими входами, текущий DOM и сетевые тайминги. Доступ к каждой вкладке запрашивается отдельно в окне Chrome, но после согласия агент может выполнять код на странице.
Как остановить фоновые процессы?
Команда `cdp.mjs stop` завершает процессы всех вкладок или одной вкладки, если указать ее. Иначе они выходят сами после 20 минут без команд.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыПлагин для Claude Code, который управляет вашим Chrome через DevTools Protocol: вкладки, формы, выгрузка страниц и скриншоты без сторонних зависимостей
CLI, скилл и MCP для управления Chrome короткими скриптами Puppeteer, вкладки сохраняют состояние между вызовами
Скилл cdp: агент управляет вашим Chrome напрямую через протокол DevTools, 652 типизированных метода без готовых click и goto
Скилл и CLI от Browser Use: агент управляет вашим настоящим Chrome через DevTools Protocol, под вашей учетной записью, и сам дописывает недостающие функции
MCP и CLI, которые дают агенту управлять вашим настоящим Chrome с его логинами и расширениями через Playwright
CLI и MCP-сервер, через которые агент управляет вашим настоящим Chrome с сохраненными входами: 103 команды к 36 сайтам и автоматизация браузера
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| chrome-cdp (эта запись) | нет | 3 284 | ||
| Chrome MCP Server | нет | не нужна | 12 502 | расширение Chrome с MCP-сервером, которое ставится в браузер как дополнение |
| Browser MCP | да | не нужна | 7 213 | MCP-сервер и расширение, дающие агенту управлять вашим открытым браузером |
| Chrome DevTools MCP (benjaminr) | нет | не нужна | 312 | chrome MCP на Python |
Коротко о README
Описание объясняет идею: агент видит и использует живой сеанс Chrome без отдельного браузера и повторного входа. Раздел установки показывает команду для pi и ручную установку для остальных агентов, требует Node.js 22 и переключатель отладки. Затем перечислены команды утилиты, сравнение с chrome-devtools-mcp и схема работы с фоновыми процессами на каждую вкладку.
Бейдж для README
Исходный SKILL.md
--- name: chrome-cdp description: Interact with local Chrome browser session (only on explicit user approval after being asked to inspect, debug, or interact with a page open in Chrome) --- # Chrome CDP Lightweight Chrome DevTools Protocol CLI. Connects directly via WebSocket — no Puppeteer, works with 100+ tabs, instant connection. ## Prerequisites - Chrome (or Chromium, Brave, Edge, Vivaldi) with remote debugging enabled: open `chrome://inspect/#remote-debugging` and toggle the switch - Node.js 22+ (uses built-in WebSocket) - If your browser's `DevToolsActivePort` is in a non-standard location, set `CDP_PORT_FILE` to its full path ## Commands All commands use `scripts/cdp.mjs`. The `<target>` is a **unique** targetId prefix from `list`; copy the full prefix shown in the `list` output (for example `6BE827FA`). The CLI rejects ambiguous prefixes. ### List open pages ```bash scripts/cdp.mjs list ``` ### Take a screenshot ```bash scripts/cdp.mjs shot <target> [file] # default: screenshot-<target>.png in runtime dir ``` Captures the **viewport only**. Scroll first with `eval` if you need content below the fold. Output includes the page's DPR and coordinate conversion hint (see **Coordinates** below). ### Accessibility tree snapshot ```bash scripts/cdp.mjs snap <target> ``` ### Evaluate JavaScript ```bash scripts/cdp.mjs eval <target> <expr> ``` > **Watch out:** avoid index-based selection (`querySelectorAll(...)[i]`) across multiple `eval` calls when the DOM can change between them (e.g. after clicking Ignore, card indices shift). Collect all data in one `eval` or use stable selectors. ### Other commands ```bash