patchright-enhanced README

The project's README from github.com/whaleyxbt/patchright-enhanced. As one markdown file: README.md.

patchright-enhanced

stealth browser automation framework for penetration testing, scraping, and WAF bypass. Built on Patchright.

clean chrome sessions that pass Cloudflare, Kasada, DataDome, and other WAFs out of the box.

that's basically just a wrapper around OG patchright, so it's easier to get started.

Setup for Linux

# Install dependencies
npm install

# Install Chrome for Patchright
npx patchright install chrome

# Copy env template and configure
cp .env.example .env

# Add your proxies
# Format: host:port:username:password (one per line)
nano proxies.txt

Configuration

All settings are in .env:

Variable Default Description
BROWSER_EXECUTABLE_PATH /usr/bin/google-chrome-stable Path to Chrome binary
BROWSER_TIMEZONE Europe/Berlin Browser timezone
MAX_PARALLEL 1 Number of parallel sessions
START_PAGE_URL https://google.com/ Initial page to open

Usage

npm run build
npm start

it opens a chrome session with the configured proxy and navigates to START_PAGE_URL. the session stays open until you close the browser window manually.

Anti-Detection

my small framework relies entirely on patchright's built-in stealth patches:

patchright-enhanced (whaleyxbt/patchright-enhanced)

Searching Database…

这是什么?这是一个构建在 Patchright(打过补丁的 Playwright)之上的隐身浏览器自动化工具包,面向 QA 测试、监控、抓取和渗透测试。它专注于产出干净的 Chrome 会话,开箱即可通过 Cloudflare、Kasada 和 DataDome 等 WAF。
这是独立工具,还是更多是对其他东西的封装?它本质上是对原版 Patchright 库的一层薄封装,叠加了额外的配置和工作流便利,作者表示这比直接使用原始 Patchright 更容易上手。
怎么让它跑起来?按照 README 中的 Linux 设置步骤操作,然后配置 .env 文件(Chrome 可执行文件路径、时区、并行会话数和起始页 URL),再启动它。
我需要单独安装 Chrome 吗?需要——默认它期望 Google Chrome 位于 /usr/bin/google-chrome-stable;如果你的 Chrome 在别处,可以把 BROWSER_EXECUTABLE_PATH 指向其他可执行文件。
它能保证绕过 Cloudflare 这类 WAF 吗?README 只是声称会话“开箱即可通过 Cloudflare、Kasada、DataDome 和其他 WAF”,并没有做出保证,而且它自身不添加任何指纹伪装——完全依赖 Patchright 内置隐身补丁已经覆盖的范围。
它也能在 Windows 或 macOS 上运行,还是只能在 Linux 上?README 只记录了 Linux 的设置,没有覆盖 Windows/macOS——除非你自己在其他系统上测试过,否则请把它当作 Linux 优先。
它依赖哪些反检测手段?它完全依赖 Patchright 的隐身补丁:修复了 Runtime.enable 泄漏,添加了 --disable-blink-features=AutomationControlled,移除了 --enable-automation,navigator.webdriver 原生返回 false,没有再叠加额外的指纹伪装。
我能同时运行多个浏览器会话吗?可以,.env 中的 MAX_PARALLEL 设置控制同时运行的会话数量,默认值为 1。
浏览器会在用完后自行关闭吗?不会,会话会一直保持打开,直到你手动关闭浏览器窗口;导航到起始页之后它不会自动结束。
它是用什么技术栈构建的?这是一个 Node.js/TypeScript 项目,直接构建在 Patchright 库之上,而 Patchright 本身是 Playwright 的隐身补丁分支。
Creator
whaleyxbt
Size
0.1 MB
Stars
499
Updated
CommitOct 10
Age
6mo
Commits · 90 Days