Appearance
puppeteer-extra
Category: Classic browser automation (plugin framework for Puppeteer)
Pricing: Free and open source (MIT License)
Official repository: github.com/berstend/puppeteer-extra
What it is
puppeteer-extra is a lightweight wrapper around Puppeteer that adds a clean plugin interface. Instead of monkeypatching or forking Puppeteer, you register plugins via puppeteer.use(plugin) and they hook into browser and page lifecycle events transparently.
The project ships as a monorepo. The core package is puppeteer-extra; individual capability packages (stealth, adblocker, recaptcha, devtools, etc.) are installed separately and registered as plugins.
Core plugins
| Plugin | Package | Purpose |
|---|---|---|
| Stealth | puppeteer-extra-plugin-stealth | Applies evasion techniques to reduce headless detection |
| Adblocker | puppeteer-extra-plugin-adblocker | Blocks ads and trackers via uBlock Origin filter lists |
| reCAPTCHA | puppeteer-extra-plugin-recaptcha | Solves reCAPTCHA v2/v3 via 2captcha or anticaptcha |
| Devtools | puppeteer-extra-plugin-devtools | Exposes a remote devtools tunnel |
| User preferences | puppeteer-extra-plugin-user-preferences | Sets default Chrome user preferences |
| User data dir | puppeteer-extra-plugin-user-data-dir | Manages persistent Chrome profile directories |
Key characteristics
- Drop-in: the
puppeteer-extraAPI is identical to the standard Puppeteer API. No migration needed. - Works with
playwright-extraas well (same plugin interface). - Plugin hooks cover:
onBrowser,onPage,onTargetCreated,beforeLaunch,afterLaunch, and more. - TypeScript support included.
- Stars: 7.4k+ on GitHub (as of 2026).
- Licensed under MIT. No paid tier, no cloud dependency, no vendor account required.
Safety and ToS caveat
puppeteer-extra itself is a neutral automation framework. However, the stealth plugin is explicitly designed to make headless Chromium harder to detect by third-party services. Use of stealth techniques may violate the Terms of Service of sites that prohibit automated access. The maintainers acknowledge this is an ongoing cat-and-mouse game and that complete detection evasion is not guaranteed.
Route scraping or high-volume workloads through residential or mobile proxies. Never run against a target site from a datacenter IP without confirming that the site's ToS allows automated access.