MTCaptcha in C#: Mit Playwright und MtCaptchaAsync lösen

mtcaptcha in c# - MTCaptcha in C#: Solve It in Playwright With MtCaptchaAsync

Um MTCaptcha in C# mit einem echten Browser zu lösen, öffnen Sie die Seite in Playwright for .NET, lesen den sitekey aus dem Objekt mtcaptchaConfig der Seite und übergeben ihn an MtCaptchaAsync aus dem CapSkip-NuGet-Paket. Der zurückgegebene Token kommt in das versteckte Feld mtcaptcha-verifiedtoken, und ein Klick sendet das Formular ab. Der Aufruf geht an den CapSkip-MTCaptcha-Solver auf Ihrem eigenen Windows-PC. CapSkip liest den verzerrten Text selbst, ohne Gebühr pro Token.

Was Sie brauchen

  • CapSkip 4.3.0 oder neuer auf einem Windows-PC, denn mit dieser Version kam MTCaptcha hinzu. Bringen Sie es zuerst zum Laufen, mit der Einrichtungsanleitung.
  • Das .NET 8 SDK oder neuer, dazu zwei NuGet-Pakete: Microsoft.Playwright und CapSkip 1.7.0 oder neuer, das MtCaptchaAsync eingeführt hat. Hier ist nur SDK 10.0.100 installiert, daher habe ich damit für net10.0 und net8.0 gebaut, mit CapSkip 1.7.0 und Playwright 1.64.1. Ein Rechner mit nur dem SDK 8 ist ungetestet.
  • Windows PowerShell 5.1 oder neuer und eine Seite, die Sie automatisieren dürfen, mit einem MTCaptcha-Widget.
  • Eine Adresse für CapSkip. Der Local-Modus antwortet nur auf 127.0.0.1. Im Server-Modus ist die API zusätzlich in Ihrem Netzwerk oder unter Ihrer öffentlichen IP erreichbar, auch von anderen Rechnern. Welchen Modus Sie bekommen, bestimmen die Verbindungseinstellungen.

Drei Dinge stehen hinter den Ergebnissen. Die echte CapSkip-App auf diesem PC bekam drei Aufgaben: zwei für die öffentlichen Werte der Demoseite von 2Captcha und eine für diesen sitekey auf einer anderen Domain. Ihr Release-Build-Ordner trägt 4.3.0, aber ich konnte nicht bestätigen, dass die antwortende Instanz dieser Build war. Chromium lud die Demoseite nur lesend, und kein Token ging an eine Website. Ein Mock von mir spielt in.php, res.php und eine Login-Website, mit Formularregeln von mir. Es wurde keine echte Website getestet.

Schritt 1: Das Projekt einrichten und den Browser holen

Das NuGet-Paket enthält keinen Browser. Der Build schreibt playwright.ps1 in den Ausgabeordner, bauen Sie also einmal und führen Sie dann das Skript aus. Zum Installieren von Browsern schreibt die Playwright-Dokumentation den Befehl mit pwsh, also mit PowerShell 7. Mein PC hat nur Windows PowerShell 5.1, und das Skript lief dort mit einem Execution-Policy-Bypass.

dotnet new console -o mtcaptcha-demo
cd mtcaptcha-demo
dotnet add package CapSkip
dotnet add package Microsoft.Playwright
dotnet build
powershell -ExecutionPolicy Bypass -Command "& (Get-ChildItem bin\Debug\net*\playwright.ps1 | Select-Object -First 1).FullName install chromium"

Die Installation dauerte 33,5 Sekunden und holte Chrome for Testing 156.0.8078.4 (197,5 MiB) und eine Headless Shell (118,1 MiB). Ohne einen Browser für Ihre Playwright-Version scheitert der Start mit einer unbehandelten PlaywrightException, Executable doesn’t exist.

Löschen Sie in Program.cs alles, auch die Zeile Console.WriteLine der Vorlage. Fügen Sie dann die Blöcke von Schritt 2, Schritt 3 und Schritt 4 in dieser Reihenfolge ein und lassen Sie das Proxy-Snippet weg. Nur der erste Block enthält using-Zeilen, das Programm funktioniert also, sobald der letzte Block eingefügt ist.

Schritt 2: Die Config der Seite lesen und MtCaptchaAsync aufrufen

Eine Seite setzt ihren sitekey in einer Script-Variable namens mtcaptchaConfig, und dasselbe Objekt kann eine action enthalten. Eine klassische Script-Variable ist eine Eigenschaft von window, daher kann Playwright sie aus der geladenen Seite lesen, ohne HTML zu parsen.

Auf der Demoseite von 2Captcha war window.mtcaptchaConfig bei 16 von 16 Ladevorgängen (zwei Läufe, die nur lasen) undefined, als GotoAsync zurückkehrte, und erschien 0,3 bis 1,8 Sekunden später, deshalb wartet der Code darauf. Meine Mock-Seite baut es 1,5 Sekunden nach dem Laden auf, und ohne die Wartezeile brach das Programm mit einer PlaywrightException ab, die Cannot read properties of undefined meldet. Der Code liest zwei Schlüssel, sitekey und action, und fällt auf eine leere action zurück. Das Objekt der Demoseite hatte einen sitekey, keine action und ein Array renderQueue, das das Widget ergänzt.

using CapSkip;
using Microsoft.Playwright;
// Implicit usings import System, which has a TimeoutException too (a bare one fails with CS0104).
using SolverTimeout = CapSkip.TimeoutException;

static class Solve
{
    // Local mode. In Server mode, use your server's address instead. If API Key
    // Validation is on in CapSkip, also pass apiKey: "YOUR_KEY" here.
    static readonly CapSkipClient Client = new(host: "127.0.0.1", port: 8080);

    // The page's own script sets window.mtcaptchaConfig, and the widget reads the same object.
    public static async Task<SolveResult> Token(IPage page, CancellationToken ct)
    {
        await page.WaitForFunctionAsync("() => window.mtcaptchaConfig?.sitekey");
        var config = await page.EvaluateAsync<string[]>(
            "() => [window.mtcaptchaConfig.sitekey, window.mtcaptchaConfig.action || '']");
        // The SDK leaves out an empty option, so a page that sets no action sends none.
        var options = new Dictionary<string, object?> { ["action"] = config[1] };
        // page.Url is where the browser is now, after any redirect.
        return await Client.MtCaptchaAsync(config[0], page.Url, options, ct);
    }
}

Verwenden Sie page.Url für die Adresse, denn dort steht der Browser nach jeder Weiterleitung. Das SDK verwirft eine leere Option, und der Mock sah bei einer Seite ohne action kein Feld action. Die Prüfantwort in der MTCaptcha-Anleitung zur Token-Validierung enthält die action, mit der das Captcha gestartet wurde, sodass eine Website sie vergleichen kann: Senden Sie die, die Ihre Seite setzt. Ein führendes sk= wird entfernt. Die Option userAgent legt den User-Agent fest, den CapSkip gegenüber MTCaptcha angibt, und laut API-Dokumentation verwendet CapSkip einen User-Agent für Chrome unter Windows, wenn Sie keinen senden. Die Option proxy steht im Snippet unten.

// Snippet, not part of Program.cs. In Solve.Token, replace the options line with this one.
// CapSkip and Microsoft.Playwright both define a Proxy class, so write CapSkip's out in full.
var options = new Dictionary<string, object?>
{
    ["action"] = config[1],
    ["proxy"] = new CapSkip.Proxy("HTTP", "login:[email protected]:8080"),
};

Das Ergebnis legt den Token sowohl in Token als auch in Code ab. Bei der echten App begann er mit v1( und war 394 Zeichen lang, mit UserAgent und RespKey gleich null. Gemessen vom Aufruf bis zu seiner Rückkehr brauchte die echte App (Release-Build 4.3.0, laufende Version unbestätigt, Windows, 2 Läufe) 3,85 und 3,88 Sekunden. Das SDK fragt nach 0; 0,25; 0,75; 1,75 und 3,75 Sekunden ab und verdoppelt dann den Abstand. Der Token kam also bei der fünften Abfrage an (aus den Zeiten geschlossen, nicht protokolliert), und die Lösung endete zwischen etwa 1,8 und 3,8 Sekunden.

Bevor etwas gesendet wird, validiert das SDK, was Sie übergeben haben. Neun fehlerhafte Aufrufe (ein leerer, ein präfixloser, ein mit Leerzeichen versehener oder ein 65 Zeichen langer sitekey, eine relative, ftp- oder fehlende Seitenadresse, eine nicht unterstützte Option und ein proxytype GOPHER) wurden mit einer ValidationException abgelehnt und sendeten nichts an den Mock. Die echte App lehnte dieselben Arten von Eingaben in meinen rohen Anfragen mit ERROR_BAD_PARAMETERS, ERROR_PAGEURL und ERROR_PROXY_FORMAT ab.

MTCaptcha verwendet defaultTimeout, 120 Sekunden, weil für das Lösen kein Browser läuft. Das recaptchaTimeout von 300 Sekunden gilt nicht: Auf 3 gesetzt, bewirkte es gegen einen Mock ohne fertigen Token nichts, und mein Budget von 8 Sekunden beendete das Warten. Mit defaultTimeout auf 5 kam die CapSkip TimeoutException etwa 8 Sekunden nach dem Aufruf an (7,86 unter net10.0, 7,88 und 8,42 in zwei Läufen unter net8.0), weil das SDK bis zur nächsten Abfrage schläft und die Exception erst wirft, sobald diese Abfrage nach der Frist fällig ist.

Alle SDK-Exceptions erweitern CapSkipError. ApiException trägt die ganze Antwort als Meldung, zum Beispiel {"status":0,"request":"ERROR_RECAPTCHA_INVALID_DOMAIN"}, was die echte App nach 0,33 Sekunden für den Demo-sitekey auf example.com zurückgab. NetworkException bedeutet, dass die Anfrage selbst scheiterte: Unter diesem Host und Port antwortete nichts, die Antwort war nicht HTTP 200 oder der Aufruf wurde abgebrochen. Das Polling wiederholt sie, daher endete der Aufruf bei einem mitten in der Abfrage beendeten Mock in der TimeoutException, nicht in einer NetworkException. Playwright bringt drei Fallen mit. Implizite usings importieren System, das ebenfalls eine TimeoutException hat, sodass eine bloße neben using CapSkip mit CS0104 scheitert, und der erste Block gibt der SDK-Klasse den Alias SolverTimeout. Playwright meldet seine eigenen Timeouts als System.TimeoutException, die in Schritt 4 unter ihrem vollen Namen gefangen wird. Beide Bibliotheken definieren außerdem eine Klasse Proxy, daher CapSkip.Proxy im Snippet.

Keine .NET-Methode von Playwright nimmt ein CancellationToken an, und jede wartet standardmäßig 30 Sekunden, daher deckt das CancellationToken nur die CapSkip-Aufrufe ab. Im Mock zeigte sich ein Budget von 2 Sekunden, das ausgelöst wurde, während in.php hing, als NetworkException, die eine TaskCanceledException umhüllt, und eines, das während der Abfrage ausgelöst wurde, als einfache TaskCanceledException, beide nach etwa 2 Sekunden.

Schritt 3: Das versteckte Feld füllen und absenden

Das Token-Feld ist versteckt, und FillAsync wartet auf ein sichtbares: Auf meiner Mock-Seite wartete es die vollen 30 Sekunden und warf System.TimeoutException. Der Block setzt den Wert deshalb mit EvaluateAsync innerhalb der Seite, und RunAndWaitForResponseAsync gibt den Status des Formular-POSTs zurück.

static class Submit
{
    // Returns the status of the form post and the text the page shows afterwards.
    public static async Task<(int Status, string Text)> Run(IPage page, string token)
    {
        await page.FillAsync("input[name=user]", "alice");  // your form's own fields go here
        await page.FillAsync("input[name=password]", "YOUR_PASSWORD");
        // The token field is hidden and FillAsync waits for a visible one, so set it in the page.
        await page.EvaluateAsync(
            "t => { document.querySelector('input[name=\"mtcaptcha-verifiedtoken\"]').value = t; }", token);
        var response = await page.RunAndWaitForResponseAsync(
            () => page.ClickAsync("button[type=submit]"), r => r.Request.Method == "POST");
        return (response.Status, await page.InnerTextAsync("#result"));
    }
}

Was macht das Widget mit einem Feld, das Sie selbst setzen? Auf der Demoseite von 2Captcha fand Chromium 156.0.8078.4 in einem Formular ein verstecktes Input namens mtcaptcha-verifiedtoken, leer, bis ein Besucher die Challenge löst. Ich setzte es auf einen Platzhalter und wartete 8 Sekunden. Der Wert blieb, und das Widget sendete keine Anfrage an MTCaptcha. Seine Methode getVerifiedToken gab weiterhin einen leeren String zurück, das Widget liest das Feld also nicht zurück. Ich habe weder auf Check geklickt noch einen echten Token auf diese Seite gesetzt, daher ist ungetestet, was ihr Server mit einem solchen Wert macht. MTCaptcha dokumentiert einen verified-callback, der läuft, wenn das Widget einen Besucher verifiziert, und die Demoseite registriert keinen, daher ist eine Seite, deren Button darauf wartet, ungetestet.

Schritt 4: MTCaptcha in C# von Anfang bis Ende ausführen

Main kommt zuletzt. Ändern Sie PageUrl (wie eingefügt fordert es example.com an, das kein Widget hat) und starten Sie das Programm dann mit dotnet run. Jeder Versuch bekommt seinen eigenen Browser-Kontext, die Website sieht also eine neue Session. Eine Formularantwort unter 400 beendet den Lauf, ein abgelehntes Formular oder ERROR_CAPTCHA_UNSOLVABLE führt zu einem neuen Versuch, und jeder andere CapSkip-Fehler beendet ihn.

static class Program
{
    const string PageUrl = "https://example.com/login";  // the page that shows the MTCaptcha widget

    static async Task<int> Main()
    {
        // One budget for the CapSkip calls. Playwright calls keep their own 30 second default.
        using var budget = new CancellationTokenSource(TimeSpan.FromMinutes(3));
        using var playwright = await Playwright.CreateAsync();
        await using var browser = await playwright.Chromium.LaunchAsync(new() { Headless = true });
        try
        {
            for (var attempt = 1; attempt <= 3; attempt++)
            {
                // A new context per attempt gives the site a fresh session and a fresh form.
                await using var context = await browser.NewContextAsync();
                var page = await context.NewPageAsync();
                await page.GotoAsync(PageUrl);

                SolveResult solved;
                try { solved = await Solve.Token(page, budget.Token); }
                catch (ApiException ex) when (ex.Message.Contains("ERROR_CAPTCHA_UNSOLVABLE"))
                {
                    Console.WriteLine($"attempt {attempt}: CapSkip could not pass the challenge");
                    continue;
                }

                var (status, text) = await Submit.Run(page, solved.Token!);
                Console.WriteLine($"attempt {attempt}: {status} {text}");
                if (status < 400) return 0;
            }
            Console.WriteLine("no accepted form after 3 attempts");
        }
        // A cancelled submit surfaces as a NetworkException and a cancelled poll as a
        // TaskCanceledException, so test the budget itself.
        catch (Exception) when (budget.IsCancellationRequested) { Console.WriteLine("the 3 minute budget ran out"); }
        catch (ValidationException ex) { Console.WriteLine($"CapSkip refused the arguments: {ex.Message}"); }
        catch (ApiException ex) { Console.WriteLine($"CapSkip answered {ex.Message}"); }
        catch (SolverTimeout ex) { Console.WriteLine($"no token in time: {ex.Message}"); }
        catch (CapSkipError ex) { Console.WriteLine($"{ex.GetType().Name}: {ex.Message}"); }
        // Playwright reports its own timeouts as System.TimeoutException.
        catch (System.TimeoutException ex) { Console.WriteLine($"the page was too slow: {ex.Message.Split('\n')[0]}"); }
        catch (PlaywrightException ex) { Console.WriteLine($"the browser failed: {ex.Message.Split('\n')[0]}"); }
        return 1;
    }
}

Diese Zeilen sind Mock-Ergebnisse, die nichts über eine echte Website aussagen, und waren unter net10.0 und net8.0 identisch.

Mock-EinstellungWas das Programm tat
Standardwerte, die Seite setzt die action login200 Signed in, mit der action in in.php. Eine Seite ohne action sendete keine
Erster Formular-POST von der Website mit 403 beantwortetZweiter Versuch in einem neuen Kontext mit einer neuen Aufgabe, dann 200
Token abgelaufen, wenn das Formular eintrifftDrei Zeilen mit 403, Exit-Code 1
ERROR_RECAPTCHA_INVALID_SITEKEY oder ERROR_RECAPTCHA_INVALID_DOMAINDie Antwort, Exit-Code 1, eine Aufgabe, keine Wiederholung

Häufige Fehler

Was Sie sehenUrsacheBeheben
ValidationExceptionDas SDK hat den Aufruf lokal abgelehnt: ein ungültiger sitekey, eine Seitenadresse, die keine absolute http- oder https-URL ist, oder eine Option, die die MTCaptcha-API nicht kenntKorrigieren Sie das Argument. Eine Wiederholung hilft nicht
ERROR_RECAPTCHA_INVALID_SITEKEY oder ERROR_RECAPTCHA_INVALID_DOMAINMTCaptcha kennt den sitekey nicht (nur Mock) oder er ist auf der Domain dieser Seite nicht erlaubt (echte App, example.com)Lesen Sie sitekey und Seitenadresse erneut von der Seite. Wiederholen Sie nicht
ERROR_CAPTCHA_UNSOLVABLECapSkip hat die Challenge nicht bestanden (API-Dokumentation; ich konnte es bei der echten App nicht provozieren)Main sendet eine neue Aufgabe
CapSkip TimeoutExceptionKein Token innerhalb von defaultTimeout. Die Exception wird ausgelöst, wenn die erste Abfrage nach der Frist fällig ist, eine Frist von 5 Sekunden endet also bei etwa 8 SekundenErhöhen Sie defaultTimeout
Das Formular lehnt einen Token abDie Anleitung zur Token-Validierung nennt token-expired (üblicherweise 120 Sekunden), token-duplicate-cal und privatekey-mismatch-token (anderer sitekey)Fordern Sie den Token kurz vor dem POST an, verwenden Sie ihn nur einmal und behalten Sie den sitekey und die action der Seite bei

Server-Modus: CapSkip auf einem anderen PC

Im Server-Modus lauscht CapSkip auf Ihrer Netzwerkadresse oder einer öffentlichen IP, sodass dieses Programm auf einem anderen PC laufen kann, während der Solver auf einem Windows-Rechner bleibt, den Sie kontrollieren. Setzen Sie die Adresse des Servers anstelle des Hosts in der Zeile CapSkipClient ein, und sonst ändert sich nichts.

Beim Start des Server-Modus wird der CapSkip-Port für jede Adresse geöffnet. Fügen Sie eine Block-Regel der Windows-Firewall für die Adressen hinzu, die Sie nicht erwarten, und schalten Sie API Key Validation mit einem apiKey in der Zeile CapSkipClient ein.

FAQ

Wo ist der sitekey, wenn die Seite kein mtcaptchaConfig hat?

In der Adresse des Widget-iframes von service.mtcaptcha.com. Auf der Demoseite trug sie einen Parameter sitekey mit dem Config-Wert.

Brauche ich Playwright, um MTCaptcha in C# zu lösen?

Nein. CapSkip lässt für das Lösen keinen Browser laufen, und Playwright ist hier, weil die Beispielseite ihre Config in einem Script aufbaut. Ein einfacher Formular-POST trägt dasselbe Feld mtcaptcha-verifiedtoken, und der Beitrag zu hCaptcha in C# zeigt diesen Weg mit HttpClient.

Warum würde eine Website den Token ablehnen, den ich bekommen habe?

Die drei Ablehnungsgründe in der Anleitung zur Token-Validierung sind ein bereits geprüfter Token, ein abgelaufener (üblicherweise nach 120 Sekunden) und ein Token von einem anderen sitekey. Eine Website sollte außerdem die action vergleichen. Ich hatte keine echte Website, daher kann ich diese Gründe nicht gewichten.

MTCaptcha in C# besteht aus dem Lesen von mtcaptchaConfig, einem MtCaptchaAsync-Aufruf und einem versteckten Feld, das kurz vor dem Klick gefüllt wird. CapSkip ist ein Captcha-Löser mit Pauschallizenz auf Ihrem eigenen PC, daher kostet ein abgelehntes Formular nur einen weiteren Versuch. Für andere Captcha-Typen in .NET sehen Sie die C#-Captcha-Solver-Seite. Um zu sehen, wie ein Widget bestanden wird, öffnen Sie die MTCaptcha-Demo, und das Format der rohen Anfragen lesen Sie in der API-Dokumentation.