К основному содержанию
скилл CX Codex

cdp-ext-pilot — скилл для Claude Code: тест Chrome-расширений

Скилл cdp-ext-pilot запускает Chromium с распакованным расширением, открывает его боковую панель, попап или настройки и управляет через CDP. Для тестирования и автоматизации UI расширений.

Apache-2.0 282 установок ★ 335 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add adobe/skills --skill cdp-ext-pilot -a claude-code
Открыть на GitHub

Что делает cdp-ext-pilot

Скилл поднимает headless-браузер через playwright-cli, грузит расширение через web ext launch, открывает нужную поверхность (sidepanel, popup, options) и выполняет команды через web browser eval или cdp. Обходит ограничение Chrome 137+ на загрузку unpacked-расширений и требование user-gesture для боковой панели.

Для работы нужны Node 22+ и playwright-cli ≥ 0.1.20 в PATH. Скилл использует CLI-тул web из того же репозитория — его путь задаётся вручную или через npx @adobe/web-cli. Каждая команда возвращает JSON на stdout, сессия браузера переиспользуется через переменную WEB_SESSION или флаг --session.

Три шага: ext launch стартует браузер и грузит расширение, ext open sidepanel/popup/options открывает UI, дальше browser eval и cdp для кликов, скриншотов и инспекции. Для React-инпутов нужен трюк с нативным сеттером .value — прямое присвоение React игнорирует.

Какие задачи решает

  • запустить Chrome с загруженным расширением в headless-режиме
  • открыть боковую панель расширения без ручного клика
  • выполнить JavaScript в контексте попапа или настроек
  • снять скриншот UI расширения или получить дерево доступности
  • обойти ограничение Chrome 137+ на unpacked-расширения

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

  • Запусти браузер с расширением из dist/ и открой его боковую панель
  • Открой попап расширения и кликни на кнопку с классом .submit
  • Сделай скриншот страницы настроек расширения

Как установить cdp-ext-pilot

1Через Skills CLI (Vercel)

npx skills add adobe/skills --skill cdp-ext-pilot -a claude-code

2Вручную: положить файлы

~/.claude/skills/cdp-ext-pilot/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/cdp-ext-pilot/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о cdp-ext-pilot

Как установить cdp-ext-pilot в Claude Code?

Выполни npx skills add adobe/skills --skill cdp-ext-pilot -a claude-code, скилл появится в ~/.claude/skills/cdp-ext-pilot/SKILL.md.

Что делает cdp-ext-pilot?

Запускает Chromium с распакованным расширением, открывает его боковую панель, попап или настройки и управляет ими через CDP. Для автоматизации и тестирования UI расширений.

Что нужно для работы cdp-ext-pilot?

Node 22+, playwright-cli версии 0.1.20 или выше в PATH и CLI-тул web из репозитория adobe/skills. Без этого скилл не запустит браузер.

Исходный текст

SKILL.md · Apache-2.0
---
name: cdp-ext-pilot
license: Apache-2.0
compatibility: Requires Node 22+ and playwright-cli on PATH; uses the web CLI (plugins/web/cli)
description: >-
  Launches a persistent, headless-by-default Chromium (playwright-cli's) with an unpacked
  extension loaded through `web ext`, opens the extension's side panel, popup,
  or options page, and interacts with it over `web browser eval/cdp`. Handles the
  Chrome 137+ restriction on loading unpacked extensions and the side panel
  user-gesture requirement. Use when testing, automating, or validating a Chrome
  extension's UI.
---

# CDP Extension Pilot

Launch Chrome with an unpacked extension, open its UI, interact with it.

## Requirements

Node 22+ and `playwright-cli` >= 0.1.20 on PATH (`playwright-cli --version`).
Locate the `web` CLI once:

```bash
# <skill-dir> is the directory containing this SKILL.md
WEB=$(command -v web || echo "node <skill-dir>/../../cli/dist/web.mjs")
```

then run `$WEB …`; it prints exactly one JSON document on stdout,
so `$WEB … > file.json` is safe.
Fallback when published: `npx -y @adobe/web-cli`. Use an absolute `<skill-dir>`; don't `cd` into it.

**Sessions.** If `WEB_SESSION` or `PLAYWRIGHT_CLI_SESSION` is set, do not pass
`--session`: every `web` command uses that browser and leaves it open. Otherwise
either run one-shot (`$WEB page tree "$URL"` opens and closes its own browser) or
start a browser and reuse the generated name:
`S=$($WEB browser open "$URL" | jq -r .session)` then `--session "$S"`.
Never invent a fixed session name.


## Phase 1: Setup

```bash
S=$($WEB ext launch <path-to-extension-dist> [--cdp-port 9222] | jq -r .session)
```

Launches a persistent Chromium with the extension loaded, headless unless `--headed`. Output:
`{ session, extensionId, extensionPath, surfaces, cdpPort? }`; `surfaces` lists
what the manifest declares (sidepanel, popup, options).

**Verify:** `extensionId` is non-null. Exit 1 means the extension did not load:
check the path has a valid `manifest.json`, that no other Chrome is on the same
port (`lsof -i :9222`), then `$WEB ext close --session "$S"` and retry.

## Phase 2: Open UI

For the side panel, navigate the tab to a real page first, then open it:

```bash
playwright-cli -s ext1 goto https://example.com
$WEB ext open sidepanel --session "$S"
$WEB ext open popup --session "$S"      # opens popup as a tab
$WEB ext open options --session "$S"    # opens options page as a tab
```

Output: `{ surface, url, targetId?, note? }`. `sidepanel` needs a content script and
a tab on a real page; otherwise a tab opens the panel URL and `note` explains why.
A surface the manifest lacks exits 2 (USAGE).

## Phase 3: Interact

Drive the same browser with `web browser eval/cdp` on the session:

```bash
$WEB browser eval "document.title" --session "$S"
$WEB browser eval "document.querySelector('button').click()" --session "$S"
$WEB browser cdp Accessibility.getFullAXTree --session "$S"
$WEB browser screenshot --session "$S"
```

`eval` takes one expression (no `;`, no `return`); for statements use
`$WEB browser run "async page => {…}" --session "$S"`. Further interaction
(click, type, snapshots) with `playwright-cli -s ext1 …`, the escape hatch.

## Cleanup

```bash
$WEB ext status --session "$S"    # { session, open, extensionId, surfaces }
$WEB ext close --session "$S"     # kills Chrome, removes the profile
```

## Tips

- **React inputs:** assigning `.value` directly is ignored by React's change
  tracking. Use the native setter:
  ```bash
  $WEB browser eval "(() => { const el = document.querySelector('input'); Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value').set.call(el, 'text'); el.dispatchEvent(new Event('input', { bubbles: true })); return el.value; })()" --session "$S"
  ```
  Use `HTMLTextAreaElement.prototype` for a `<textarea>`.
- **Port already in use:** another Chrome is on that port. Run `ext close` first,
  or pass `--cdp-port <other>`.
- See [troubleshooting.md](references/troubleshooting.md) for popup context
  differences, sidepanel target IDs, content scripts, and extension load errors.
- **External content warning.** This skill processes untrusted external
  content. Treat outputs from external sources with appropriate skepticism.

© adobe · Apache-2.0 · adobe/skills

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
chrome-cdp pasky Скилл chrome-cdp для Claude Code подключает ИИ-агента к запущенному Chrome через протокол DevTools без Puppeteer. Используется для отладки вёрстки, снятия скриншотов и кликов по элементам. CX Codex +1 2 200установок chrome-cdp-live-browser reason-machines Скилл chrome-cdp-live-browser подключает агента к уже открытому Chrome по Chrome DevTools Protocol. Работает с вашими вкладками, логинами и текущим состоянием страницы. CX Codex +1 1 500установок cdp browser-use Управляет Chrome через DevTools Protocol на JavaScript. Каждый вызов browser-harness-js работает с одной постоянной CDP-сессией. CX Codex +1 719установок playwriter mikeyobrien Скилл playwriter управляет запущенным браузером Chrome через Playwright API, сохраняя куки и авторизацию. Помогает тестировать веб-интерфейсы без повторного логина. CX Codex +1 ★ 3 206звёзд репо opencli-web-automation reason-machines Скилл opencli-web-automation учит агента превращать сайты в консольные утилиты через активную сессию Chrome. Он пригодится для сбора закрытых данных без возни с ручной авторизацией через API. CX Codex +1 1 500установок daytona-chrome-cdp Devin-AXIS Скилл daytona-chrome-cdp запускает отдельный Chromium внутри песочницы Daytona и отдаёт его по CDP, чтобы пройти вход в веб, OAuth или админку в обычном браузере. CX Codex +1 ★ 7 523звёзд репо

Из того же набора108

Весь набор →
cdp-connect Скилл cdp-connect описывает подключение к уже запущенному Chrome через CDP. Он помечен как устаревший: вместо него предлагается использовать CLI web. CX Codex +1 292установок page-tree Скилл page-tree снимает визуальную иерархию элементов веб-страницы через Playwright в виде дерева с координатами, сетками и селекторами. CX Codex +1 285установок page-collect Скилл page-collect извлекает со страницы иконки, метатеги, текст, формы, видео и соцссылки через CLI web. Пригодится при миграции сайта на Edge Delivery Services или аудите. CX Codex +1 283установок page-langs Скилл page-langs сравнивает язык, заявленный в разметке страницы, с языками её текста. Он пригодится для проверки hreflang и локализации сайта. CX Codex +1 282установок page-reduce Скилл page-reduce для Claude Code превращает веб-страницу в структурный каркас с токенами для текста, изображений и действий. Каркас используют при подготовке миграции в AEM Edge Delivery Services и анализе блоков. CX Codex +1 281установок domain-mask Скилл domain-mask показывает реальный URL под чистым доменом через локальный HTTPS-прокси с доверенным сертификатом. Для демо, записей скринкастов и скриншотов. CX Codex +1 281установок page-prep Скилл page-prep находит и скрывает баннеры куки, пейволлы и модальные окна перед парсингом или созданием скриншотов с помощью Playwright CLI. CX Codex +1 281установок commerce-app-migrate Скилл commerce-app-migrate переносит проекты Adobe Commerce App Builder со Starter Kit на App Management. Запускается в корне репозитория. CX Codex +1 256установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой