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

CODEBLOCK0

Setup

1. Install Dependencies

CODEBLOCK1

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

• - INLINECODE0
• INLINECODE1
• INLINECODE2

2. Configure Proxy (Optional but Recommended)

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

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

CODEBLOCK2

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

Smartproxy session parameters:

• - _area-US → Use US residential IPs
• INLINECODE5 → Session lasts 30 minutes
• INLINECODE6 → 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. 1. puppeteer-extra-plugin-stealth: Automatically applies all stealth evasions

1. 2. Human-like behaviors:

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

Detection Bypass Comparison

Usage Examples

Example 1: Check if Site Detects Automation

CODEBLOCK3

Look for green checkmarks = undetected, red = detected.

Example 2: Scrape Protected Page

CODEBLOCK4

Example 3: Monitor Site Changes

CODEBLOCK5

Example 4: Extract Structured Data

CODEBLOCK6

Proxy Cost Considerations

Smartproxy residential pricing:

• - ~$7.50/GB of traffic
• Average page load: 1-3 MB
• Rough cost: $0.01-0.03 per page

When to use proxy:

• - Site explicitly blocks datacenter IPs (Reddit, some faucets)
• Cloudflare/Vercel protection detected
• Multiple requests from same IP getting rate-limited
• Geographic targeting needed (US vs international)

When stealth-only is enough:

• - Site only checks for automation signatures, not IP
• Low-value scraping where IP blocks are acceptable
• Testing/development (proxy costs add up)

Troubleshooting

Browser Launch Fails

CODEBLOCK7

Solution: Install required system dependencies:

CODEBLOCK8

Proxy Authentication Fails

CODEBLOCK9

Solution: Check proxy credentials in ~/.config/smartproxy/proxy.json. Verify username/password are correct in Smartproxy dashboard.

Still Getting Detected

Try these:

1. 1. Update session ID in proxy username (forces new IP):

1. 2. Increase wait time before interacting with page:

1. 3. Check detection test:

1. 4. Try different geographic area (if specific region is blocked):

Limitations

• - CAPTCHAs: Stealth reduces but doesn't eliminate CAPTCHA challenges. For CAPTCHA solving, combine with 2captcha service.
• JavaScript fingerprinting: Advanced fingerprinting (Canvas, WebGL hash analysis) may still detect automation on highly protected sites.
• Cost: Residential proxy adds per-request cost. Use strategically.
• Speed: Proxy routing and stealth evasions add latency vs direct requests.

Security Notes

Capabilities: This skill is read-only — it fetches web pages, captures screenshots, and extracts text/HTML. It does not perform any financial operations, value transfers, or wallet interactions.

Authentication: Proxy credentials are used solely for routing HTTP traffic through residential IPs. They do not grant access to any financial accounts or value-bearing systems.

• - Proxy credentials contain sensitive auth tokens. Keep ~/.config/smartproxy/proxy.json with 600 permissions.
• Never commit proxy credentials to git repositories.
• Residential proxy traffic is routed through real residential IPs. Respect rate limits and terms of service.
• No value-transfer risk: this tool cannot send transactions, move funds, or interact with smart contracts.

See Also

• - 2captcha skill: For solving CAPTCHAs when stealth isn't enough
• Smartproxy dashboard: https://dashboard.smartproxy.com for usage monitoring
• Bot detection test: https://bot.sannysoft.com to verify stealth effectiveness