From 090466a123cae7f762f512866a8a4c87b4f24ebc Mon Sep 17 00:00:00 2001
From: evgeniykornev <evgeniy.kornev@zennolab.com>
Date: Tue, 18 Aug 2026 14:28:52 +0300
Subject: [PATCH] Update README.md

---
 README.md | 109 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 108 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 1e4cda8..b7d418b 100644
--- a/README.md
+++ b/README.md
@@ -64,4 +64,111 @@ async def main():
         websiteKey="6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
     )
     
-    # 3
+    # 3. Solve captcha and receive token
+    result = await client.solve_captcha(request)
+    print("reCAPTCHA Token:", result.get("gRecaptchaResponse"))
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+### 2. Playwright / Selenium Turnstile & reCAPTCHA Integration
+
+```python
+import asyncio
+from playwright.async_api import async_playwright
+from capmonstercloudclient import CapMonsterClient, ClientOptions
+from capmonstercloudclient.requests import TurnstileProxylessRequest
+
+options = ClientOptions(api_key="YOUR_CAPMONSTER_API_KEY")
+client = CapMonsterClient(options=options)
+
+async def run_scraper():
+    # Request Turnstile solution
+    turnstile_req = TurnstileProxylessRequest(
+        websiteUrl="https://target-website.com/login",
+        websiteKey="0x4AAAAAAABnPIDnK2k_e-2"
+    )
+    solution = await client.solve_captcha(turnstile_req)
+    token = solution.get("token")
+
+    async with async_playwright() as p:
+        browser = await p.chromium.launch(headless=False)
+        page = await browser.new_page()
+        await page.goto("https://target-website.com/login")
+        
+        # Inject the solved token into the page
+        await page.evaluate(f'document.querySelector("[name=cf-turnstile-response]").value = "{token}";')
+        await page.click("#submit-button")
+        await browser.close()
+
+if __name__ == "__main__":
+    asyncio.run(run_scraper())
+```
+
+---
+
+## 🛡️ Supported CAPTCHA Types & Documentation
+
+| Protection Type | Task Request Class | Proxyless Support | Docs Link |
+| :--- | :--- | :---: | :--- |
+| **Cloudflare Turnstile** | `TurnstileProxylessRequest` / `TurnstileRequest` | ✅ Yes | [Documentation](https://docs.capmonster.cloud/docs/captchas/turnstile-task) |
+| **reCAPTCHA v2** | `RecaptchaV2ProxylessRequest` / `RecaptchaV2Request` | ✅ Yes | [Documentation](https://docs.capmonster.cloud/docs/captchas/recaptcha-v2-task) |
+| **reCAPTCHA v3 / Enterprise** | `RecaptchaV3ProxylessRequest` / `RecaptchaV2EnterpriseRequest` | ✅ Yes | [Documentation](https://docs.capmonster.cloud/docs/captchas/recaptcha-v3-task) |
+| **GeeTest (v3, v4)** | `GeeTestProxylessRequest` / `GeeTestRequest` | ✅ Yes | [Documentation](https://docs.capmonster.cloud/docs/captchas/geetest-task) |
+| **DataDome** | `DataDomeCustomTaskRequest` | 🌐 Proxy Required | [Documentation](https://docs.capmonster.cloud/docs/captchas/datadome) |
+| **Amazon WAF** | `AmazonWafRequest` | ✅ Yes | [Documentation](https://docs.capmonster.cloud/docs/captchas/amazon-task) |
+| **Imperva / Incapsula** | `ImpervaCustomTaskRequest` / `Proxyless` | ✅ Yes | [Documentation](https://docs.capmonster.cloud/docs/captchas/incapsula) |
+| **Binance CAPTCHA** | `BinanceTaskRequest` / `Proxyless` | ✅ Yes | [Documentation](https://docs.capmonster.cloud/docs/captchas/binance) |
+| **Standard Image-to-Text** | `ImageToTextRequest` | ✅ Yes | [Documentation](https://docs.capmonster.cloud/docs/captchas/image-to-text) |
+| **Complex Image Grid** | `RecaptchaComplexImageTaskRequest` | ✅ Yes | [Documentation](https://docs.capmonster.cloud/docs/captchas/complex-image-task) |
+
+---
+
+## 🛠️ Architecture & Pipeline Flow
+
+```text
+[ Scraping Script (Python / Playwright) ]
+                  │
+                  ▼
+   [ Extract sitekey & website URL ]
+                  │
+                  ▼
+  [ 🤖 CapMonsterClient SDK ] ──► POST task to CapMonster Cloud API
+                  │
+                  ▼
+  [ Instant Neural Network Solve ] ──► Async token retrieval (< 1s)
+                  │
+                  ▼
+[ Inject Token into Form & Submit ] ──► Bypass complete!
+```
+
+---
+
+## ⚙️ Best Practices & Troubleshooting
+
+- **Token Expiration:** Most tokens (reCAPTCHA, Turnstile) are valid for 120 seconds. Inject and submit the token immediately after solving.
+- **Proxy Matching:** For high-security targets (DataDome, Cloudflare Strict), use the same residential proxy in both the scraping session and the CapMonster request task.
+- **Account Balance:** Make sure your balance is positive. You can monitor and top up credits directly in your [Dashboard](https://dash.capmonster.cloud/?utm_source=github&utm_medium=readme&utm_campaign=python_repo).
+
+---
+
+## 📚 Resources & Community
+
+- 📖 [Official CapMonster Cloud Documentation](https://docs.capmonster.cloud/)
+- 🎯 [Full Captcha API Specifications](https://docs.capmonster.cloud/docs/captchas/)
+- 💬 [Support & Developer Community](https://capmonster.cloud/en/?utm_source=github&utm_medium=readme&utm_campaign=python_repo#support)
+
+---
+
+## ⭐ Star History
+
+If this library helps your automation workflows, please give us a star!
+
+[![Star History Chart](https://api.star-history.com/svg?repos=ZennoLab/capmonstercloud-client-python&type=Date)](https://star-history.com/#ZennoLab/capmonstercloud-client-python&Date)
+
+---
+
+## 📄 License
+
+[MIT](LICENSE) © [ZennoLab](https://zennolab.com/) / [CapMonster Cloud](https://capmonster.cloud/)