# Puppeteer Extra — Extend Puppeteer with Stealth and Plugin Ecosystem

> A modular plugin framework for Puppeteer that adds stealth capabilities, ad blocking, CAPTCHA solving, and user preference persistence.

## Install

Save as a script file and run:

# Puppeteer Extra — Extend Puppeteer with Stealth and Plugin Ecosystem

## Quick Use
```bash
npm install puppeteer-extra puppeteer-extra-plugin-stealth puppeteer
```
```javascript
const puppeteer = require("puppeteer-extra");
const StealthPlugin = require("puppeteer-extra-plugin-stealth");

puppeteer.use(StealthPlugin());

(async () => {
  const browser = await puppeteer.launch({ headless: true });
  const page = await browser.newPage();
  await page.goto("https://bot.sannysoft.com");
  await page.screenshot({ path: "stealth-test.png" });
  await browser.close();
})();
```

## Introduction
Puppeteer Extra wraps the standard Puppeteer API with a plugin system. Its most popular plugin, puppeteer-extra-plugin-stealth, patches multiple browser fingerprints to make automated Chrome sessions indistinguishable from manual browsing.

## What Puppeteer Extra Does
- Adds a plugin pipeline that hooks into Puppeteer browser and page lifecycle events
- Patches WebGL, WebRTC, navigator, and Chrome runtime fingerprints via the stealth plugin
- Blocks ads and trackers with the adblocker plugin using the same engine as uBlock Origin
- Solves reCAPTCHA challenges automatically with the recaptcha plugin
- Persists user data directories and cookies across sessions

## Architecture Overview
Puppeteer Extra intercepts Puppeteer's launch and connect methods, running each registered plugin's onBrowser and onPageCreated hooks. The stealth plugin applies a set of evasion modules (chrome.runtime, navigator.webdriver, iframe.contentWindow) via page.evaluateOnNewDocument calls before any page script executes.

## Self-Hosting & Configuration
- Install puppeteer-extra alongside regular puppeteer
- Add plugins via puppeteer.use() before calling launch()
- Configure stealth evasions individually if defaults are too aggressive
- Use the adblocker plugin with blocker lists for faster page loads
- Works with puppeteer-core for custom Chrome/Chromium binaries

## Key Features
- Drop-in Puppeteer replacement with full API compatibility
- Stealth plugin passes all major bot detection test suites
- Modular plugin architecture for composing functionality
- Supports both Puppeteer and Playwright via playwright-extra
- Active community maintaining evasion updates as detection evolves

## Comparison with Similar Tools
- **Puppeteer** — Standard API without stealth; puppeteer-extra adds anti-detection
- **undetected-chromedriver** — Python Selenium-based; puppeteer-extra is Node.js-native
- **Playwright** — Multi-browser support; puppeteer-extra focuses on Chrome stealth
- **Crawlee** — High-level scraping framework; puppeteer-extra operates at the driver level
- **Browser Use** — AI-driven automation; puppeteer-extra provides programmatic control

## FAQ
**Q: Does the stealth plugin guarantee passing all bot detection?**
A: It passes most fingerprint checks, but behavioral analysis (mouse patterns, timing) may still trigger detection.

**Q: Can I use it with Playwright instead of Puppeteer?**
A: Yes. The playwright-extra package provides the same plugin system for Playwright.

**Q: Does it work in headless mode?**
A: Yes. The stealth plugin specifically targets headless detection evasion.

**Q: How do I add multiple plugins?**
A: Call puppeteer.use() for each plugin before launching the browser.

## Sources
- https://github.com/berstend/puppeteer-extra
- https://extra.community/

---
Source: https://tokrepo.com/en/workflows/asset-3074efc2
Author: Script Depot