Stealth Browser

Bypass bot detection and IP blocks with puppeteer-extra stealth plugin and optional Smartproxy residential proxy support.

When to Use

• Websites blocking headless browsers or datacenter IPs
• Cloudflare/Vercel protection bypassing
• Sites detecting automation (Reddit, Twitter/X, signup flows, faucets)
• Protected content scraping
• Web automation requiring human-like behavior

Tested Working On

✅ Relay.link (was blocked by Vercel, now works) ✅ X/Twitter profiles ✅ Bot detection tests (sannysoft.com) ✅ Faucet sites with protection ✅ Reddit (datacenter IP blocks)

Quick Start

# Basic usage (stealth only)
node scripts/browser.js "https://example.com"

# With residential proxy (bypasses IP blocks)
node scripts/browser.js "https://example.com" --proxy

# Screenshot
node scripts/browser.js "https://example.com" --proxy --screenshot output.png

# Get HTML content
node scripts/browser.js "https://example.com" --proxy --html

# Get text content
node scripts/browser.js "https://example.com" --proxy --text

Setup

1. Install Dependencies

cd /path/to/skill
npm install

Required packages (automatically handled by npm install with included package.json):

• puppeteer-extra
• puppeteer-extra-plugin-stealth
• puppeteer

2. Configure Proxy (Optional but Recommended)

For bypassing IP-based blocks, set up Smartproxy residential proxy:

Create ~/.config/smartproxy/proxy.json:

{
  "host": "proxy.smartproxy.net",
  "port": "3120",
  "username": "smart-ppz3iii4l2qr_area-US_life-30_session-xxxxx",
  "password": "your-password"
}

Get credentials from Smartproxy dashboard: https://dashboard.smartproxy.com

Smartproxy session parameters:

• _area-US → Use US residential IPs
• _life-30 → Session lasts 30 minutes
• _session-xxxxx → Sticky session (same IP for duration)

Without proxy, the browser still uses stealth plugin to avoid detection, but may be blocked by IP-based protection.

How It Works

Stealth Features

The browser includes multiple anti-detection measures:

1. puppeteer-extra-plugin-stealth: Automatically applies all stealth evasions

   • Removes navigator.webdriver flag
   • Spoofs Chrome user agent and headers
   • Fakes plugins, languages, permissions
   • Removes automation signatures

2. Human-like behaviors:

   • Realistic viewport (1920x1080)
   • Updated user agent (Chrome 121)
   • Natural browser properties
   • No automation control flags

3. Residential proxy (when --proxy used):

   • Routes through residential IPs
   • Bypasses datacenter IP blocks
   • Sticky sessions (same IP per session)
   • Geographic targeting (US by default)

Detection Bypass Comparison