From a84abd64bc6c89abdb2e51b1e25d2f515ddb6b0d Mon Sep 17 00:00:00 2001 From: evgeniykornev Date: Thu, 30 Jul 2026 16:50:01 +0300 Subject: [PATCH] Update README.md --- README.md | 151 +++++++++++++++++++++++++++++++++++------------------- 1 file changed, 98 insertions(+), 53 deletions(-) diff --git a/README.md b/README.md index 0cec3f4..a8dac38 100644 --- a/README.md +++ b/README.md @@ -1,85 +1,130 @@ -# Zennolab.CapMonsterCloud.Client +# C# Captcha Solver & Anti-Bot Bypass SDK | CapMonster Cloud -Official C# client library for [capmonster.cloud](https://capmonster.cloud/) captcha recognition service +[![NuGet Version](https://img.shields.io/nuget/v/Zennolab.CapMonsterCloud.Client.svg?style=flat-square)](https://www.nuget.org/packages/Zennolab.CapMonsterCloud.Client/) +[![NuGet Downloads](https://img.shields.io/nuget/dt/Zennolab.CapMonsterCloud.Client.svg?style=flat-square)](https://www.nuget.org/packages/Zennolab.CapMonsterCloud.Client/) +[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT) -## Installation +Official C# / .NET client library for the [CapMonster Cloud](https://capmonster.cloud/) automated captcha recognition service. -Via Package Manager: +This SDK empowers developers to easily integrate high-speed, API-based captcha solving into their C#, WPF, and ASP.NET web scraping, automation, and testing projects. We provide seamless bypass for classic captchas (reCAPTCHA, FunCaptcha) as well as complex WAF and anti-bot systems (Cloudflare Turnstile, DataDome, Imperva). - Install-Package Zennolab.CapMonsterCloud.Client +🚀 **[Create an account and get your API Key today!](https://dash.capmonster.cloud/Account/SignUp?utm_source=github&utm_medium=referral&utm_campaign=dotnet_repo_readme)** -Via .NET CLI +## ⚡ Key Features +- **High Success Rate & Speed:** Solves complex captchas in milliseconds. +- **WAF Bypass:** Built-in support for DataDome, Cloudflare, Amazon WAF, and more. +- **Easy Integration:** Ready-to-use C# models for all modern challenge types. +- **Async/Await Support:** Fully asynchronous API for high-performance, multi-threaded scraping. - dotnet add package Zennolab.CapMonsterCloud.Client +--- -## Usage +## ⚙️ Installation - var clientOptions = new ClientOptions - { - ClientKey = "" - }; +Install the CapMonster Cloud C# client via **NuGet Package Manager**: - var cmCloudClient = CapMonsterCloudClientFactory.Create(clientOptions); +```bash +Install-Package Zennolab.CapMonsterCloud.Client +``` - // solve RecaptchaV2 (without proxy) - var recaptchaV2Request = new RecaptchaV2Request - { - WebsiteUrl = "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high", - WebsiteKey = "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd", - }; - var recaptchaV2Result = await cmCloudClient.SolveAsync(recaptchaV2Request); +Or via the **.NET CLI**: - // solve RecaptchaV2 (with proxy) - var recaptchaV2ProxyRequest = new RecaptchaV2Request - { - WebsiteUrl = "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high", - WebsiteKey = "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd", - Proxy = new ProxyContainer("203.0.113.45", 8080, ProxyType.Http, "login", "password") - }; - var recaptchaV2ProxyResult = await cmCloudClient.SolveAsync(recaptchaV2ProxyRequest); +```bash +dotnet add package Zennolab.CapMonsterCloud.Client +``` - // solve a CustomTask (anti-bot/WAF systems such as Tspd, Castle, DataDome, etc.) - var tspdRequest = new TspdCustomTaskRequest( - tspdCookie: "TS386a400d029=08...010245; TS386a400d029=08...01a06e; TS386a400d078=08...dbb3b0c; TSd2153684027=08...1944", - htmlPageBase64: "PCFET0NU...k+PC9odG1sPg==") - { - WebsiteUrl = "https://yourwebsite.com/page-with-tspd", - Proxy = new ProxyContainer("203.0.113.45", 8080, ProxyType.Http, "login", "password") - }; - var tspdResult = await cmCloudClient.SolveAsync(tspdRequest); +--- -Supported captcha recognition requests: +## 🚀 Quick Start & Usage Examples -Classic captcha tasks: +To start solving captchas, you need a CapMonster Cloud API key. If you don't have one, [register here](https://dash.capmonster.cloud/Account/SignUp?utm_source=github&utm_medium=referral&utm_campaign=dotnet_repo_readme). -- [AmazonWafRequest](https://zenno.link/doc-amazon-waf) -- [BinanceTaskRequest](https://zenno.link/doc-binance) -- [FunCaptchaRequest](https://zenno.link/doc-funcaptcha) -- [GeeTestRequest](https://zenno.link/doc-geetest) -- [ImageToTextRequest](https://zenno.link/doc-imagetotext) +### 1. Initialization + +```csharp +using Zennolab.CapMonsterCloud.Client; +using Zennolab.CapMonsterCloud.Client.Options; +using Zennolab.CapMonsterCloud.Client.Requests; + +var clientOptions = new ClientOptions +{ + ClientKey = "" +}; + +var cmCloudClient = CapMonsterCloudClientFactory.Create(clientOptions); +``` + +### 2. How to Solve reCAPTCHA v2 (With Proxy) +*Using a proxy is highly recommended for web scraping to avoid IP bans.* + +```csharp +var recaptchaV2ProxyRequest = new RecaptchaV2Request +{ + WebsiteUrl = "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high", + WebsiteKey = "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd", + Proxy = new ProxyContainer("203.0.113.45", 8080, ProxyType.Http, "login", "password") +}; + +var recaptchaV2ProxyResult = await cmCloudClient.SolveAsync(recaptchaV2ProxyRequest); +Console.WriteLine($"Solved Token: {recaptchaV2ProxyResult.Solution.GRecaptchaResponse}"); +``` + +### 3. How to Bypass WAF (e.g., TSPD, DataDome, Castle) +*For sites protected by advanced anti-bot challenges, use our CustomTask requests.* + +```csharp +var tspdRequest = new TspdCustomTaskRequest( + tspdCookie: "TS386a400d029=08...010245; TS386a400d029=08...01a06e; TS386a400d078=08...dbb3b0c; TSd2153684027=08...1944", + htmlPageBase64: "PCFET0NU...k+PC9odG1sPg==") +{ + WebsiteUrl = "https://yourwebsite.com/page-with-tspd", + Proxy = new ProxyContainer("203.0.113.45", 8080, ProxyType.Http, "login", "password") +}; + +var tspdResult = await cmCloudClient.SolveAsync(tspdRequest); +``` + +--- + +## 🧩 Supported Captcha Recognition Requests + +Our .NET client supports automated recognition for almost all modern anti-bot challenges. Click on the links below to view detailed documentation for each specific task. + +### Classic Captcha Tasks (Tokens) +- [AmazonWafRequest](https://zenno.link/doc-amazon-waf) - Amazon WAF Bypass +- [BinanceTaskRequest](https://zenno.link/doc-binance) - Binance Captcha Solver +- [FunCaptchaRequest](https://zenno.link/doc-funcaptcha) - Arkose Labs FunCaptcha +- [GeeTestRequest](https://zenno.link/doc-geetest) - GeeTest v3 & v4 +- [ImageToTextRequest](https://zenno.link/doc-imagetotext) - Standard OCR (Image-to-Text) - [MTCaptchaTaskRequest](https://zenno.link/doc-mtcaptcha) - [ProsopoTaskRequest](https://zenno.link/doc-prosopo) -- [RecaptchaV2Request](https://zenno.link/doc-recaptcha2) +- [RecaptchaV2Request](https://zenno.link/doc-recaptcha2) - Google reCAPTCHA v2 - [RecaptchaV2EnterpriseRequest](https://zenno.link/doc-recaptcha2e) -- [RecaptchaV3ProxylessRequest](https://zenno.link/doc-recaptcha3) -- [TurnstileRequest - Cloudflare Turnstile](https://zenno.link/doc-cloudflare-turnstile) +- [RecaptchaV3ProxylessRequest](https://zenno.link/doc-recaptcha3) - Google reCAPTCHA v3 +- [TurnstileRequest - Cloudflare Turnstile](https://zenno.link/doc-cloudflare-turnstile) - Cloudflare Turnstile Solver - [TurnstileRequest - Cloudflare Challenge](https://zenno.link/doc-cloudflare-challenge) - [TurnstileRequest - Cloudflare Waiting Room](https://zenno.link/doc-cloudflare-waitingroom) - [YidunTaskRequest](https://zenno.link/doc-yidun) -Custom tasks (anti-bot / WAF / custom challenge systems): - +### Custom Tasks (Anti-Bot / WAF / Custom Challenge Systems) - [AlibabaCustomTaskRequest](https://zenno.link/doc-customtask-alibaba) - [AltchaCustomTaskRequest](https://zenno.link/doc-customtask-altcha) - [BasiliskCustomTaskRequest](https://zenno.link/doc-customtask-basilisk) -- [DataDomeCustomTaskRequest](https://zenno.link/doc-customtask-datadome) +- [DataDomeCustomTaskRequest](https://zenno.link/doc-customtask-datadome) - DataDome Slider & Interstitial bypass - [FriendlyCustomTaskRequest](https://zenno.link/doc-customtask-friendly) - [HuntCustomTaskRequest](https://zenno.link/doc-customtask-hunt) -- [ImpervaCustomTaskRequest](https://zenno.link/doc-customtask-imperva) +- [ImpervaCustomTaskRequest](https://zenno.link/doc-customtask-imperva) - Imperva / Incapsula bypass - [TenDiCustomTaskRequest](https://zenno.link/doc-customtask-tendi) - [TspdCustomTaskRequest](https://zenno.link/doc-customtask-tspd) -Complex image tasks (grid / dynamic image selection tasks): - +### Complex Image Tasks (Grid / Dynamic Image Selection) - [RecaptchaComplexImageTaskRequest](https://zenno.link/doc-complextask-rc) - [RecognitionComplexImageTaskRequest](https://zenno.link/doc-complextask-recognition) + +--- + +## 📚 Documentation & Support + +For comprehensive guides, advanced scraping techniques, API limits, and error handling, please visit our official documentation: + +📖 **[CapMonster Cloud Official Documentation](https://docs.capmonster.cloud/)** +💬 **[Support / Contact Us](https://capmonster.cloud/)**