playwright-bot-bypass v2.0

Claude Code skill to bypass bot detection using rebrowser-playwright with 8 stealth patches.

Installation

npx skills add greekr4/playwright-bot-bypass

Features

• Pass bot.sannysoft.com all tests
• Google search without CAPTCHA
• Twitter/X scraping without login
• Real GPU fingerprint (Apple M2, NVIDIA, etc.)
• 8 fingerprint patches (webdriver, plugins, languages, permissions, canvas, etc.)
• Human-like behavior simulation (mouse movement, typing delays)
• Cookie persistence & proxy support
• Works with Node.js and Python

A/B Test: bluer.co.kr (Real-World Bot Detection)

Tested against Blue Ribbon Survey — a site with active bot protection:

Metric	Stealth (this skill)	Normal Playwright
HTTP Status	200 OK	403 Forbidden
navigator.webdriver	undefined	true
navigator.plugins	3 (patched)	0 (detected)
navigator.languages	[ko-KR, ko, en-US, en]	[en-US]
outerWidth - innerWidth	16 (real chrome)	0 (headless)
chrome.runtime	Present	Missing
WebGL Renderer	Apple M2 (real GPU)	SwiftShader (software)
User-Agent	Clean Chrome	HeadlessChrome

bot.sannysoft.com A/B

Standard Playwright (Detected)	rebrowser-playwright (Bypassed)

Stealth Patches (8 vectors)

#	Patch	Bypasses
1	navigator.webdriver removal	All bot detectors
2	chrome.runtime object	Cloudflare, sannysoft
3	navigator.plugins (3 plugins)	Cloudflare Bot Management
4	navigator.languages (ko-KR, en)	Akamai (cross-checks HTTP header)
5	Permissions API normalization	PerimeterX
6	hardwareConcurrency / deviceMemory	Advanced fingerprinters
7	outerWidth / outerHeight offset	Headless detection
8	Canvas fingerprint noise	Cloudflare Turnstile

Plus: --disable-blink-features=AutomationControlled, --no-sandbox, real Chrome via channel: 'chrome'

Quick Start

Node.js (Recommended)

npm init -y && npm install rebrowser-playwright

Using the template (recommended)

import { createStealthBrowser, humanDelay, humanType, simulateMouseMovement } from './scripts/stealth-template.mjs';

const { browser, page } = await createStealthBrowser();

try {
  await page.goto('https://example.com');
  await simulateMouseMovement(page);  // Natural mouse movement
  await humanType(page, 'input', 'query');  // Human-like typing
  await humanDelay(300, 800);
} finally {
  await browser.close();
}

Template options

createStealthBrowser({
  headless: false,              // Required for stealth (default)
  viewport: { width: 1280, height: 800 },
  locale: 'ko-KR',             // Browser locale
  storageState: './session.json',  // Cookie persistence
  proxy: { server: 'http://proxy:8080' }  // Proxy support
});

Manual setup

import { chromium } from 'rebrowser-playwright';

const browser = await chromium.launch({
  headless: false,
  channel: 'chrome',
  args: ['--disable-blink-features=AutomationControlled', '--no-sandbox']
});

const context = await browser.newContext({
  locale: 'ko-KR',
  extraHTTPHeaders: { 'Accept-Language': 'ko-KR,ko;q=0.9,en-US;q=0.8,en;q=0.7' }
});

await context.addInitScript(() => {
  delete Object.getPrototypeOf(navigator).webdriver;
  // ... see SKILL.md for full patch list
});

const page = await context.newPage();
try {
  await page.goto('https://google.com');
} finally {
  await browser.close();
}

Python

pip install undetected-chromedriver

import undetected_chromedriver as uc

driver = uc.Chrome()  # auto-detects Chrome version
driver.get('https://google.com')

Python playwright-stealth only patches at JS level — WebGL still shows SwiftShader. Use undetected-chromedriver instead.

Test Results

Environment	bot.sannysoft.com	Google Search	bluer.co.kr
Standard Playwright	Detected	CAPTCHA	403
rebrowser-playwright (this)	Pass	Works	200
playwright-stealth (Python)	Pass	CAPTCHA	-
undetected-chromedriver	Pass	Works	-

Scripts Included

skills/playwright-bot-bypass/
  scripts/
    stealth-template.mjs      # Reusable stealth factory (all examples import this)
    bot-detection-test.mjs     # Verify bypass at bot.sannysoft.com
  examples/
    stealth-google-search.mjs  # Google search without CAPTCHA
    ab-test.mjs                # Side-by-side detected vs stealth
    stealth-twitter-scrape.mjs # Twitter/X profile scraping
  package.json                 # Dependencies (type: module)
  marketplace.json
  SKILL.md                     # Full documentation for Claude Code agents

Requirements

• Node.js 18+ (ESM / .mjs)
• Google Chrome installed (not just Chromium)
• Headed mode (display required — headless: false)

Troubleshooting

Problem	Fix
ERR_MODULE_NOT_FOUND	Run npm install rebrowser-playwright in your script directory
Browser not opening	Verify Chrome: /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --version
WebGL shows SwiftShader	Confirm import is from rebrowser-playwright, not playwright
Still getting detected	Add simulateMouseMovement() and humanDelay() between actions
Process hangs	Ensure browser.close() is in a finally block

License

MIT