Skip to main content
subagent CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/puppeteer-expert.md
Open on GitHub

What 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.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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

Similar subagents

All subagents for Browser and scraping →

From the same set137

The whole set →
haskell-expert haskell-expert — a subagent for writing idiomatic Haskell code. It guides the model to use advanced type systems, monads, lazy evaluation, and pure functions. CX Codex ★ 1,029repo stars langchain-expert The langchain-expert subagent helps build and debug LangChain pipelines, handle documents, use embeddings, and connect data sources. Use it for LangChain work. CX Codex ★ 1,029repo stars scikit-learn-expert scikit-learn-expert — an Claude subagent for scikit-learn: preprocessing, feature selection, model comparison and hyperparameter tuning, with pipelines and cross-validation throughout. CX Codex ★ 1,029repo stars lua-expert lua-expert writes and optimizes idiomatic Lua code, configures metatables, and handles cooperative multitasking with coroutines. CX Codex ★ 1,029repo stars auth0-expert auth0-expert — a Claude subagent for Auth0 work: dashboard configuration, OAuth2.0 and OpenID Connect flows, social login, MFA, SSO, Rules and Hooks. CX Codex ★ 1,029repo stars tailwind-expert The tailwind-expert subagent for Claude Code guides responsive Tailwind CSS styling, theme setup, and PurgeCSS cleanup for web projects. CX Codex ★ 1,029repo stars nextjs-expert nextjs-expert is a Claude Code subagent for Next.js work across SSR, SSG, API routes, and React apps. It joins tasks involving routing, data loading, and app checks. CX Codex ★ 1,029repo stars mongodb-expert mongodb-expert — a Claude subagent for MongoDB work: schema design, indexes, aggregation pipelines, replication, backups and migrations. CX Codex ★ 1,029repo stars

Project sponsors

Companies that keep this analytics open