puppeteer-expert — субагент для Claude Code: установка
Субагент puppeteer-expert для Claude Code автоматизирует браузер через Puppeteer: собирает данные, тестирует страницы и сохраняет снимки или PDF. Работает с динамическим веб-интерфейсом.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/puppeteer-expert.mdЧто делает 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 или по @-упоминанию
Вручную: положить файлы
.codex/agents/puppeteer-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/puppeteer-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты 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