capmonstercloudclient 4.1.0__tar.gz → 4.3.0__tar.gz

capmonstercloudclient-4.3.0/PKG-INFO

@@ -0,0 +1,252 @@
+Metadata-Version: 2.4
+Name: capmonstercloudclient
+Version: 4.3.0
+Summary: Official CapMonsterCloud Client: https://capmonster.cloud/
+Home-page: https://github.com/ZennoLab/capmonstercloud-client-python
+Author: Andrey Ilyin
+Author-email: andrey.ilyin@zennolab.com
+License: AGPL-3.0
+Keywords: captcha,recaptcha,geetest,hcaptcha,funcaptcha,python3,python-library,capmonster,capmonstercloud,capmonstercloudclient
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Framework :: AsyncIO
+Classifier: Operating System :: Unix
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohappyeyeballs==2.4.4; python_version >= "3.9" and python_version <= "3.13"
+Requires-Dist: aiohttp==3.11.10; python_version >= "3.9" and python_version <= "3.13"
+Requires-Dist: aiosignal==1.3.1; python_version >= "3.9" and python_version <= "3.13"
+Requires-Dist: annotated-types==0.7.0; python_version >= "3.9" and python_version <= "3.13"
+Requires-Dist: async-timeout==5.0.1; python_version >= "3.9" and python_version <= "3.11"
+Requires-Dist: attrs==24.2.0; python_version >= "3.9" and python_version <= "3.13"
+Requires-Dist: frozenlist==1.5.0; python_version >= "3.9" and python_version <= "3.13"
+Requires-Dist: idna==3.10; python_version >= "3.9" and python_version <= "3.13"
+Requires-Dist: multidict==6.1.0; python_version >= "3.9" and python_version <= "3.13"
+Requires-Dist: propcache==0.2.1; python_version >= "3.9" and python_version <= "3.13"
+Requires-Dist: pydantic-core==2.27.1; python_version >= "3.9" and python_version <= "3.13"
+Requires-Dist: pydantic==2.10.3; python_version >= "3.9" and python_version <= "3.13"
+Requires-Dist: typing-extensions==4.12.2; python_version >= "3.9" and python_version <= "3.13"
+Requires-Dist: yarl==1.18.3; python_version >= "3.9" and python_version <= "3.13"
+Requires-Dist: aiohttp==3.7.4; python_version >= "3.6" and python_version <= "3.8"
+Requires-Dist: pydantic==2.10.3; python_version >= "3.8" and python_version < "3.9"
+Requires-Dist: pydantic==2.5.3; python_version >= "3.7" and python_version < "3.8"
+Requires-Dist: pydantic==2.1.*; python_version < "3.7"
+Requires-Dist: aiohappyeyeballs==2.7.1; python_version == "3.14"
+Requires-Dist: aiohttp==3.14.3; python_version == "3.14"
+Requires-Dist: aiosignal==1.4.0; python_version == "3.14"
+Requires-Dist: annotated-types==0.8.0; python_version == "3.14"
+Requires-Dist: attrs==26.1.0; python_version == "3.14"
+Requires-Dist: frozenlist==1.8.0; python_version == "3.14"
+Requires-Dist: idna==3.18; python_version == "3.14"
+Requires-Dist: multidict==6.7.1; python_version == "3.14"
+Requires-Dist: propcache==0.5.2; python_version == "3.14"
+Requires-Dist: pydantic-core==2.46.4; python_version == "3.14"
+Requires-Dist: pydantic==2.13.4; python_version == "3.14"
+Requires-Dist: typing-extensions==4.16.0; python_version == "3.14"
+Requires-Dist: typing-inspection==0.4.2; python_version == "3.14"
+Requires-Dist: yarl==1.24.5; python_version == "3.14"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# CapMonster Cloud Python SDK: AI Captcha Solver & Anti-Bot Bypass
+
+<p align="center">
+  <a href="https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme">
+    <img src="https://img.shields.io/badge/CapMonster%20Cloud-Python%20Captcha%20Solver-00B2FF?style=for-the-badge&logo=python&logoColor=white" alt="CapMonster Cloud Python SDK" height="40">
+  </a>
+</p>
+
+<p align="center">
+  <strong>Fast, AI-driven CAPTCHA solving client for Python. Seamlessly bypass Cloudflare Turnstile, reCAPTCHA v2/v3/Enterprise, DataDome, GeeTest, and Amazon WAF in web scraping and browser automation.</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/capmonstercloudclient/"><img src="https://img.shields.io/pypi/v/capmonstercloudclient.svg?style=flat-square&color=blue" alt="PyPI version"></a>
+  <a href="https://pepy.tech/project/capmonstercloudclient"><img src="https://static.pepy.tech/badge/capmonstercloudclient/month" alt="PyPI downloads"></a>
+  <a href="https://pypi.org/project/capmonstercloudclient/"><img src="https://img.shields.io/pypi/pyversions/capmonstercloudclient.svg?style=flat-square" alt="Python Versions"></a>
+  <a href="https://github.com/CapMonsterCloud/capmonster-python-captcha-solver/stargazers"><img src="https://img.shields.io/github/stars/CapMonsterCloud/capmonster-python-captcha-solver?style=flat-square&color=yellow" alt="GitHub Stars"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-orange.svg?style=flat-square" alt="License: MIT"></a>
+</p>
+
+---
+
+Official asynchronous Python SDK for [CapMonster Cloud](https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme). Easily plug ultra-fast AI captcha recognition into **Playwright, Selenium, Puppeteer, Scrapy, BeautifulSoup, and Requests** automation workflows without human-in-the-loop delays.
+
+**[👉 Get your Free API Key & Free Trial Balance on CapMonster Cloud](https://dash.capmonster.cloud/Account/SignUp?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)**
+
+---
+
+## ⚡ Highlights & Benchmarks
+
+- ⚡ **Sub-Second Speed:** Automated AI models solve captchas in 300 ms to 6 seconds depending on the system load.
+- 🤖 **Zero Human Workers:** 100% automated machine learning pipeline with no manual latencies.
+- 🌐 **Browser Automation Ready:** Works out-of-the-box with **Playwright, Selenium, and Puppeteer**.
+- 🛡️ **Modern Anti-Bot Bypass:** Full support for Cloudflare Turnstile, reCAPTCHA Enterprise, GeeTest, and Amazon WAF.
+- 💰 **Cost-Effective:** Low-cost pricing structure based on pay-as-you-go balance.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install capmonstercloudclient
+```
+
+---
+
+## 🚀 Quick Start & Usage Examples
+
+### 1. Asynchronous reCAPTCHA v2 Solving
+
+```python
+import asyncio
+from capmonstercloudclient import CapMonsterClient, ClientOptions
+from capmonstercloudclient.requests import RecaptchaV2Request
+
+# Initialize client with your API key from dashboard
+options = ClientOptions(api_key="YOUR_CAPMONSTER_API_KEY")
+client = CapMonsterClient(options=options)
+
+async def main():
+    # Build the task payload
+    request = RecaptchaV2Request(
+        websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
+        websiteKey="6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
+    )
+    
+    # Send task and receive token
+    result = await client.solve_captcha(request)
+    print("reCAPTCHA Token:", result.get("gRecaptchaResponse"))
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+### 2. Browser Automation (Playwright + Cloudflare Turnstile)
+
+```python
+import asyncio
+from playwright.async_api import async_playwright
+from capmonstercloudclient import CapMonsterClient, ClientOptions
+from capmonstercloudclient.requests import TurnstileRequest
+
+options = ClientOptions(api_key="YOUR_CAPMONSTER_API_KEY")
+client = CapMonsterClient(options=options)
+
+async def run_scraper():
+    # Solve Turnstile challenge via CapMonster Cloud
+    turnstile_req = TurnstileRequest(
+        websiteURL="https://target-website.com/login",
+        websiteKey="0x4AAAAAAABnPIDnK2k_e-2"
+    )
+    solution = await client.solve_captcha(turnstile_req)
+    token = solution.get("token")
+
+    # Inject token into Playwright browser session
+    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")
+        
+        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
+
+All task types conform to the official [CapMonster Cloud API Documentation](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme):
+
+| Protection Type | Task Request Class | Proxyless Mode |
+| :--- | :--- | :---: |
+| **Cloudflare Turnstile** | `TurnstileRequest` | ✅ Supported |
+| **reCAPTCHA v2** | `RecaptchaV2Request` | ✅ Supported |
+| **reCAPTCHA v3** | `RecaptchaV3ProxylessRequest` | ✅ Supported |
+| **reCAPTCHA Enterprise** | `RecaptchaV2EnterpriseProxylessRequest` / `RecaptchaV2EnterpriseRequest` | ✅ Supported |
+| **GeeTest (v3, v4)** | `GeeTestProxylessRequest` / `GeeTestRequest` | ✅ Supported |
+| **Amazon WAF** | `AmazonWafRequest` | ✅ Supported |
+| **DataDome** | `DataDomeCustomTaskRequest` | 🌐 Proxy Required |
+| **Imperva / Incapsula** | `ImpervaCustomTaskRequest` / `ImpervaCustomTaskProxylessRequest` | ✅ Supported |
+| **Binance CAPTCHA** | `BinanceTaskRequest` / `BinanceTaskProxylessRequest` | ✅ Supported |
+| **Standard Text CAPTCHA** | `ImageToTextRequest` | ✅ Supported |
+| **Complex Image Tasks** | `RecaptchaComplexImageTaskRequest` | ✅ Supported |
+
+---
+
+## 🛠️ How It Works
+
+```text
+[ Script / Scraper ]
+         │
+         ▼
+[ Extract sitekey & website URL ]
+         │
+         ▼
+[ CapMonsterClient API ] ──► POST createTask to https://api.capmonster.cloud
+         │
+         ▼
+[ Neural Network Processing ] ──► Poll getTaskResult (300ms - 6s)
+         │
+         ▼
+[ Receive Token & Autosubmit ] ──► Complete bypass
+```
+
+---
+
+## ⚙️ Best Practices
+
+- **Token Expiration:** Most tokens (reCAPTCHA, Turnstile) remain valid for 120 seconds. Inject and submit the solution immediately after receiving the response.
+- **Proxy Usage:** For custom tasks and strict protections, use the same proxy in your scraping session and the CapMonster task payload.
+- **Balance Monitoring:** Ensure your account balance remains positive in the [Dashboard](https://dash.capmonster.cloud/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
+
+---
+
+## 📚 Official Documentation & Links
+
+- 📖 [Getting Started Guide](https://docs.capmonster.cloud/docs/getting-start/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
+- 🎯 [Supported Captchas Overview](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
+- ⚙️ [API Methods Reference](https://docs.capmonster.cloud/docs/methods/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
+- 💬 [Support & Community](https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme#support)
+
+## Other official SDKs
+
+- [.NET](https://github.com/CapMonsterCloud/capmonster-dotnet-captcha-solver)
+- [Node.js](https://github.com/CapMonsterCloud/capmonster-nodejs-captcha-solver)
+- [n8n](https://github.com/CapMonsterCloud/capmonster-n8n-captcha-solver)
+- [API Docs](https://github.com/CapMonsterCloud/capmonster-captcha-solver-docs)
+
+---
+
+## 📄 License
+
+[MIT](./LICENSE) © [ZennoLab](https://zennolab.com/) / [CapMonster Cloud](https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)

capmonstercloudclient-4.3.0/README.md

@@ -0,0 +1,177 @@
+# CapMonster Cloud Python SDK: AI Captcha Solver & Anti-Bot Bypass
+
+<p align="center">
+  <a href="https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme">
+    <img src="https://img.shields.io/badge/CapMonster%20Cloud-Python%20Captcha%20Solver-00B2FF?style=for-the-badge&logo=python&logoColor=white" alt="CapMonster Cloud Python SDK" height="40">
+  </a>
+</p>
+
+<p align="center">
+  <strong>Fast, AI-driven CAPTCHA solving client for Python. Seamlessly bypass Cloudflare Turnstile, reCAPTCHA v2/v3/Enterprise, DataDome, GeeTest, and Amazon WAF in web scraping and browser automation.</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/capmonstercloudclient/"><img src="https://img.shields.io/pypi/v/capmonstercloudclient.svg?style=flat-square&color=blue" alt="PyPI version"></a>
+  <a href="https://pepy.tech/project/capmonstercloudclient"><img src="https://static.pepy.tech/badge/capmonstercloudclient/month" alt="PyPI downloads"></a>
+  <a href="https://pypi.org/project/capmonstercloudclient/"><img src="https://img.shields.io/pypi/pyversions/capmonstercloudclient.svg?style=flat-square" alt="Python Versions"></a>
+  <a href="https://github.com/CapMonsterCloud/capmonster-python-captcha-solver/stargazers"><img src="https://img.shields.io/github/stars/CapMonsterCloud/capmonster-python-captcha-solver?style=flat-square&color=yellow" alt="GitHub Stars"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-orange.svg?style=flat-square" alt="License: MIT"></a>
+</p>
+
+---
+
+Official asynchronous Python SDK for [CapMonster Cloud](https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme). Easily plug ultra-fast AI captcha recognition into **Playwright, Selenium, Puppeteer, Scrapy, BeautifulSoup, and Requests** automation workflows without human-in-the-loop delays.
+
+**[👉 Get your Free API Key & Free Trial Balance on CapMonster Cloud](https://dash.capmonster.cloud/Account/SignUp?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)**
+
+---
+
+## ⚡ Highlights & Benchmarks
+
+- ⚡ **Sub-Second Speed:** Automated AI models solve captchas in 300 ms to 6 seconds depending on the system load.
+- 🤖 **Zero Human Workers:** 100% automated machine learning pipeline with no manual latencies.
+- 🌐 **Browser Automation Ready:** Works out-of-the-box with **Playwright, Selenium, and Puppeteer**.
+- 🛡️ **Modern Anti-Bot Bypass:** Full support for Cloudflare Turnstile, reCAPTCHA Enterprise, GeeTest, and Amazon WAF.
+- 💰 **Cost-Effective:** Low-cost pricing structure based on pay-as-you-go balance.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install capmonstercloudclient
+```
+
+---
+
+## 🚀 Quick Start & Usage Examples
+
+### 1. Asynchronous reCAPTCHA v2 Solving
+
+```python
+import asyncio
+from capmonstercloudclient import CapMonsterClient, ClientOptions
+from capmonstercloudclient.requests import RecaptchaV2Request
+
+# Initialize client with your API key from dashboard
+options = ClientOptions(api_key="YOUR_CAPMONSTER_API_KEY")
+client = CapMonsterClient(options=options)
+
+async def main():
+    # Build the task payload
+    request = RecaptchaV2Request(
+        websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
+        websiteKey="6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
+    )
+    
+    # Send task and receive token
+    result = await client.solve_captcha(request)
+    print("reCAPTCHA Token:", result.get("gRecaptchaResponse"))
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+### 2. Browser Automation (Playwright + Cloudflare Turnstile)
+
+```python
+import asyncio
+from playwright.async_api import async_playwright
+from capmonstercloudclient import CapMonsterClient, ClientOptions
+from capmonstercloudclient.requests import TurnstileRequest
+
+options = ClientOptions(api_key="YOUR_CAPMONSTER_API_KEY")
+client = CapMonsterClient(options=options)
+
+async def run_scraper():
+    # Solve Turnstile challenge via CapMonster Cloud
+    turnstile_req = TurnstileRequest(
+        websiteURL="https://target-website.com/login",
+        websiteKey="0x4AAAAAAABnPIDnK2k_e-2"
+    )
+    solution = await client.solve_captcha(turnstile_req)
+    token = solution.get("token")
+
+    # Inject token into Playwright browser session
+    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")
+        
+        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
+
+All task types conform to the official [CapMonster Cloud API Documentation](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme):
+
+| Protection Type | Task Request Class | Proxyless Mode |
+| :--- | :--- | :---: |
+| **Cloudflare Turnstile** | `TurnstileRequest` | ✅ Supported |
+| **reCAPTCHA v2** | `RecaptchaV2Request` | ✅ Supported |
+| **reCAPTCHA v3** | `RecaptchaV3ProxylessRequest` | ✅ Supported |
+| **reCAPTCHA Enterprise** | `RecaptchaV2EnterpriseProxylessRequest` / `RecaptchaV2EnterpriseRequest` | ✅ Supported |
+| **GeeTest (v3, v4)** | `GeeTestProxylessRequest` / `GeeTestRequest` | ✅ Supported |
+| **Amazon WAF** | `AmazonWafRequest` | ✅ Supported |
+| **DataDome** | `DataDomeCustomTaskRequest` | 🌐 Proxy Required |
+| **Imperva / Incapsula** | `ImpervaCustomTaskRequest` / `ImpervaCustomTaskProxylessRequest` | ✅ Supported |
+| **Binance CAPTCHA** | `BinanceTaskRequest` / `BinanceTaskProxylessRequest` | ✅ Supported |
+| **Standard Text CAPTCHA** | `ImageToTextRequest` | ✅ Supported |
+| **Complex Image Tasks** | `RecaptchaComplexImageTaskRequest` | ✅ Supported |
+
+---
+
+## 🛠️ How It Works
+
+```text
+[ Script / Scraper ]
+         │
+         ▼
+[ Extract sitekey & website URL ]
+         │
+         ▼
+[ CapMonsterClient API ] ──► POST createTask to https://api.capmonster.cloud
+         │
+         ▼
+[ Neural Network Processing ] ──► Poll getTaskResult (300ms - 6s)
+         │
+         ▼
+[ Receive Token & Autosubmit ] ──► Complete bypass
+```
+
+---
+
+## ⚙️ Best Practices
+
+- **Token Expiration:** Most tokens (reCAPTCHA, Turnstile) remain valid for 120 seconds. Inject and submit the solution immediately after receiving the response.
+- **Proxy Usage:** For custom tasks and strict protections, use the same proxy in your scraping session and the CapMonster task payload.
+- **Balance Monitoring:** Ensure your account balance remains positive in the [Dashboard](https://dash.capmonster.cloud/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
+
+---
+
+## 📚 Official Documentation & Links
+
+- 📖 [Getting Started Guide](https://docs.capmonster.cloud/docs/getting-start/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
+- 🎯 [Supported Captchas Overview](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
+- ⚙️ [API Methods Reference](https://docs.capmonster.cloud/docs/methods/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
+- 💬 [Support & Community](https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme#support)
+
+## Other official SDKs
+
+- [.NET](https://github.com/CapMonsterCloud/capmonster-dotnet-captcha-solver)
+- [Node.js](https://github.com/CapMonsterCloud/capmonster-nodejs-captcha-solver)
+- [n8n](https://github.com/CapMonsterCloud/capmonster-n8n-captcha-solver)
+- [API Docs](https://github.com/CapMonsterCloud/capmonster-captcha-solver-docs)
+
+---
+
+## 📄 License
+
+[MIT](./LICENSE) © [ZennoLab](https://zennolab.com/) / [CapMonster Cloud](https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)

{capmonstercloudclient-4.1.0 → capmonstercloudclient-4.3.0}/capmonstercloud_client/CapMonsterCloudClient.py

@@ -20,9 +20,11 @@ _instance_config = (
     ((RecaptchaV3EnterpriseRequest,), getRecaptchaV3Timeouts),
     ((ImageToTextRequest,), getImage2TextTimeouts),
     ((FuncaptchaRequest,), getFuncaptchaTimeouts),
+    ((HcaptchaRequest,), getHcaptchaTimeouts),
     ((GeetestRequest,), getGeetestTimeouts),
     ((TurnstileRequest,), getTurnstileTimeouts),
-    ((RecaptchaComplexImageTaskRequest, FunCaptchaComplexImageTaskRequest), getImage2TextTimeouts),
+    ((RecaptchaComplexImageTaskRequest, HcaptchaComplexImageTaskRequest, 
+      FunCaptchaComplexImageTaskRequest), getImage2TextTimeouts),
     ((DataDomeCustomTaskRequest,), getDatadomeTimeouts),
     ((TenDiCustomTaskRequest,), getTenDiTimeouts),
     ((BasiliskCustomTaskRequest,), getBasiliskTimeouts),
@@ -30,7 +32,7 @@ _instance_config = (
     ((BinanceTaskRequest,), getBinanceTimeouts),
     ((ImpervaCustomTaskRequest,), getImpervaTimeouts),
     ((RecognitionComplexImageTaskRequest,), getCITTimeouts),
-    ((MTCaptchaRequest,), getImage2TextTimeouts),
+    ((MTCaptchaRequest,), getMTCaptchaTimeouts),
     ((YidunRequest,), getYidunTimeouts),
     ((TemuCustomTaskRequest,), getTemuTimeouts),
     ((ProsopoTaskRequest,), getProsopoTimeouts),
@@ -38,8 +40,8 @@ _instance_config = (
     ((CastleCustomTaskRequest,), getCastleTimeouts),
     ((TspdCustomTaskRequest,), getTspdTimeouts),
     ((HuntCustomTaskRequest,), getHuntTimeouts),
-    ((FriendlyCaptchaRequest,), getFriendlyCaptchaTimeouts),
     ((AlibabaCustomTaskRequest,), getAlibabaTimeouts),
+    ((FriendlyCustomTaskRequest,), getFriendlyTimeouts),
 )
 
 
@@ -88,6 +90,8 @@ class CapMonsterClient:
                                                  ImageToTextRequest, 
                                                  FuncaptchaRequest,
                                                  FunCaptchaComplexImageTaskRequest,
+                                                 HcaptchaRequest,
+                                                 HcaptchaComplexImageTaskRequest,
                                                  GeetestRequest,
                                                  DataDomeCustomTaskRequest,
                                                  TenDiCustomTaskRequest,
@@ -105,8 +109,8 @@ class CapMonsterClient:
                                                  CastleCustomTaskRequest,
                                                  TspdCustomTaskRequest,
                                                  HuntCustomTaskRequest,
-                                                 FriendlyCaptchaRequest,
-                                                 AlibabaCustomTaskRequest],
+                                                 AlibabaCustomTaskRequest,
+                                                 FriendlyCustomTaskRequest],
                             ) -> Dict[str, str]:
         '''
         Non-blocking method for captcha solving. 
@@ -130,6 +134,8 @@ class CapMonsterClient:
                                           ImageToTextRequest, 
                                           FuncaptchaRequest,
                                           FunCaptchaComplexImageTaskRequest,
+                                          HcaptchaRequest,
+                                          HcaptchaComplexImageTaskRequest,
                                           GeetestRequest,
                                           DataDomeCustomTaskRequest,
                                           TenDiCustomTaskRequest,
@@ -144,8 +150,11 @@ class CapMonsterClient:
                                           TemuCustomTaskRequest,
                                           ProsopoTaskRequest,
                                           AltchaCustomTaskRequest,
-                                          FriendlyCaptchaRequest,
-                                          AlibabaCustomTaskRequest],
+                                          CastleCustomTaskRequest,
+                                          TspdCustomTaskRequest,
+                                          HuntCustomTaskRequest,
+                                          AlibabaCustomTaskRequest,
+                                          FriendlyCustomTaskRequest],
                            timeouts: GetResultTimeouts,
                            ) -> Dict[str, str]:
 
@@ -215,4 +224,4 @@ class CapMonsterClient:
                     raise HTTPException(f'Cannot create task. Status code: {resp.status}.')
                 else:
                     return await resp.json(content_type=None)
-        
+        

{capmonstercloudclient-4.1.0 → capmonstercloudclient-4.3.0}/capmonstercloud_client/GetResultTimeouts.py

@@ -1,106 +1,87 @@
 from typing import Union
 from dataclasses import dataclass
 
-
 @dataclass
 class GetResultTimeouts:
     firstRequestDelay: Union[int, float]
     firstRequestNoCacheDelay: Union[int, float]
-    requestsInterval: Union[int, float]
+    requestsInterval: Union[int, float] 
     timeout: Union[int, float]
 
-
 def getRecaptchaV2Timeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 10, 3, 180)
 
-
 def getRecaptchaV2EnterpriseTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 10, 3, 180)
 
-
 def getRecaptchaV3Timeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 10, 3, 180)
 
-
 def getRecaptchaV3EnterpriseTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 10, 3, 150)
 
-
 def getImage2TextTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(0.35, 0, 0.2, 10)
 
-
 def getFuncaptchaTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 10, 1, 80)
 
+def getHcaptchaTimeouts() -> GetResultTimeouts:
+    return GetResultTimeouts(1, 10, 3, 180)
 
 def getGeetestTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 0, 1, 80)
 
-
 def getTurnstileTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 0, 1, 80)
 
-
 def getDatadomeTimeouts() -> GetResultTimeouts:
-    return GetResultTimeouts(1, 0, 1, 80)
-
+    return GetResultTimeouts(1, 0, 3, 180)
 
 def getTenDiTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 10, 3, 180)
 
-
 def getBasiliskTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 10, 3, 100)
 
-
 def getAmazonWafTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 10, 3, 180)
 
-
 def getBinanceTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 0, 1, 20)
 
-
 def getImpervaTimeouts() -> GetResultTimeouts:
-    return GetResultTimeouts(1, 0, 1, 20)
-
+    return GetResultTimeouts(1, 0, 1, 15)
 
 def getAltchaTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 0, 1, 50)
 
-
 def getCastleTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 0, 1, 60)
 
-
 def getTspdTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 0, 1, 60)
 
-
 def getHuntTimeouts() -> GetResultTimeouts:
-    return GetResultTimeouts(1, 0, 1, 60)
+    return GetResultTimeouts(1, 0, 3, 180)
+
+def getAlibabaTimeouts() -> GetResultTimeouts:
+    return GetResultTimeouts(1, 0, 3, 120)
 
+def getFriendlyTimeouts() -> GetResultTimeouts:
+    return GetResultTimeouts(1, 0, 3, 180)
 
 def getCITTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(0.35, 0, 0.2, 10)
 
+def getMTCaptchaTimeouts() -> GetResultTimeouts:
+    return GetResultTimeouts(1, 10, 3, 180)
 
 def getYidunTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 10, 3, 180)
 
-
 def getProsopoTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 10, 3, 180)
 
-
 def getTemuTimeouts() -> GetResultTimeouts:
     return GetResultTimeouts(1, 10, 3, 180)
-
-
-def getFriendlyCaptchaTimeouts() -> GetResultTimeouts:
-    return GetResultTimeouts(1, 0, 1, 180)
-
-
-def getAlibabaTimeouts() -> GetResultTimeouts:
-    return GetResultTimeouts(1, 0, 1, 180)

{capmonstercloudclient-4.1.0 → capmonstercloudclient-4.3.0}/capmonstercloud_client/clientOptions.py

@@ -1,4 +1,4 @@
-from pydantic import BaseModel, validator, Field
+from pydantic import BaseModel, field_validator, Field
 from .requests import ClientProxyInfo
 from typing import Optional
 
@@ -10,19 +10,22 @@ class ClientOptions(BaseModel):
     client_timeout: float = Field(default=20.0)
     
 
-    @validator('api_key')
+    @field_validator('api_key')
+    @classmethod
     def validate_api_key(cls, value):
         if not isinstance(value, str):
             raise TypeError(f'Api Key must be <str> type, got {type(value)}')
         return value
     
-    @validator('service_url')
+    @field_validator('service_url')
+    @classmethod
     def validate_service_url(cls, value):
         if not isinstance(value, str):
             raise TypeError(f'Service url must be <str> type, got {type(value)}')
         return value
 
-    @validator('default_soft_id')
+    @field_validator('default_soft_id')
+    @classmethod
     def validate_soft_id(cls, value):
         if not isinstance(value, int):
             raise TypeError(f'Soft id must be <int> type, got {type(value)}')