<h1 align="center">
🎭 Patchright
</h1>
<p align="center">
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright/blob/main/LICENSE">
<img src="https://img.shields.io/badge/License-Apache%202.0-green">
</a>
<a>
<img src="https://img.shields.io/badge/Based%20on-Playwright-goldenrod">
</a>
<a>
<img src="https://img.shields.io/badge/Driver-Patched-blue">
</a>
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright/releases/latest">
<img alt="Patchright Version" src="https://img.shields.io/github/v/release/Kaliiiiiiiiii-Vinyzu/patchright?display_name=release&label=Version">
</a>
<br/>
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python">
<img src="https://img.shields.io/badge/Package-Python-seagreen">
</a>
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python/releases">
<img alt="Python Downloads" src="https://img.shields.io/pepy/dt/patchright?color=red&label=Python%20Downloads">
</a>
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-nodejs">
<img src="https://img.shields.io/badge/Package-NodeJS-seagreen">
</a>
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-nodejs/releases">
<img alt="NodeJS Downloads" src="https://img.shields.io/npm/d18m/patchright?color=red&label=NodeJS%20Downloads">
</a>
<a href="https://github.com/DevEnterpriseSoftware/patchright-dotnet">
<img src="https://img.shields.io/badge/Package-.Net-seagreen">
</a>
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-nodejs/releases">
<img alt=".Net Downloads" src="https://img.shields.io/nuget/dt/Patchright?label=.Net%20Downloads">
</a>
<br/>
<img src="https://img.shields.io/github/actions/workflow/status/Kaliiiiiiiiii-Vinyzu/patchright/patchright_tests.yml?label=Patchright%20Driver%20Tests">
<img src="https://img.shields.io/github/actions/workflow/status/Kaliiiiiiiiii-Vinyzu/patchright-python/patchright_tests.yml?label=Patchright%20Python%20Tests">
<img src="https://img.shields.io/github/actions/workflow/status/DevEnterpriseSoftware/patchright-dotnet/patchright_test.yml?label=Patchright%20.Net%20Tests">
</p>
#### Patchright は、Playwright テスト・自動化フレームワークのパッチ適用済みかつ未検出のバージョンです。</br> Playwright のドロップイン代替として使用できます。
> [!NOTE]
> このリポジトリは Patchright Driver を提供しています。Patchright を使用するには、[Python パッケージ](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python)、[NodeJS パッケージ](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-nodejs)、または _コミュニティ主導の_ [.Net パッケージ](https://github.com/DevEnterpriseSoftware/patchright-dotnet/) をご確認ください。
> [!IMPORTANT]
> Patchright は CHROMIUM ベースのブラウザのみにパッチを適用します。Firefox と Webkit はサポートされていません。
---
<details open id="sponsors">
<summary><h3>スポンサー</h1></summary>
<sup>このプロジェクトをスポンサーしたいですか？Discord で [@vinyzu](https://discordapp.com/users/935224495126487150) までご連絡ください！</sup>
[<img width="60%" alt="NodeMaven Banner" src="https://assets.kitploit.com/production/public/readmes/41476/8409e9fd4ecade7fa018f576c77d6f51fb342f311f9e8e2b49984de007b5a605/fc71d82e04f5dc303d21f905310e811885d8a6a57ddffe892b4164bf12547371-display-v1.webp" />](https://go.nodemaven.com/Vinyzuoctober)
</br>
#### [NodeMaven](https://go.nodemaven.com/Vinyzuoctober): 高品質 IP を備えた、Web スクレイピングと自動化のための効率的なプロキシプロバイダー。
なぜ [NodeMaven](https://go.nodemaven.com/Vinyzuoctober) なのか？
🎯 ZIP ターゲティング
</br>
✅ 99.9% 稼働率
</br>
🔍 IP フィルタリング: プロキシは不正スコアが 97% 未満であることが保証されています
</br>
🔰 KYC 不要
</br>
🎉 ユニークな無料ツール: Proxy Bandwidth Checker、Meta Tag Checker、IP Lookup など！
Patchright ユーザー向けの**特別コード**:
</br>
🔥 **PATCHRIGHT35** - モバイルおよびレジデンシャルプロキシが **35% オフ**
</br>
🔥 **PATCHRIGHT40** - ISP（静的）プロキシが **40% オフ**
<sup>[NodeMaven](https://go.nodemaven.com/Vinyzuoctober)で品質と安定性を選びましょう。</sup>
</br>
<sup>Webスクレイピングと自動化のさらなるソリューションについては、Nodemavenの新しいGitHubをチェックしてください - https://github.com/nodemaven</sup>
---
[<img height="100" alt="swiftproxy banner" src="https://assets.kitploit.com/production/public/readmes/41476/71326e65aa66112fe5c3cd5a61951b775d58850b93eaaf166fd77930681f5174.png" />](https://www.swiftproxy.net/?ref=Vinyzu)
#### [Swiftproxy](https://www.swiftproxy.net/?ref=Vinyzu): スケーラブルなデータ収集のための高性能レジデンシャルプロキシ
**信頼性の高い**検出回避プロキシインフラを必要とする開発者向けに構築されています。[Swiftproxy](https://www.swiftproxy.net/?ref=Vinyzu)は、**安定した接続**、**高い成功率**、そして**大規模なスクレイピングと自動化**のための柔軟な制御を提供します。
- 🌍 倫理的に調達されたレジデンシャルIPを備えた195以上のロケーション
- 🔄 正確なジオターゲティングを備えた**ローテーション**および**スティッキーセッション**
- ⚡ **BAN回避**と**高い成功率**に最適化
- 🔌 HTTP / HTTPS / SOCKS5対応
- 🧪 テスト用の**500MB無料トライアル**
- 💸 Patchrightユーザー向け**特別割引**コード: **PROXY90 - 10%**
<sup> 最適な用途: Webスクレイピング、自動化、マルチアカウント運用、大規模データ抽出 </sup>
---
[<img height="90" alt="rapidproxy banner" src="https://assets.kitploit.com/production/public/readmes/41476/2c138417cf7695cb48943327f3d6d9036986882c2a4ffe5e9172f07386a9f229.png" />](https://www.rapidproxy.io/?ref=Vinyzu)
#### [RapidProxy](https://www.rapidproxy.io/?ref=Vinyzu)は、大規模なデータ運用のために構築された安定した高性能プロキシネットワークを提供します。
[RapidProxy](https://www.rapidproxy.io/?ref=Vinyzu)が提供するもの:
- 🌍 9000万以上のレジデンシャルIP(200以上のロケーション)
- 🔄 **ローテーションレジデンシャルプロキシ** — **$0.65/GB**から(有効期限なしのトラフィック)
- 🧩 **静的レジデンシャルIP** — **$5/IP**(30日間、無制限トラフィック)
- 🎯 正確なジオターゲティング
- ⚡ **無料トライアルあり** — リスクなしでプロキシのパフォーマンスをテスト
- スクレイピング、自動化、高性能なデータワークフロー向けに構築
- 🔥 特別オファー: コード**RAPID10**を使用すると**10%オフ**
<sup> 素早く開始。グローバルにスケール。[RapidProxy](https://www.rapidproxy.io/?ref=Vinyzu)で安定性を維持。 </sup>
---
<div align="center">
<img src="https://assets.kitploit.com/production/public/readmes/41476/f3ac5dd3dd1ac541342eeda194f605fe1e28f9b044c0a90867b6db914c4a1b48/ad967b2ca510d337e9c8e72d654869c8fc75b08b088e358e074a6bbb003e6639-display-v1.webp" width="56" alt="Scrappey">
### [Scrappey](https://scrappey.com?utm_source=patchright&utm_medium=github&utm_campaign=repo_readme)によるスポンサード
</div>
ブラウザを検出から逃れることは1つの課題です。数百万のリクエストにわたってプロキシをローテーションし、フィンガープリントを最新の状態に保ち、セッションを維持することは別の課題です。**Scrappey**は2つ目の課題を引き受けます。1つのエンドポイントで、解決済みのページを返します。
- **Clearcote** — 自社でメンテナンスする独自のパッチ適用済みChromium。既製のビルドではありません
- **1つのエンドポイントの背後にある複数のエンジン** — あるスタックでブロックされたら、別のスタックにルーティング
- API経由で**クリック、入力、待機、スクロール** — フェッチプロキシではなく実際のセッション
- **レジデンシャルおよびデータセンタープロキシ**を込み、またはご自身のものを使用
- **リクエストごと**の課金、月額最低料金なし
```bash
curl -X POST "https://publisher.scrappey.com/api/v1?key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"cmd": "request.get", "url": "https://example.com"}'
```
コード `PATCHRIGHT` で10%オフ
[ドキュメント](https://scrappey.com/docs?utm_source=patchright&utm_medium=github&utm_campaign=repo_readme) · [Discord](https://scrappey.com/discord?utm_source=patchright&utm_medium=github&utm_campaign=repo_readme) · [APIキーを取得](https://scrappey.com?utm_source=patchright&utm_medium=github&utm_campaign=repo_readme)
---
[<img height="120" alt="ProxyLane Banner" src="https://assets.kitploit.com/production/public/readmes/41476/ed95563a028e0c1cefb4f5dccc8f7b69653f4c3fb7d5c4b5099b4cd5718714b7/7afb4fb03926a17d778280ff8bc7b2f62f5206d212d2b7525ea6ee90ae8ed0d3-display-v1.webp" />](https://proxylane.dev/?utm_source=patchright&utm_medium=partnership&utm_campaign=patchright_sponsor_202610&utm_content=readme)
</br>
#### [ProxyLane](https://proxylane.dev/?utm_source=patchright&utm_medium=partnership&utm_campaign=patchright_sponsor_202610&utm_content=readme): 各Patchrightプロファイルの一貫性を保つレジデンシャルプロキシ。
報告されるタイムゾーンをプロキシに一致させるには、各プロファイルに都市に固定された専用のスティッキーIPを割り当て、同じタイムゾーンを設定します:
```py
context = playwright.chromium.launch_persistent_context(
user_data_dir="...", channel="chrome", headless=False, no_viewport=True,
proxy={"server": "http://us.gw.proxylane.dev:10000",
"username": "USER_c_US_city_Chicago_s_profile1", # one sticky IP per profile
"password": "PASS"},
timezone_id="America/Chicago", locale="en-US", # match the proxy city
)
```
<sup>ヒント: `--webrtc-ip-handling-policy=disable_non_proxied_udp` を設定してください。そうしないと [WebRTC が実際の IP を露出します](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python/issues/47)。</sup>
:earth_africa: 195 か国、都市、ZIP、ASN をターゲットにした 2,800 万のレジデンシャル IP
</br>
:stopwatch: 最大 72 時間のスティッキーセッション、HTTP と SOCKS5
</br>
:money_with_wings: $2/GB から、トラフィックは無期限
:fire: **PATCHLANE35** - Patchright ユーザー向け **35% オフ**
<sup>スニペットを貼り付け、認証情報を追加して、[ProxyLane](https://proxylane.dev/?utm_source=patchright&utm_medium=partnership&utm_campaign=patchright_sponsor_202610&utm_content=readme_caption) で実際のレジデンシャル IP 上で次の Patchright セッションを実行してください。</sup>
</details>
---
## パッチ
### [Runtime.enable](https://vanilla.aslushnikov.com/?Runtime.enable) リーク
これは Patchright が使用する最大のパッチです。このリークによる検出を避けるため、patchright は (分離された) ExecutionContext 内で Javascript を実行することで [Runtime.enable](https://vanilla.aslushnikov.com/?Runtime.enable) の使用を回避します。
### [Console.enable](https://vanilla.aslushnikov.com/?Console.enable) リーク
Patchright は Console API を完全に無効化することでこのリークにパッチを当てます。つまり、Patchright ではコンソール機能は動作しません。どうしてもコンソールが必要な場合は、Javascript ロガーを使用する方がよいかもしれませんが、それらも簡単に検出される可能性があります。
### コマンドフラグのリーク
Patchright はコマンドフラグのリークによる検出を避けるため、Playwright のデフォルト引数を調整します。これは (最も重要な点として) 以下に影響します:
- `--disable-blink-features=AutomationControlled` (追加) navigator.webdriver の検出を回避するため。
- `--enable-automation` (削除) navigator.webdriver の検出を回避するため。
- `--disable-popup-blocking` (削除) ポップアップのクラッシュを回避するため。
- `--disable-component-update` (削除) ステルスドライバーとして検出されるのを回避するため。
- `--disable-default-apps` (削除) デフォルトアプリを有効化するため。
- `--disable-extensions` (削除) 拡張機能を有効化するため
### 一般的なリーク
Patchright は Playwright コードベース内のいくつかの一般的なリークにパッチを当てます。これには主に不適切な設定や明らかな検出ポイントが含まれます。
### クローズドシャドウルート
Patchright はクローズドシャドウルート内の要素と対話できます。通常のロケーターを使用するだけで、あとは Patchright が処理します。
<br/>
Patchright はクローズドシャドウルート内で XPath も使用できるようになりました。
---
## ステルス性
適切な設定を行えば、Patchright は現在検出不可能と見なされています。
Patchright は以下を通過します:
- [Brotector](https://kaliiiiiiiiii.github.io/brotector/) ✅ ([CDP-Patches](https://github.com/Kaliiiiiiiiii-Vinyzu/CDP-Patches/) を使用)
- [Cloudflare](https://cloudflare.com/) ✅
- [Kasada](https://www.kasada.io/) ✅
- [Akamai](https://www.akamai.com/products/bot-manager/) ✅
- [Shape/F5](https://www.f5.com/) ✅
- [Bet365](https://bet365.com/) ✅
- [Datadome](https://datadome.co/products/bot-protection/) ✅
- [Fingerprint.com](https://fingerprint.com/products/bot-detection/) ✅
- [CreepJS](https://abrahamjuliot.github.io/creepjs/) ✅
- [Sannysoft](https://bot.sannysoft.com/) ✅
- [Incolumitas](https://bot.incolumitas.com/) ✅
- [IPHey](https://iphey.com/) ✅
- [Browserscan](https://browserscan.net/) ✅
- [Pixelscan](https://pixelscan.net/) ✅
---
## バグ
#### Patchright を可能な限り安定させるために多くの時間を費やしてきましたが、それでもバグが発生する可能性があります。バグに遭遇した場合は、[Issues](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright/issues) で報告してください。
#### Patchright は現在、各リリース後に Playwright テストに対してテストされています。[こちら](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python/actions/workflows/patchright_tests.yml)をご覧ください。
> [!WARNING]
> Patchright は Playwright テストのほとんどを通過しますが、すべてではありません。解決不可能と見なされるバグもあれば、単に関連性がないものもあります。バグの一覧とその説明は[こちら](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright/issues/30)をご覧ください。
#### Playwright テストに基づき、通常のユースケースでこれらのバグに影響を受ける可能性は非常に低いと結論付けています。
<details>
<summary><b>Initスクリプトの仕掛け</b></summary>
### 説明
[Runtime.enable](https://vanilla.aslushnikov.com/?Runtime.enable) を使わずにInitScriptsを利用できるようにするため、PatchrightはPlaywright Routesを使用してHTMLリクエストにJavaScriptを注入します。
### バグ
Playwright Routesはコードの他の部分でいくつかのバグを引き起こす可能性があります。Patchright InitScriptsは、通常のPlaywright Routesで発生しないようなバグを引き起こすことはありません。</br> これらのバグの修正を希望する場合は、Playwrightチームに連絡する必要があります。
### リーク
Patchright InitScriptsはタイミング攻撃によって検出される可能性があります。ただし、現在この種のタイミング攻撃をチェックしているアンチボットは存在せず、おそらくしばらくの間は存在しないでしょう。</br> 私たちはこれらを検出の大きなリスクとは考えていません。
</details>
---
### TODO
- [x] 実行コンテキスト（Main/Isolated）を選択するオプションを実装する。
- [x] 修正可能なバグを修正する。
- [x] Patchrightのパッチを簡単に確認できる.patchアップデータを実装する。
- [x] 新リリース時の自動テストをセットアップする。
- [x] .NET上でPatchrightを実装する。
- [ ] Java上でPatchrightを実装する。
---
## 開発
新しいPatchrightバージョンのデプロイは自動で行われますが、Playwrightコードベースの変更に起因するバグが発生する可能性があります。これらのバグの修正がリリースされるまでには数日かかる場合があります。
---
## 私たちの活動を支援する
私たちの活動を支援していただける場合は、Discordで[@vinyzu](https://discord.com/users/935224495126487150)または[@steve_abcdef](https://discord.com/users/936292409426477066)までご連絡ください。
---
## 著作権とライセンス
© [Vinyzu](https://github.com/Vinyzu/)
Patchrightは[Apache 2.0](https://choosealicense.com/licenses/apache-2.0/)でライセンスされています。
[一部のコード](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright/blob/10c5a090e9a1dcd2107c253d65b3d8b27d0670a9/driver_patches/framesPatch.ts#L156-L171)は[Driverless](https://github.com/kaliiiiiiiiii/Selenium-Driverless)に着想を得ています。
.patchファイルによるドキュメント化のアイデアを提供してくれた[Nick Webson](https://github.com/rebrowser/rebrowser-patches)に感謝します。
---
## 免責事項
このリポジトリは**教育目的のみ**で提供されています。\
正確性、完全性、または特定の目的への適合性に関する保証は一切ありません。**自己責任でご使用ください**—作者およびメンテナーは、このコードの使用、改変、または配布に起因する**いかなる損害**、**法的問題**、または**保証違反**についても**一切の責任を負いません**。\
**いかなる誤用や法的違反も、すべてユーザーの責任となります**。
---
## 作者
#### アクティブメンテナー: [Vinyzu](https://github.com/Vinyzu/) </br> 共同メンテナー: [Kaliiiiiiiiii](https://github.com/kaliiiiiiiiii/)
