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, которые из коробки проходят WAF вроде Cloudflare, Kasada и DataDome.
Это отдельный инструмент или скорее обёртка над чем-то другим?По сути это тонкая обёртка над оригинальной библиотекой Patchright с дополнительной конфигурацией и удобствами рабочего процесса, которые, по словам автора, упрощают старт по сравнению с голым Patchright.
Как его запустить?Выполните шаги настройки для Linux из README, затем настройте файл .env (путь к бинарнику Chrome, часовой пояс, число параллельных сессий и URL стартовой страницы) перед запуском.
Нужно ли устанавливать Chrome отдельно?Да — по умолчанию ожидается Google Chrome в /usr/bin/google-chrome-stable; можно указать BROWSER_EXECUTABLE_PATH на другой бинарник, если ваш лежит в другом месте.
Гарантирует ли он обход WAF вроде Cloudflare?В README лишь утверждается, что сессии 'проходят Cloudflare, Kasada, DataDome и другие WAF из коробки', без гарантий, и собственных подмен отпечатков он не добавляет — он полностью полагается на то, что уже покрыто встроенными stealth-патчами Patchright.
Он работает и на Windows или macOS, или только на Linux?В README описана настройка только для Linux, поэтому Windows/macOS не охвачены — считайте его Linux-first, если сами не проверите на других системах.
На какие приёмы против обнаружения он опирается?Он полностью опирается на stealth-патчи Patchright: закрыта утечка Runtime.enable, добавлен --disable-blink-features=AutomationControlled, убран --enable-automation, а navigator.webdriver нативно возвращает false — дополнительной подмены отпечатков сверху нет.
Можно запускать несколько браузерных сессий одновременно?Да, настройка MAX_PARALLEL в .env определяет, сколько сессий работает одновременно; по умолчанию — 1.
Закрывает ли браузер сам себя по завершении?Нет, сессия остаётся открытой, пока вы вручную не закроете окно браузера; после перехода на стартовую страницу он не завершается автоматически.
На каком стеке это построено?Это проект на Node.js/TypeScript, построенный прямо на библиотеке Patchright, которая сама — форк Playwright со stealth-патчами.
Creator
whaleyxbt
Size
0.1 MB
Stars
499
Updated
CommitOct 10
Age
6mo
Commits · 90 Days