SweetMeSoft.Captcha 1.10.103

SweetMeSoft.Captcha

Library for automatic resolution of different types of captchas using the 2Captcha service.

Description

SweetMeSoft.Captcha is a library for .NET Standard 2.1 that acts as a wrapper for the 2Captcha service, simplifying the process of sending and solving captchas. It is compatible with various types of captcha, including image captchas, ReCaptcha (v2, v3, Invisible, Enterprise) and hCaptcha.

Features

• Resolution of Multiple Captcha Types:
  • Normal: Image to text captchas.
  • ReCaptchaV2: The classic "I'm not a robot".
  • ReCaptchaV2Invisible: Invisible ReCaptcha that is activated by behavior.
  • ReCaptchaV3: Score-based ReCaptcha.
  • ReCaptchaEnterprise: The enterprise version of ReCaptcha.
• Email Notification: Sends an email notification when the 2Captcha account balance is low, avoiding service interruptions.
• Simple Configuration: Easily configured through the CaptchaOptions class.

Dependencies

• SweetMeSoft.Base
• SweetMeSoft.Tools
• TwoCaptcha.dll (Third-party library included in the project).

Installation

dotnet add package SweetMeSoft.Captcha

Usage

The library usage is centered on the static Solver class. You must create an instance of CaptchaOptions and pass it to the SolveAsync method.

CaptchaOptions

Usage Example

using SweetMeSoft.Base.Captcha;
using SweetMeSoft.Captcha;
using System.Threading.Tasks;

public class CaptchaExample
{
    public async Task SolveImageCaptcha()
    {
        var options = new CaptchaOptions
        {
            TwoCaptchaKey = "YOUR_2CAPTCHA_API_KEY",
            CaptchaType = CaptchaType.Normal,
            ImageBase64 = "iVBORw0KGgoAAAANSUhEUgAA..." // Image content in Base64
        };

        string result = await Solver.SolveAsync(options);
        // `result` will contain the solved captcha text
    }

    public async Task SolveReCaptchaV2()
    {
        var options = new CaptchaOptions
        {
            TwoCaptchaKey = "YOUR_2CAPTCHA_API_KEY",
            CaptchaType = CaptchaType.ReCaptchaV2,
            SiteKey = "THE_PAGE_SITE_KEY",
            SiteUrl = "https://www.google.com/recaptcha/api2/demo"
        };

        string result = await Solver.SolveAsync(options);
        // `result` will contain the ReCaptcha response token
    }
}

License

This project is under the MIT license.