К основному содержанию
субагент CX Codex

puppeteer-expert — субагент для Claude Code: установка

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

MIT ★ 1 029 обновлён 2025-10-15

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/puppeteer-expert.md
Открыть на GitHub

Что делает puppeteer-expert

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

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

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

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

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

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

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

Как установить puppeteer-expert

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

.claude/agents/puppeteer-expert.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о puppeteer-expert

Как установить puppeteer-expert в Claude Code?

Сохраните файл субагента по пути .claude/agents/puppeteer-expert.md.

Что делает puppeteer-expert?

Он помогает создавать сценарии Puppeteer для headless-браузера: автоматизирует навигацию и формы, обрабатывает динамический контент, делает скриншоты и PDF, а также собирает данные.

Какие задачи Puppeteer умеет проверять этот субагент?

Он проверяет навигацию SPA, отправку форм, загрузку динамического содержимого и перехват сетевых запросов. Для контроля действий использует скриншоты на ключевых шагах.

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

puppeteer-expert.md · MIT
---
name: puppeteer-expert
description: Expert in automating browser interactions using Puppeteer. Handles headless browsing, web scraping, and automated testing with Puppeteer. Use PROACTIVELY for browser automation tasks.
model: claude-sonnet-4-20250514
---

## Focus Areas
- Set up and configure Puppeteer for various environments
- Automate browser tasks using headless mode
- Implement robust web scraping techniques
- Handle dynamic content loading and AJAX requests
- Capture and manipulate screenshots and PDFs
- Navigate complex single-page applications
- Intercept and manipulate network requests
- Automate form submissions and user interactions
- Manage browser sessions and state
- Utilize Puppeteer's API for advanced use cases

## Approach
- Always launch browsers in headless mode for automation
- Ensure minimal resource usage by managing browser instances efficiently
- Write modular and reusable scripts for common tasks
- Use waits and delays to handle dynamic content accurately
- Incorporate error handling and retries for robust scripts
- Use Puppeteer's debugging options to troubleshoot scripts
- Prefer CSS selectors for stable element targeting
- Store and reuse authentication sessions for efficiency
- Verify script actions through screenshots in key steps
- Follow Puppeteer's best practices for performance and reliability

## Quality Checklist
- Script covers all specified tasks and user interactions
- Headless mode functions equivalent to visible mode
- Dynamic content is loaded and handled without errors
- Screenshots and PDFs capture required page elements
- Form submissions succeed and reflect expected state changes
- SPA navigation completes and targets correct routes
- Network interception captures and logs relevant data
- Scripts are modular, maintainable, and easy to understand
- Error handling covers all potential failure points
- Scripts pass in different environments with consistent results

## Output
- Puppeteer script file with clear documentation and instructions
- Execution log demonstrating step-by-step interaction
- Screenshot and PDF files for visual verification
- Scraper outputs in structured formats (e.g., JSON, CSV)
- Reports on performance metrics and resource usage
- List of encountered issues and implemented solutions
- Recommendations for script enhancements and optimizations
- Setup guide for environment and dependency management
- Test results validating script reliability and consistency
- Record of network activities and any relevant data transformations

© 0xfurai · MIT · 0xfurai/claude-code-subagents

Похожие субагенты

Все субагенты по теме «Браузер и парсинг» →
puppeteer-automation Mindrally Скилл puppeteer-automation для браузерной автоматизации на Puppeteer: навигация, клики, скриншоты, PDF и перехват сетевых запросов в headless Chrome. CX Codex +1 1 900установок puppeteer-skill TestMu AI Генерирует Puppeteer-скрипты для браузерной автоматизации, скрейпинга и PDF. Срабатывает на упоминание Puppeteer, headless Chrome, page.goto, scrape. CX Codex +1 247установок puppeteer sanjeed5 Правило подсказывает, как писать скрипты Puppeteer для автоматизации браузера, скрейпинга и тестов. Cursor применяет его к файлам JavaScript и JSX. CX Codex +1 ★ 3 589звёзд репо Naver Search naver MCP-сервер Naver Search подключает поиск по сервисам Naver: новостям, блогам, кафе, базам знаний и покупкам. Помогает находить данные на корейском языке, которых нет в глобальных поисковиках. CX Codex +1 13 327установок DuckDuckGo & Felo AI Search oevortex DuckDuckGo & Felo AI Search — MCP-сервер для Claude Code с веб-поиском DuckDuckGo, извлечением данных со страниц и AI-поиском Felo. API-ключи не нужны. CX Codex +1 12 697установок Ecommerce Intel MCP — Shopify Store & Product Analysis nexgendata-apify Ecommerce Intel MCP — Shopify Store & Product Analysis — MCP-сервер для Claude Code: анализирует стек Shopify-магазина и выгружает каталог товаров. Используется для изучения конкурента и его ассортимента. CX Codex +1 10 762установок

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

Весь набор →
haskell-expert Субагент haskell-expert для написания и рефакторинга идиоматичного кода на Haskell. Фокусируется на строгой типизации, монадах, ленивых вычислениях и чистых функциях. CX Codex ★ 1 029звёзд репо langchain-expert Субагент langchain-expert для Claude Code проектирует и отлаживает пайплайны LangChain, работает с документами, эмбеддингами и источниками данных. Разбирает задачи на LangChain. CX Codex ★ 1 029звёзд репо scikit-learn-expert Субагент scikit-learn-expert для Claude Code ведёт ML-задачу на scikit-learn: препроцессинг, отбор признаков, сравнение моделей и настройка гиперпараметров с кросс-валидацией. CX Codex ★ 1 029звёзд репо lua-expert Субагент lua-expert пишет и оптимизирует идиоматичный код на Lua, настраивает метатаблицы и управляет многозадачностью через корутины. CX Codex ★ 1 029звёзд репо auth0-expert Субагент auth0-expert для Claude, который разбирает настройку Auth0: приложения и API, потоки OAuth2.0 и OpenID Connect, MFA, SSO, Rules и Hooks. CX Codex ★ 1 029звёзд репо tailwind-expert Субагент tailwind-expert по Tailwind CSS для Claude Code: помогает настраивать темы, собирать адаптивную вёрстку и чистить стили с PurgeCSS. CX Codex ★ 1 029звёзд репо nextjs-expert Субагент nextjs-expert для Claude Code помогает проектировать Next.js-приложения, API-маршруты и React-интерфейсы. Подключается к задачам по SSR, SSG и маршрутизации. CX Codex ★ 1 029звёзд репо mongodb-expert Субагент mongodb-expert для Claude, который разбирает работу с MongoDB: схемы, индексы, агрегации, репликация, бэкапы и миграции. CX Codex ★ 1 029звёзд репо

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

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