From 0fadf1b06994f42ee209f77cde41a76a5d350084 Mon Sep 17 00:00:00 2001 From: evgeniykornev Date: Mon, 3 Aug 2026 10:33:49 +0300 Subject: [PATCH] Update README.md --- README.md | 107 ++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 71 insertions(+), 36 deletions(-) diff --git a/README.md b/README.md index d8488b1..f85be2f 100644 --- a/README.md +++ b/README.md @@ -1,58 +1,93 @@ -# Zennolab.CapMonsterCloud.Client +# CapMonster Python Captcha Solver & Anti-Bot Bypass API Library -> [!IMPORTANT] -> This repository has been moved and is no longer maintained. -> -> New repository: [https://github.com/CapMonsterCloud/client-python](https://github.com/CapMonsterCloud/client-python) -> -> Please update your references and use the new repository for all future development. +[![PyPI version](https://img.shields.io/pypi/v/capmonstercloudclient.svg?style=flat-square)](https://pypi.org/project/capmonstercloudclient/) +[![PyPI downloads](https://img.shields.io/pypi/dm/capmonstercloudclient.svg?style=flat-square)](https://pypi.org/project/capmonstercloudclient/) +[![Python version](https://img.shields.io/pypi/pyversions/capmonstercloudclient.svg?style=flat-square)](https://pypi.org/project/capmonstercloudclient/) +[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT) +Official Python 3 package for easy integration with the [CapMonster Cloud](https://capmonster.cloud/) API — the fastest and most reliable automated captcha-solving service. -Official python client library for [capmonster.cloud](https://capmonster.cloud/) captcha recognition service +This wrapper allows you to seamlessly integrate high-speed AI captcha recognition into your Python web scraping, data extraction, and testing workflows. It is fully compatible with popular browser automation frameworks like **Selenium, Playwright, Puppeteer, Scrapy, and BeautifulSoup**. -## Installation +🔥 **[Create a Free Account & Get Your API Key](https://dash.capmonster.cloud/Account/SignUp?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)** to start bypassing bot protections instantly! - python3 -m pip install capmonstercloudclient +## 🛠️ Key Features -## Usage +- ⚡ **Fast & Fully Automated:** Solve captchas in seconds without human intervention. +- 🤖 **100% AI-Powered:** Machine learning algorithms ensure the highest success rate. +- 🌐 **Browser Automation Ready:** Easily plug into your Selenium or Playwright scripts. +- 🛡️ **Advanced WAF Bypass:** Effortlessly bypass Cloudflare Turnstile, DataDome, Amazon WAF, and Imperva. +- 💰 **Cost-Effective:** One of the most affordable solutions on the market for scale. -*** - import asyncio +## ⚙️ Installation - from capmonstercloudclient import CapMonsterClient, ClientOptions - from capmonstercloudclient.requests import RecaptchaV2ProxylessRequest +Install the CapMonster Cloud Python client using pip: - client_options = ClientOptions(api_key=) - cap_monster_client = CapMonsterClient(options=client_options) +```bash +pip install capmonstercloudclient +``` - async def solve_captcha(): - return await cap_monster_client.solve_captcha(recaptcha2request) +## 🚀 Quick Start & Usage Example - recaptcha2request = RecaptchaV2ProxylessRequest(websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high", - websiteKey="6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd") +**Prerequisite:** You need an active CapMonster API key. [Grab it from your dashboard](https://dash.capmonster.cloud/Account/SignUp?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme). +Below is a standard example of solving a reCAPTCHA v2 (Proxyless) using `asyncio`. You can easily pass the resulting token into your Selenium or Playwright browser instances. + +```python +import asyncio + +from capmonstercloudclient import CapMonsterClient, ClientOptions +from capmonstercloudclient.requests import RecaptchaV2ProxylessRequest + +# Initialize the client with your CapMonster Cloud API key +client_options = ClientOptions(api_key="") +cap_monster_client = CapMonsterClient(options=client_options) + +async def solve_captcha(): + # Setup the reCAPTCHA v2 request + recaptcha2request = RecaptchaV2ProxylessRequest( + websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high", + websiteKey="6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd" + ) + # Await the solution token + return await cap_monster_client.solve_captcha(recaptcha2request) + +if __name__ == "__main__": responses = asyncio.run(solve_captcha()) - print(responses) -*** + print("Captcha Solved! Token:", responses) +``` + +## 🧩 Supported Captcha Recognition Types -Supported captcha recognition requests: +Our Python API wrapper supports almost all modern anti-bot challenges. Click on the links below to view detailed API documentation and payload examples. -- [GeeTestProxylessRequest](https://zenno.link/doc-geetest-en) +### 🔹 Classic Captchas +- [AmazonWafRequest](https://docs.capmonster.cloud/docs/captchas/amazon-task) - Amazon WAF Bypass +- [BinanceTaskRequest](https://docs.capmonster.cloud/docs/captchas/binance) - Binance Captcha Solver +- [BinanceTaskProxylessRequest](https://docs.capmonster.cloud/docs/captchas/binance) +- [GeeTestProxylessRequest](https://zenno.link/doc-geetest-en) - GeeTest Solver - [GeeTestRequest](https://zenno.link/doc-geetest-proxy-en) -- [ImageToTextRequest](https://zenno.link/doc-ImageToTextTask-en) -- [RecaptchaV2ProxylessRequest](https://zenno.link/doc-recaptcha2-en) +- [ImageToTextRequest](https://zenno.link/doc-ImageToTextTask-en) - Standard OCR (Image-to-Text) +- [RecaptchaV2ProxylessRequest](https://zenno.link/doc-recaptcha2-en) - Google reCAPTCHA v2 - [RecaptchaV2Request](https://zenno.link/doc-recaptcha2-proxy-en) -- [RecaptchaV3ProxylessRequest](https://zenno.link/doc-recaptcha3-en) +- [RecaptchaV3ProxylessRequest](https://zenno.link/doc-recaptcha3-en) - Google reCAPTCHA v3 - [RecaptchaV2EnterpriseProxylessRequest](https://zenno.link/doc-recaptcha2e-en) - [RecaptchaV2EnterpriseRequest](https://zenno.link/doc-recaptcha2e-proxy-en) -- [TurnstileProxylessRequest](https://zenno.link/doc-turnstile-en) +- [TurnstileProxylessRequest](https://zenno.link/doc-turnstile-en) - Cloudflare Turnstile Challenge - [TurnstileRequest](https://zenno.link/doc-turnstile-proxy-en) -- [RecaptchaComplexImageTaskRequest](https://zenno.link/doc-complextask-rc-en) -- [DataDomeCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/datadome) -- [TenDiCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/tendi) + +### 🔹 Custom Tasks (Anti-Bot & Advanced WAFs) - [BasiliskCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/Basilisk-task) -- [AmazonWafRequest](https://docs.capmonster.cloud/docs/captchas/amazon-task) -- [BinanceTaskRequest](https://docs.capmonster.cloud/docs/captchas/binance) -- [BinanceTaskProxylessRequest](https://docs.capmonster.cloud/docs/captchas/binance) -- [ImpervaCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/incapsula) +- [DataDomeCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/datadome) - DataDome Slider & Interstitial bypass +- [ImpervaCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/incapsula) - Imperva / Incapsula bypass - [ImpervaCustomTaskProxylessRequest](https://docs.capmonster.cloud/docs/captchas/incapsula) +- [TenDiCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/tendi) + +### 🔹 Complex Image Tasks +- [RecaptchaComplexImageTaskRequest](https://zenno.link/doc-complextask-rc-en) (Grid / Dynamic Image Selection) + +--- + +### 💡 Ready to supercharge your web automation? +Join thousands of developers effortlessly bypassing captchas. +👉 **[Sign up for CapMonster Cloud](https://capmonster.cloud/) today and boost your scraper's success rate!**