Zennolab.CapMonsterCloud.Client
3.5.0
See the version list below for details.
dotnet add package Zennolab.CapMonsterCloud.Client --version 3.5.0
NuGet\Install-Package Zennolab.CapMonsterCloud.Client -Version 3.5.0
<PackageReference Include="Zennolab.CapMonsterCloud.Client" Version="3.5.0" />
<PackageVersion Include="Zennolab.CapMonsterCloud.Client" Version="3.5.0" />
<PackageReference Include="Zennolab.CapMonsterCloud.Client" />
paket add Zennolab.CapMonsterCloud.Client --version 3.5.0
#r "nuget: Zennolab.CapMonsterCloud.Client, 3.5.0"
#:package Zennolab.CapMonsterCloud.Client@3.5.0
#addin nuget:?package=Zennolab.CapMonsterCloud.Client&version=3.5.0
#tool nuget:?package=Zennolab.CapMonsterCloud.Client&version=3.5.0
CapMonster Cloud .NET SDK: C# CAPTCHA Solver & Anti-Bot API Client
<p align="center"> <a href="https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=dotnet_repo_readme"> <img src="https://img.shields.io/badge/CapMonster%20Cloud-.NET%20Captcha%20Solver-00B2FF?style=for-the-badge&logo=dotnet&logoColor=white" alt="CapMonster Cloud .NET SDK" height="40"> </a> </p>
<p align="center"> <strong>Official asynchronous C# / .NET client for automated CAPTCHA solving in web scraping, browser automation, and testing workflows.</strong> </p>
<p align="center"> <a href="https://www.nuget.org/packages/Zennolab.CapMonsterCloud.Client/"><img src="https://img.shields.io/nuget/v/Zennolab.CapMonsterCloud.Client.svg?style=flat-square&color=blue" alt="NuGet Version"></a> <a href="https://www.nuget.org/packages/Zennolab.CapMonsterCloud.Client/"><img src="https://img.shields.io/nuget/dt/Zennolab.CapMonsterCloud.Client.svg?style=flat-square&color=green" alt="NuGet Downloads"></a> <a href="https://github.com/CapMonsterCloud/capmonster-dotnet-captcha-solver/stargazers"><img src="https://img.shields.io/github/stars/CapMonsterCloud/capmonster-dotnet-captcha-solver?style=flat-square&color=yellow" alt="GitHub Stars"></a> <a href="https://github.com/CapMonsterCloud/capmonster-dotnet-captcha-solver/network/members"><img src="https://img.shields.io/github/forks/CapMonsterCloud/capmonster-dotnet-captcha-solver?style=flat-square" alt="GitHub Forks"></a> <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-orange.svg?style=flat-square" alt="License: MIT"></a> </p>
Official .NET client library for CapMonster Cloud. Integrate automated CAPTCHA recognition into C#, ASP.NET, WPF, Selenium, and browser automation projects using an asynchronous API client.
The service supports popular CAPTCHA and anti-bot task types, including reCAPTCHA v2/v3/Enterprise, Cloudflare Turnstile, GeeTest, DataDome, Amazon WAF, Imperva, and image-to-text tasks.
👉 Get your Free API Key & Free Trial Balance on CapMonster Cloud
⚡ Highlights
- ⚡ Async-first API: Use
async/awaitthroughSolveAsyncfor scalable .NET automation. - 🧩 Modern CAPTCHA coverage: Work with reCAPTCHA, Turnstile, GeeTest, Amazon WAF, DataDome, Imperva, and more.
- 🌐 Automation-ready: Designed for browser automation, scraping, testing, and backend workflows.
- 🛡️ Proxy support: Send proxy settings with task types that require browser-session matching.
- 📖 Official API docs: Supported task specifications and methods are maintained in the CapMonster Cloud documentation.
📦 Installation
Install via the NuGet Package Manager:
Install-Package Zennolab.CapMonsterCloud.Client
Or install through the .NET CLI:
dotnet add package Zennolab.CapMonsterCloud.Client
🚀 Quick Start
1. Initialize the Client
Create an API key in the CapMonster Cloud Dashboard, then initialize the client:
using Zennolab.CapMonsterCloud.Client;
using Zennolab.CapMonsterCloud.Client.Options;
using Zennolab.CapMonsterCloud.Client.Requests;
var clientOptions = new ClientOptions
{
ClientKey = "YOUR_CAPMONSTER_CLOUD_API_KEY"
};
var cmCloudClient = CapMonsterCloudClientFactory.Create(clientOptions);
2. Solve reCAPTCHA v2 with a Proxy
var recaptchaV2Request = 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 result = await cmCloudClient.SolveAsync(recaptchaV2Request);
Console.WriteLine($"Solved token: {result.Solution.GRecaptchaResponse}");
3. Submit a Custom WAF Task
Use custom-task request models for supported advanced protection systems. Consult the supported CAPTCHA task documentation for required payload fields and the task type that matches your integration.
var tspdRequest = new TspdCustomTaskRequest(
tspdCookie: "TS386a400d029=...",
htmlPageBase64: "PCFET0NU...k+PC9odG1sPg==")
{
WebsiteUrl = "https://yourwebsite.com/page-with-tspd",
Proxy = new ProxyContainer(
"203.0.113.45",
8080,
ProxyType.Http,
"login",
"password")
};
var result = await cmCloudClient.SolveAsync(tspdRequest);
🛡️ Supported Task Families
See the official Supported CAPTCHA Types for current task parameters, response formats, and API examples.
| Task family | Example request classes in this SDK |
|---|---|
| reCAPTCHA | RecaptchaV2Request, RecaptchaV2EnterpriseRequest, RecaptchaV3ProxylessRequest, RecaptchaV3EnterpriseRequest |
| Cloudflare Turnstile | TurnstileRequest |
| GeeTest | GeeTestRequest |
| Amazon WAF | AmazonWafRequest |
| Image-to-Text | ImageToTextRequest |
| Complex image tasks | RecaptchaComplexImageTaskRequest, RecognitionComplexImageTaskRequest |
| Custom anti-bot tasks | DataDomeCustomTaskRequest, ImpervaCustomTaskRequest, TspdCustomTaskRequest, and other supported custom-task classes |
🛠️ How It Works
[ .NET Application / Browser Automation ]
│
▼
[ Create request model with task data ]
│
▼
[ CapMonster Cloud .NET SDK ] ──► createTask API request
│
▼
[ SolveAsync polls for task result ]
│
▼
[ Receive token / solution ] ──► Use it in your authorized workflow
⚙️ Best Practices
- Use the right task type: Choose the task model that matches the target protection and follow the required parameters in the official documentation.
- Keep browser context consistent: When a task requires a proxy, use a compatible proxy configuration for the associated automation session.
- Act on results promptly: CAPTCHA tokens can expire; submit or inject them immediately after receiving the response.
- Check balance and errors: Use the API methods documentation for
getBalance, task creation, and task-result handling.
📚 Documentation & Support
- 📖 Getting Started
- 🧩 Supported CAPTCHA Types
- ⚙️ API Methods: createTask, getTaskResult, getBalance
- 🌐 Browser Extension Guides
- 💬 CapMonster Cloud
Other official SDKs
📄 License
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Newtonsoft.Json (>= 13.0.4)
- System.ComponentModel.Annotations (>= 5.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on Zennolab.CapMonsterCloud.Client:
| Repository | Stars |
|---|---|
|
Titlehhhh/Minecraft-Holy-Client
A high-performance platform for running Minecraft stress-test bots written in C#.
|
| Version | Downloads | Last Updated |
|---|---|---|
| 4.0.3 | 382 | 10/27/2026 |
| 4.0.2 | 107 | 10/27/2026 |
| 4.0.1 | 194 | 10/23/2026 |
| 4.0.0 | 218 | 10/15/2026 |
| 3.5.0 | 1,200 | 9/11/2026 |
| 3.4.0 | 872 | 7/30/2026 |
| 3.3.0 | 1,719 | 6/23/2026 |
| 3.1.0 | 11,918 | 8/12/2025 |
| 3.0.1 | 6,064 | 3/26/2025 |
| 3.0.0 | 504 | 3/3/2025 |
| 2.1.0 | 335 | 2/19/2025 |
| 2.0.0 | 345 | 2/11/2025 |
| 1.10.1 | 157,368 | 6/26/2024 |
| 1.10.0 | 306 | 6/24/2024 |
| 1.9.0 | 3,478 | 3/18/2024 |
| 1.8.0 | 570 | 2/22/2024 |
| 1.7.3 | 326 | 2/22/2024 |
| 1.7.2 | 4,521 | 10/20/2023 |
| 1.7.1 | 7,246 | 8/23/2023 |
| 1.7.0 | 883 | 8/3/2023 |
Added RecaptchaV3EnterpriseRequest (reCAPTCHA v3 Enterprise). New optional parameters: reCAPTCHA v2 Enterprise apiDomain/pageAction/cookies/userAgent, reCAPTCHA v2 isInvisible, reCAPTCHA v3 isEnterprise, Turnstile action, Prosopo userAgent, ComplexImageTask exampleImageUrls/exampleImagesBase64 and recognition metadata PayloadType, Hunt widgetUrl, Alibaba punishUrl/cookieRequired. Relaxed validation: Amazon WAF websiteKey/captchaScript/challengeScript/context/iv and ComplexImageTask websiteURL are optional; Imperva reese84UrlEndpoint and TenDI captchaUrl constructor parameters are optional. Responses now expose userAgent (FunCaptcha, reCAPTCHA v2/v3, Turnstile), cookies (reCAPTCHA v2) and metadata (grid ComplexImageTask).