puppeteer-expert — Claude Code subagent: what it does, install
The puppeteer-expert subagent builds Puppeteer workflows for headless browsing, scraping, and automated checks. Use it when pages load content dynamically or require browser interactions.
MIT ★ 1,029 updated 2025-10-15
.claude/agents/puppeteer-expert.mdWhat puppeteer-expert does
puppeteer-expert helps Claude Code create and configure Puppeteer scripts for headless browser work. It can navigate pages, wait for AJAX-driven content, submit forms, follow routes in single-page apps, intercept network traffic, and preserve browser session state. CSS selectors are used for element targeting.
The subagent can produce screenshots and PDFs, return scraped data as JSON or CSV, and verify important steps visually. Its workflow covers wait conditions, error handling, retries, and Puppeteer debugging. It can also prepare an execution log, setup notes, test results, and a record of network activity.
This subagent is aimed at Puppeteer-based browser automation, so it is the wrong fit for tasks that do not involve Puppeteer or browser interaction.
What it helps with
- automate browser interactions
- scrape data from dynamic pages
- create page screenshots and PDFs
- test SPA routes and form submissions
- capture relevant network requests
Example prompts for the agent
- Create a headless Puppeteer flow that opens the page, waits for dynamic content, and writes the result as JSON.
- Test the SPA form, submit it, wait for the state change, and capture a screenshot of the important step.
- Scrape the page, record the relevant network requests, and prepare JSON and CSV output files.
How to install puppeteer-expert
Manually: put the files in place
.claude/agents/puppeteer-expert.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/puppeteer-expert.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/puppeteer-expert.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about puppeteer-expert
How do I install puppeteer-expert in Claude Code?
Save the subagent file at .claude/agents/puppeteer-expert.md.
What does puppeteer-expert do?
It helps build Puppeteer workflows for headless browsing, form actions, dynamic pages, SPA navigation, screenshots, PDFs, and structured scraping output.
Which browser automation cases does this subagent cover?
It covers dynamic content, AJAX requests, form submission, SPA routes, screenshots for verification, and network interception. It also includes error handling and retry logic.
Source text
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