Skip to content
Back to search

playwright-bot-bypass

MarketplaceWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/greekr4--playwright-bot-bypass/badge.svg)](/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)

  1. {
  2. "name": "playwright-bot-bypass",
  3. "owner": {
  4. "name": "greekr4",
  5. "url": "https://github.com/greekr4"
  6. },
  7. "description": "Stealth browser automation — bypass bot detection with rebrowser-playwright / undetected-chromedriver.",
  8. "plugins": [
  9. {
  10. "name": "playwright-bot-bypass",
  11. "source": "./",
  12. "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.",
  13. "version": "2.2.2",
  14. "author": {
  15. "name": "greekr4"
  16. },
  17. "homepage": "https://github.com/greekr4/playwright-bot-bypass",
  18. "repository": "https://github.com/greekr4/playwright-bot-bypass",
  19. "license": "MIT",
  20. "category": "automation",
  21. "keywords": [
  22. "playwright",
  23. "bot-detection",
  24. "stealth",
  25. "captcha-bypass",
  26. "web-scraping",
  27. "automation",
  28. "rebrowser",
  29. "undetected-chromedriver"
  30. ]
  31. }
  32. ]
  33. }
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)

  1. # playwright-bot-bypass
  2. [![Claude Code plugin](https://img.shields.io/badge/Claude%20Code-plugin-d97757)](https://github.com/greekr4/playwright-bot-bypass)
  3. [![Codex · Cursor](https://img.shields.io/badge/Codex%20·%20Cursor-skill-000000)](https://skills.sh)
  4. [![version](https://img.shields.io/badge/version-2.2.0-blue)](https://github.com/greekr4/playwright-bot-bypass/releases)
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-green)](LICENSE)
  6. [![detectors](https://img.shields.io/badge/bot%20detectors-8%2F8%20pass-brightgreen)](skills/playwright-bot-bypass/SKILL.md)
  7. **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.
  8. <p align="center">
  9. <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" />
  10. </p>
  11. > ⚠️ **Authorized use only** — QA, accessibility, and research on sites you own or may test. Respect each site's ToS, `robots.txt`, and the law.
  12. ## Install
  13. **Claude Code**
  14. ```
  15. /plugin marketplace add greekr4/playwright-bot-bypass
  16. /plugin install playwright-bot-bypass@playwright-bot-bypass
  17. ```
  18. **Codex · Cursor · any agent** — one command via [skills.sh](https://skills.sh):
  19. ```bash
  20. npx skills add greekr4/playwright-bot-bypass # all detected agents
  21. npx skills add greekr4/playwright-bot-bypass -a codex # Codex only
  22. ```
  23. Then just describe the task, or invoke it explicitly with `$playwright-bot-bypass …`.
  24. ## Quick start
  25. ```bash
  26. npm install rebrowser-playwright
  27. ```
  28. ```javascript
  29. import { createStealthBrowser, humanType, simulateMouseMovement } from './scripts/stealth-template.mjs';
  30. const { browser, page } = await createStealthBrowser();
  31. try {
  32. await page.goto('https://example.com');
  33. await simulateMouseMovement(page);
  34. await humanType(page, 'input', 'query');
  35. } finally {
  36. await browser.close(); // always in finally, or the process hangs
  37. }
  38. ```
  39. Prefer Python? `pip install undetected-chromedriver` → `uc.Chrome()`. (Skip `playwright-stealth` — it only patches JS, so WebGL still leaks SwiftShader.)
  40. ## What it beats — and what it doesn't
  41. | ✅ Beats | 🚫 Doesn't touch |
  42. |---|---|
  43. | Fingerprint + automation detectors — sannysoft, rebrowser, deviceandbrowserinfo, browserscan, iphey, creepjs (**9/9 reproducible**) | IP reputation & rate limits |
  44. | Real UA, WebGL/GPU, canvas, PluginArray — genuine, **not** JS-spoofed | Behavioral / CAPTCHA gates (Turnstile, DataDome, Kasada) |
  45. | Google search + public Reddit / YouTube / TikTok / X with no bot wall | Login walls 🟡 (Instagram, Facebook, LinkedIn) |
  46. 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).
  47. ## A/B: plain Playwright vs this skill
  48. 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.
  49. **deviceandbrowserinfo.com — "Are you a bot?"**
  50. | A · plain Playwright | B · this skill |
  51. |:---:|:---:|
  52. | ![A: detected as a bot](img/ab-dabi-before.png) | ![B: detected as human](img/ab-dabi-after.png) |
  53. | ❌ **"You are a bot!"** (`isBot: true`) | ✅ **"You are human!"** (`isBot: false`) |
  54. **bot-detector.rebrowser.net — CDP / automation tests**
  55. | A · plain Playwright | B · this skill |
  56. |:---:|:---:|
  57. | ![A: red flags](img/ab-rebrowser-before.png) | ![B: all green](img/ab-rebrowser-after.png) |
  58. | 🔴 `navigatorWebdriver = true` | 🟢 all green — `webdriver false`, no `__pwInitScripts`, no Runtime leak |
  59. **bot.sannysoft.com — fingerprint suite**
  60. | A · plain Playwright | B · this skill |
  61. |:---:|:---:|
  62. | ![A: detected](img/ab-sannysoft-before.png) | ![B: passed](img/ab-sannysoft-after.png) |
  63. | Red rows: WebDriver / UA = HeadlessChrome / WebGL SwiftShader | All green — real Chrome UA, Apple M2 WebGL, `webdriver false` |
  64. ## How it works
  65. Three layers do the work — mostly the real browser, barely any hand-written JS:
  66. 1. **rebrowser-playwright + Runtime-fix** — hides the CDP `Runtime.enable` headless leak, reports `webdriver: false`.
  67. 2. **`channel:'chrome'` + headed** — real UA, GPU/WebGL, canvas, plugins, and `navigator.languages` via `locale`.
  68. 3. **Artifact strip** — deletes `window.__pwInitScripts` on every navigation (the `isPlaywright` signature).
  69. 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`.
  70. ## Requirements
  71. Node.js 18+ · real Google Chrome (not just Chromium) · headed mode (`headless: false`, display required).
  72. ## Credits
  73. 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).
  74. ## License
  75. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.