b0tresch-stealth-browserAnti-detection web browsing that bypasses bot detection, CAPTCHAs, and IP blocks using puppeteer-extra with stealth plugin and optional residential proxy sup...
Install via ClawdBot CLI:
clawdbot install b0tresch/b0tresch-stealth-browserBypass bot detection and IP blocks with puppeteer-extra stealth plugin and optional Smartproxy residential proxy support.
ā Relay.link (was blocked by Vercel, now works)
ā X/Twitter profiles
ā Bot detection tests (sannysoft.com)
ā Faucet sites with protection
ā Reddit (datacenter IP blocks)
# 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 --textcd /path/to/skill
npm installRequired packages (automatically handled by npm install with included package.json):
puppeteer-extrapuppeteer-extra-plugin-stealthpuppeteerFor 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.
The browser includes multiple anti-detection measures:
navigator.webdriver flag--proxy used):| Protection | Headless Puppeteer | Stealth Plugin | + Residential Proxy |
|------------|-------------------|----------------|-------------------|
| navigator.webdriver | ā Detected | ā Hidden | ā Hidden |
| User Agent | ā Generic | ā Realistic | ā Realistic |
| WebGL/Canvas | ā Headless | ā Spoofed | ā Spoofed |
| IP Blocks | ā Datacenter | ā Datacenter | ā Residential |
| Cloudflare | ā Blocked | ā ļø Sometimes | ā Usually works |
| Turnstile CAPTCHA | ā Blocked | ā Blocked | ā ļø Reduced chance |
# Test on bot detection site
node scripts/browser.js "https://bot.sannysoft.com" --screenshot detection.pngLook for green checkmarks = undetected, red = detected.
# Get page text content
node scripts/browser.js "https://protected-site.com" --proxy --text > output.txt# Take daily screenshot for comparison
node scripts/browser.js "https://target-site.com" --proxy --screenshot "$(date +%Y-%m-%d).png"import { browse } from './scripts/browser.js';
const result = await browse('https://example.com', {
proxy: true,
html: true
});
// Parse result.html with cheerio or similar
console.log(result.html);Smartproxy residential pricing:
When to use proxy:
When stealth-only is enough:
Error: Failed to launch the browser processSolution: Install required system dependencies:
# Debian/Ubuntu
sudo apt-get install -y gconf-service libasound2 libatk1.0-0 libc6 libcairo2 \
libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgcc1 libgconf-2-4 \
libgdk-pixbuf2.0-0 libglib2.0-0 libgtk-3-0 libnspr4 libpango-1.0-0 \
libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 \
libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 \
libxrandr2 libxrender1 libxss1 libxtst6 ca-certificates fonts-liberation \
libappindicator1 libnss3 lsb-release xdg-utils wgetError: net::ERR_PROXY_AUTH_REQUESTEDSolution: Check proxy credentials in ~/.config/smartproxy/proxy.json. Verify username/password are correct in Smartproxy dashboard.
Try these:
"username": "smart-ppz3iii4l2qr_area-US_life-30_session-NEW_RANDOM_STRING"
await page.goto(url, { waitUntil: 'networkidle2' });
await page.waitForTimeout(5000); // Wait 5s
node scripts/browser.js "https://bot.sannysoft.com" --proxy --screenshot test.png
"username": "smart-ppz3iii4l2qr_area-GB_life-30_session-xxxxx"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.
~/.config/smartproxy/proxy.json with 600 permissions.Generated Mar 1, 2026
Marketing teams can use this skill to anonymously monitor competitor websites and social media profiles without triggering bot detection, allowing them to track pricing changes, product launches, and promotional campaigns in real-time. It bypasses IP blocks on platforms like Twitter/X and Reddit, ensuring continuous data collection from protected sources.
News agencies or content platforms can scrape articles and updates from websites with anti-bot protections, such as those using Cloudflare, to compile news feeds without manual intervention. The residential proxy avoids IP-based rate limits, enabling large-scale extraction while maintaining access to geographically restricted content.
Financial institutions can simulate automated attacks on their own web applications to test security measures against bot-driven fraud, such as credential stuffing or fake account creation. The stealth features help mimic human behavior, providing realistic assessments of detection systems without being blocked during penetration testing.
Retail businesses can automate price tracking across e-commerce sites that block datacenter IPs, using the residential proxy to appear as legitimate users and avoid bans. This ensures accurate competitor pricing data for dynamic pricing strategies, especially on platforms with strict automation detection.
Researchers can gather data from social media platforms like Reddit or Twitter/X for studies on user behavior, bypassing automation blocks that typically restrict API access. The stealth browser allows ethical scraping of public content without detection, supporting large-scale analysis while adhering to terms of service.
Offer a cloud-based platform where users submit URLs to receive stealth-browsed data, such as screenshots or extracted content, via API calls. Charge monthly fees based on usage tiers (e.g., number of requests or data volume), leveraging the skill's proxy integration for reliable access to protected sites.
Provide bespoke development services to integrate this skill into client workflows, such as building tailored scrapers for specific industries like real estate or job listings. Charge project-based fees or retainers for ongoing maintenance, using the skill's stealth capabilities to solve unique client challenges.
Use the skill to collect and aggregate data from hard-to-access websites, then clean and package it for sale to businesses in sectors like market research or lead generation. Monetize through one-time sales or licensing agreements, with costs managed via proxy usage optimization.
š¬ Integration Tip
Integrate this skill by calling its Node.js scripts from your application, ensuring system dependencies are installed and proxy credentials are securely stored to avoid authentication errors during automation.
A fast Rust-based headless browser automation CLI with Node.js fallback that enables AI agents to navigate, click, type, and snapshot pages via structured commands.
Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications.
Advanced desktop automation with mouse, keyboard, and screen control
Manage n8n workflows and automations via API. Use when working with n8n workflows, executions, or automation tasks - listing workflows, activating/deactivating, checking execution status, manually triggering workflows, or debugging automation issues.
Design and implement automation workflows to save time and scale operations as a solopreneur. Use when identifying repetitive tasks to automate, building workflows across tools, setting up triggers and actions, or optimizing existing automations. Covers automation opportunity identification, workflow design, tool selection (Zapier, Make, n8n), testing, and maintenance. Trigger on "automate", "automation", "workflow automation", "save time", "reduce manual work", "automate my business", "no-code automation".
Browser automation via Playwright MCP server. Navigate websites, click elements, fill forms, extract data, take screenshots, and perform full browser automation workflows.