playwright-bot-bypass
Stealth browser automation — bypass bot detection with rebrowser-playwright / undetected-chromedriver.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/greekr4--playwright-bot-bypass)HTML
<a href="/listings/greekr4--playwright-bot-bypass"><img src="/api/listings/greekr4--playwright-bot-bypass/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
**Claude Code**
/plugin marketplace add greekr4/playwright-bot-bypass /plugin install playwright-bot-bypass@playwright-bot-bypass
**Codex · Cursor · any agent** — one command via [skills.sh](https://skills.sh):
npx skills add greekr4/playwright-bot-bypass # all detected agents npx skills add greekr4/playwright-bot-bypass -a codex # Codex only
Then just describe the task, or invoke it explicitly with `$playwright-bot-bypass …`.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 33 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "playwright-bot-bypass",
- "owner": {
- "name": "greekr4",
- "url": "https://github.com/greekr4"
- },
- "description": "Stealth browser automation — bypass bot detection with rebrowser-playwright / undetected-chromedriver.",
- "plugins": [
- {
- "name": "playwright-bot-bypass",
- "source": "./",
- "description": "Reduce bot detection using rebrowser-playwright + real headed Chrome. Passes fingerprint checkers (bot.sannysoft.com, areyouheadless) and avoids triggering CAPTCHAs. Includes a Python undetected-chromedriver path. Authorized-use only.",
- "version": "2.2.2",
- "author": {
- "name": "greekr4"
- },
- "homepage": "https://github.com/greekr4/playwright-bot-bypass",
- "repository": "https://github.com/greekr4/playwright-bot-bypass",
- "license": "MIT",
- "category": "automation",
- "keywords": [
- "playwright",
- "bot-detection",
- "stealth",
- "captcha-bypass",
- "web-scraping",
- "automation",
- "rebrowser",
- "undetected-chromedriver"
- ]
- }
- ]
- }
README.md · README · 111 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # playwright-bot-bypass
- [](https://github.com/greekr4/playwright-bot-bypass)
- [](https://skills.sh)
- [](https://github.com/greekr4/playwright-bot-bypass/releases)
- [](LICENSE)
- [](skills/playwright-bot-bypass/SKILL.md)
- **Undetected browser automation that passes 8/8 bot detectors** — with a *real* headed Chrome instead of fragile JS fakes. It's glue + tuning over [`rebrowser-playwright`](https://github.com/rebrowser/rebrowser-patches) and [`undetected-chromedriver`](https://github.com/ultrafunkamsterdam/undetected-chromedriver), shipped as a one-import `createStealthBrowser()` and an agent skill.
- <p align="center">
- <img src="img/demo.gif" alt="Same command, same site, side by side: plain Playwright gets 'You are a bot!', while playwright-bot-bypass loads the real page." width="760" />
- </p>
- > ⚠️ **Authorized use only** — QA, accessibility, and research on sites you own or may test. Respect each site's ToS, `robots.txt`, and the law.
- ## Install
- **Claude Code**
- ```
- /plugin marketplace add greekr4/playwright-bot-bypass
- /plugin install playwright-bot-bypass@playwright-bot-bypass
- ```
- **Codex · Cursor · any agent** — one command via [skills.sh](https://skills.sh):
- ```bash
- npx skills add greekr4/playwright-bot-bypass # all detected agents
- npx skills add greekr4/playwright-bot-bypass -a codex # Codex only
- ```
- Then just describe the task, or invoke it explicitly with `$playwright-bot-bypass …`.
- ## Quick start
- ```bash
- npm install rebrowser-playwright
- ```
- ```javascript
- import { createStealthBrowser, humanType, simulateMouseMovement } from './scripts/stealth-template.mjs';
- const { browser, page } = await createStealthBrowser();
- try {
- await page.goto('https://example.com');
- await simulateMouseMovement(page);
- await humanType(page, 'input', 'query');
- } finally {
- await browser.close(); // always in finally, or the process hangs
- }
- ```
- Prefer Python? `pip install undetected-chromedriver` → `uc.Chrome()`. (Skip `playwright-stealth` — it only patches JS, so WebGL still leaks SwiftShader.)
- ## What it beats — and what it doesn't
- | ✅ Beats | 🚫 Doesn't touch |
- |---|---|
- | Fingerprint + automation detectors — sannysoft, rebrowser, deviceandbrowserinfo, browserscan, iphey, creepjs (**9/9 reproducible**) | IP reputation & rate limits |
- | Real UA, WebGL/GPU, canvas, PluginArray — genuine, **not** JS-spoofed | Behavioral / CAPTCHA gates (Turnstile, DataDome, Kasada) |
- | Google search + public Reddit / YouTube / TikTok / X with no bot wall | Login walls 🟡 (Instagram, Facebook, LinkedIn) |
- One residual leak, `__playwright_builtins__`, can't be stripped by any current rebrowser version. Full measured matrix → [`SKILL.md`](skills/playwright-bot-bypass/SKILL.md).
- ## A/B: plain Playwright vs this skill
- Measured **2026-06-10** (macOS, Apple Silicon). **A** = default `playwright` (headless bundled Chromium, no stealth). **B** = this skill via `createStealthBrowser()` (headed real Chrome + rebrowser Runtime-fix + Playwright-artifact strip). Same machine, same detectors.
- **deviceandbrowserinfo.com — "Are you a bot?"**
- | A · plain Playwright | B · this skill |
- |:---:|:---:|
- |  |  |
- | ❌ **"You are a bot!"** (`isBot: true`) | ✅ **"You are human!"** (`isBot: false`) |
- **bot-detector.rebrowser.net — CDP / automation tests**
- | A · plain Playwright | B · this skill |
- |:---:|:---:|
- |  |  |
- | 🔴 `navigatorWebdriver = true` | 🟢 all green — `webdriver false`, no `__pwInitScripts`, no Runtime leak |
- **bot.sannysoft.com — fingerprint suite**
- | A · plain Playwright | B · this skill |
- |:---:|:---:|
- |  |  |
- | Red rows: WebDriver / UA = HeadlessChrome / WebGL SwiftShader | All green — real Chrome UA, Apple M2 WebGL, `webdriver false` |
- ## How it works
- Three layers do the work — mostly the real browser, barely any hand-written JS:
- 1. **rebrowser-playwright + Runtime-fix** — hides the CDP `Runtime.enable` headless leak, reports `webdriver: false`.
- 2. **`channel:'chrome'` + headed** — real UA, GPU/WebGL, canvas, plugins, and `navigator.languages` via `locale`.
- 3. **Artifact strip** — deletes `window.__pwInitScripts` on every navigation (the `isPlaywright` signature).
- The v2.2 insight: *removing* fake `navigator` patches (spoofed plugins, canvas noise, `webdriver` delete…) beats adding them — every fake created a detectable inconsistency. So v2.2 touches nothing on `navigator`.
- ## Requirements
- Node.js 18+ · real Google Chrome (not just Chromium) · headed mode (`headless: false`, display required).
- ## Credits
- Glue + tuning over other people's work: [rebrowser-patches](https://github.com/rebrowser/rebrowser-patches), [undetected-chromedriver](https://github.com/ultrafunkamsterdam/undetected-chromedriver), real Chrome via `channel:'chrome'`, and the detection research that verifies it — [sannysoft](https://bot.sannysoft.com), [rebrowser-bot-detector](https://github.com/rebrowser/rebrowser-bot-detector), [deviceandbrowserinfo](https://deviceandbrowserinfo.com), [browserscan](https://www.browserscan.net), [CreepJS](https://abrahamjuliot.github.io/creepjs/). Original here is the integration: the `createStealthBrowser()` factory, the verified v2.2 recipe, and the agent-facing [`SKILL.md`](skills/playwright-bot-bypass/SKILL.md).
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.