# puppeteer-expert

Субагент puppeteer-expert для Claude Code автоматизирует браузер через Puppeteer: собирает данные, тестирует страницы и сохраняет снимки или PDF. Работает с динамическим веб-интерфейсом.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 1029 у репозитория
- Автор: 0xfurai
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/0xfurai/claude-code-subagents/tree/HEAD/agents/puppeteer-expert.md
- Обновлён: 2025-10-15
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/puppeteer-expert

## Что делает

puppeteer-expert настраивает и пишет сценарии для Puppeteer в headless-режиме. Он умеет открывать страницы, работать с динамическим содержимым и AJAX, отправлять формы, проходить маршруты SPA, перехватывать сетевые запросы и сохранять состояние браузерной сессии. CSS-селекторы используются для поиска элементов.

Субагент также помогает получать скриншоты и PDF, формировать результаты парсинга в JSON или CSV и проверять действия по ключевым шагам. В его подход входят ожидания загрузки, обработка ошибок, повторные попытки и отладка Puppeteer. На выходе он может подготовить файл скрипта с инструкциями, журнал выполнения и результаты тестов.

Для задач без Puppeteer и браузерной автоматизации этот субагент не подходит: его сценарии рассчитаны именно на API Puppeteer.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/puppeteer-expert.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/puppeteer-expert.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/puppeteer-expert.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/0xfurai/claude-code-subagents/tree/HEAD/agents/puppeteer-expert.md

## Когда брать
- автоматизировать действия в браузере
- собрать данные с динамической страницы
- сформировать скриншоты и PDF из веб-страницы
- протестировать навигацию SPA и отправку форм
- перехватить и записать сетевые запросы

## Примеры запросов агенту
- Настрой сценарий Puppeteer в headless-режиме: открой страницу, дождись динамического содержимого и сохрани результат в JSON.
- Проверь форму в SPA, отправь её, дождись изменения состояния и сделай скриншот ключевого шага.
- Собери данные со страницы, перехвати нужные сетевые запросы и подготовь файлы JSON и CSV.

## Похожие
- [puppeteer-automation](https://affpapa.org/nevibecode/skills/puppeteer-automation.md) — скилл · 1900 установок
- [puppeteer-skill](https://affpapa.org/nevibecode/skills/puppeteer-skill.md) — скилл · 247 установок
- [puppeteer](https://affpapa.org/nevibecode/rules/puppeteer.md) — правило · ★ 3589 у репозитория
- [Naver Search](https://affpapa.org/nevibecode/mcp/naver-search.md) — MCP-сервер · 13327 установок
- [DuckDuckGo & Felo AI Search](https://affpapa.org/nevibecode/mcp/duckduckgo-felo-ai-search.md) — MCP-сервер · 12697 установок
- [Ecommerce Intel MCP — Shopify Store & Product Analysis](https://affpapa.org/nevibecode/mcp/ecommerce-intel-mcp-shopify-store-product-analysis.md) — MCP-сервер · 10762 установки

Из того же набора: [0xfurai/claude-code-subagents](https://affpapa.org/nevibecode/by/0xfurai/claude-code-subagents.md) — 137 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
