C# में MTCaptcha: Playwright में MtCaptchaAsync से हल करें

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

C# में असली ब्राउज़र के साथ MTCaptcha हल करने के लिए पेज को Playwright for .NET में खोलें, पेज के mtcaptchaConfig object से sitekey पढ़ें, और उसे CapSkip NuGet पैकेज के MtCaptchaAsync को दें। लौटा हुआ token hidden mtcaptcha-verifiedtoken फ़ील्ड में जाता है, और एक click फ़ॉर्म post करता है। यह call CapSkip MTCaptcha सॉल्वर को जाती है, जो आपके अपने Windows PC पर चलता है। CapSkip विकृत टेक्स्ट खुद पढ़ता है, और प्रति token कोई शुल्क नहीं लगता।

आपको क्या चाहिए

  • CapSkip 4.3.0 या नया, Windows PC पर, क्योंकि MTCaptcha इसी रिलीज़ में आया। इसे पहले चालू करने के लिए यह देखें: सेटअप गाइड.
  • कम से कम .NET 8 SDK, साथ में दो NuGet पैकेज: Microsoft.Playwright और CapSkip 1.7.0 या बाद का, जिसमें MtCaptchaAsync आया। यहाँ सिर्फ़ SDK 10.0.100 इंस्टॉल है, इसलिए मैंने उसी से net10.0 और net8.0 के लिए build किया, CapSkip 1.7.0 और Playwright 1.64.1 के साथ। सिर्फ़ 8 SDK वाली मशीन पर टेस्ट नहीं किया गया।
  • Windows PowerShell 5.1 या बाद का, और ऐसा पेज जिसे आप ऑटोमेट कर सकते हों और जिस पर MTCaptcha widget हो।
  • CapSkip के लिए एक पता। Local mode सिर्फ़ 127.0.0.1 पर जवाब देता है। Server mode में API आपके नेटवर्क या पब्लिक IP पर भी, दूसरी मशीनों से, पहुँच में रहता है। इनमें से क्या मिलेगा, यह इस पर निर्भर है: कनेक्शन सेटिंग्स.

नतीजों के पीछे तीन चीज़ें हैं। इस PC पर असली CapSkip app को तीन टास्क मिले: दो 2Captcha के डेमो पेज के public मानों के लिए और एक उसी sitekey के लिए किसी दूसरे domain पर। उसके Release build folder में 4.3.0 लिखा है, लेकिन मैं पुष्टि नहीं कर सका कि जवाब देने वाला instance वही build था। Chromium ने डेमो पेज को सिर्फ़ पढ़ने के लिए लोड किया, और कोई token किसी साइट को नहीं गया। मेरा एक mock in.php, res.php और एक login साइट की भूमिका निभाता है, मेरे अपने फ़ॉर्म नियमों के साथ। किसी असली साइट पर टेस्ट नहीं हुआ।

चरण 1: project सेट करें और ब्राउज़र लाएँ

NuGet पैकेज में कोई ब्राउज़र नहीं होता। build, playwright.ps1 को output folder में लिखता है, इसलिए पहले एक बार build करें, फिर script चलाएँ। ब्राउज़र इंस्टॉल करने के लिए Playwright दस्तावेज़ pwsh के साथ कमांड लिखते हैं, जो PowerShell 7 है। मेरे PC पर सिर्फ़ Windows PowerShell 5.1 है, और script वहाँ 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"

इंस्टॉल में 33.5 सेकंड लगे और Chrome for Testing 156.0.8078.4 (197.5 MiB) तथा एक headless shell (118.1 MiB) आए। आपके Playwright वर्ज़न के ब्राउज़र के बिना launch एक बिना संभाले गए PlaywrightException के साथ नाकाम होता है, Executable doesn’t exist।

Program.cs में सब कुछ मिटा दें, template की Console.WriteLine पंक्ति समेत। फिर चरण 2, चरण 3 और चरण 4 के ब्लॉक उसी क्रम में चिपकाएँ, और Proxy snippet को छोड़ दें। सिर्फ़ पहले ब्लॉक में using पंक्तियाँ हैं, इसलिए आख़िरी ब्लॉक आते ही program काम करने लगता है।

चरण 2: पेज की config पढ़ें और MtCaptchaAsync को call करें

पेज अपना sitekey mtcaptchaConfig नाम के एक script variable में सेट करता है, और वही object एक action भी रख सकता है। classic script variable window की property होता है, इसलिए Playwright उसे HTML parse किए बिना लोड हुए पेज से पढ़ सकता है।

2Captcha के डेमो पेज पर, GotoAsync के लौटने पर window.mtcaptchaConfig 16 में से 16 लोड में undefined था (दो सिर्फ़-पढ़ने वाले रन) और 0.3 से 1.8 सेकंड बाद दिखा, इसलिए कोड उसका इंतज़ार करता है। मेरा mock पेज उसे लोड के 1.5 सेकंड बाद बनाता है, और wait पंक्ति हटाने पर program Cannot read properties of undefined कहने वाले PlaywrightException के साथ रुक गया। कोड दो keys पढ़ता है, sitekey और action, और खाली action पर लौट आता है। डेमो पेज के object में sitekey था, कोई action नहीं, और widget का जोड़ा हुआ एक renderQueue array था।

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);
    }
}

पते के लिए page.Url इस्तेमाल करें, क्योंकि redirect के बाद ब्राउज़र वहीं खड़ा होता है। SDK खाली option को छोड़ देता है, और जिस पेज में कोई action नहीं, उसके लिए mock को कोई action फ़ील्ड नहीं दिखा। MTCaptcha के validate token गाइड में check का जवाब वह action बताता है जिससे captcha शुरू हुआ था, ताकि साइट उसकी तुलना कर सके: वही भेजें जो आपका पेज सेट करता है। शुरुआती sk= हटा दिया जाता है। userAgent option वह User-Agent तय करता है जो CapSkip MTCaptcha को दिखाता है, और API दस्तावेज़ कहते हैं कि कुछ न भेजने पर वह Windows के लिए Chrome वाला इस्तेमाल करता है। proxy option नीचे के snippet में है।

// 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"),
};

नतीजा token को Token और Code, दोनों में रखता है। असली app के सामने वह v1( से शुरू हुआ और 394 अक्षरों का था, UserAgent और RespKey null के साथ। call से उसके लौटने तक नापने पर असली app (Release build 4.3.0, चलता वर्ज़न अपुष्ट, Windows, 2 रन) ने 3.85 और 3.88 सेकंड लिए। SDK 0, 0.25, 0.75, 1.75 और 3.75 सेकंड पर poll करता है, फिर अंतराल दोगुना करता है। इसलिए token पाँचवें poll पर आया (समय से अनुमानित, log में दर्ज नहीं) और हल लगभग 1.8 से 3.8 सेकंड के बीच पूरा हुआ।

कुछ भी भेजने से पहले SDK जो आपने दिया उसे जाँचता है। नौ गलत calls (खाली, बिना prefix वाला, स्पेस वाला या 65 अक्षरों का sitekey, सापेक्ष, ftp वाला या गायब पेज पता, असमर्थित option और GOPHER का proxytype) ValidationException के साथ ठुकरा दी गईं और mock को कुछ नहीं भेजा गया। असली app ने मेरी raw रिक्वेस्ट में उसी तरह के इनपुट को ERROR_BAD_PARAMETERS, ERROR_PAGEURL और ERROR_PROXY_FORMAT के साथ ठुकराया।

MTCaptcha defaultTimeout इस्तेमाल करता है, 120 सेकंड, क्योंकि हल के लिए कोई ब्राउज़र नहीं चलता। 300 सेकंड वाला recaptchaTimeout लागू नहीं होता: जिस mock में कोई token तैयार नहीं था उसके सामने इसे 3 पर सेट करने से कुछ नहीं हुआ, और मेरे 8 सेकंड के budget ने इंतज़ार खत्म किया। defaultTimeout 5 पर होने पर CapSkip का TimeoutException call के करीब 8 सेकंड बाद आया (net10.0 पर 7.86, दो net8.0 रन में 7.88 और 8.42), क्योंकि SDK अगले poll तक सोता है और जब वह poll deadline के बाद देय होता है तब exception फेंकता है।

SDK के सभी exceptions CapSkipError को extend करते हैं। ApiException पूरा जवाब अपने संदेश के रूप में रखता है, उदाहरण के लिए {"status":0,"request":"ERROR_RECAPTCHA_INVALID_DOMAIN"}, जो असली app ने example.com पर डेमो sitekey के लिए 0.33 सेकंड बाद लौटाया। NetworkException का मतलब है कि रिक्वेस्ट खुद नाकाम हुई: उस host और port पर किसी ने जवाब नहीं दिया, जवाब HTTP 200 नहीं था, या call रद्द हुई। Polling इसे दोबारा आज़माती है, इसलिए poll के बीच mock को मार देने पर call NetworkException के बजाय TimeoutException पर खत्म हुई। Playwright तीन जाल जोड़ता है। Implicit usings System को import करती हैं, जिसमें भी एक TimeoutException है, इसलिए using CapSkip के बगल में सादा TimeoutException CS0104 के साथ फेल होता है, और पहला ब्लॉक SDK की class को SolverTimeout के नाम से alias करता है। Playwright अपने timeouts को System.TimeoutException के रूप में रिपोर्ट करता है, जिसे चरण 4 में उसके पूरे नाम से पकड़ा गया है। दोनों libraries एक Proxy class भी परिभाषित करती हैं, इसीलिए snippet में CapSkip.Proxy है।

कोई Playwright .NET method CancellationToken नहीं लेता, और हर एक डिफ़ॉल्ट रूप से 30 सेकंड इंतज़ार करता है, इसलिए token सिर्फ़ CapSkip calls को कवर करता है। mock में, 2 सेकंड का budget जब in.php के अटके रहने के दौरान चला तो वह TaskCanceledException लपेटे हुए NetworkException के रूप में सामने आया, और polling के दौरान चला तो सादे TaskCanceledException के रूप में, दोनों करीब 2 सेकंड बाद।

चरण 3: hidden फ़ील्ड भरें और सबमिट करें

token फ़ील्ड hidden है, और FillAsync किसी दिखने वाले फ़ील्ड का इंतज़ार करता है: मेरे mock पेज पर वह पूरे 30 सेकंड रुका और System.TimeoutException फेंका। इसलिए ब्लॉक मान को EvaluateAsync से पेज के अंदर सेट करता है, और RunAndWaitForResponseAsync form post का status लौटाता है।

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"));
    }
}

widget उस फ़ील्ड का क्या करता है जिसे आप खुद सेट करें? 2Captcha के डेमो पेज पर Chromium 156.0.8078.4 को एक form में mtcaptcha-verifiedtoken नाम का एक hidden input मिला, जो विज़िटर के चैलेंज हल करने तक खाली रहता है। मैंने उसे एक placeholder पर सेट किया और 8 सेकंड इंतज़ार किया। मान टिका रहा, और widget ने MTCaptcha को कोई रिक्वेस्ट नहीं भेजी। उसका getVerifiedToken method फिर भी खाली string लौटाता रहा, इसलिए widget फ़ील्ड को वापस नहीं पढ़ता। मैंने Check पर click नहीं किया और उस पेज पर कोई असली token नहीं रखा, इसलिए उसका सर्वर ऐसे मान का क्या करता है, यह बिना टेस्ट किया है। MTCaptcha एक verified-callback का दस्तावेज़ देता है जो तब चलता है जब widget विज़िटर को verify करता है, और डेमो पेज कोई register नहीं करता, इसलिए ऐसा पेज जिसका बटन उसका इंतज़ार करता है, बिना टेस्ट किया है।

चरण 4: C# में MTCaptcha को शुरू से अंत तक चलाएँ

Main सबसे आख़िर में आता है। PageUrl बदलें (जैसा चिपकाया गया है वह example.com को रिक्वेस्ट करता है, जिसमें कोई widget नहीं है), फिर program को dotnet run से शुरू करें। हर कोशिश को अपना browser context मिलता है, इसलिए साइट को नया session दिखता है। 400 से नीचे का form जवाब रन खत्म करता है, ठुकराया गया form या ERROR_CAPTCHA_UNSOLVABLE एक नई कोशिश कराता है, और कोई भी दूसरा CapSkip error रन को खत्म कर देता है।

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;
    }
}

ये पंक्तियाँ mock के नतीजे हैं, जो किसी असली साइट के बारे में कुछ नहीं कहते, और net10.0 तथा net8.0 पर एक जैसी रहीं।

mock सेटिंगप्रोग्राम ने क्या किया
डिफ़ॉल्ट, पेज action login सेट करता है200 Signed in, in.php में action के साथ। कोई action न रखने वाले पेज ने कोई नहीं भेजा
साइट ने पहले form post पर 403 दियानए context में दूसरी कोशिश, नए टास्क के साथ, फिर 200
फ़ॉर्म पहुँचने तक token expire हो चुकातीन 403 पंक्तियाँ, exit code 1
ERROR_RECAPTCHA_INVALID_SITEKEY या ERROR_RECAPTCHA_INVALID_DOMAINजवाब, exit code 1, एक टास्क, कोई retry नहीं

आम errors

आप जो देखते हैंकारणफिक्स
ValidationExceptionSDK ने call को स्थानीय रूप से ठुकराया: गलत sitekey, ऐसा पेज पता जो absolute http या https URL नहीं है, या ऐसा option जो MTCaptcha API में नहीं हैargument ठीक करें। retry से मदद नहीं मिल सकती
ERROR_RECAPTCHA_INVALID_SITEKEY या ERROR_RECAPTCHA_INVALID_DOMAINMTCaptcha sitekey को नहीं जानता (सिर्फ़ mock में), या उसे उस पेज के domain पर अनुमति नहीं है (असली app, example.com)पेज से sitekey और पेज का पता फिर पढ़ें। retry न करें
ERROR_CAPTCHA_UNSOLVABLECapSkip चैलेंज पास नहीं कर पाया (API दस्तावेज़; मैं इसे असली app के सामने पैदा नहीं कर सका)Main नया टास्क सबमिट करता है
CapSkip TimeoutExceptiondefaultTimeout के भीतर कोई token नहीं आया। यह तब उठाया जाता है जब deadline के बाद का पहला poll देय होता है, इसलिए 5 सेकंड की deadline करीब 8 सेकंड पर खत्म होती हैdefaultTimeout बढ़ाएँ
फ़ॉर्म token को ठुकराता हैvalidate token गाइड token-expired (आम तौर पर 120 सेकंड), token-duplicate-cal और privatekey-mismatch-token (दूसरा sitekey) सूचीबद्ध करता हैtoken को post से ठीक पहले माँगें, उसे एक बार इस्तेमाल करें, और पेज का sitekey और action वही रखें

Server mode: CapSkip किसी दूसरे PC पर

Server mode में CapSkip आपके नेटवर्क पते या पब्लिक IP पर सुनता है, इसलिए यह program किसी दूसरे PC पर चल सकता है जबकि solver आपके नियंत्रण वाली Windows मशीन पर रहता है। CapSkipClient पंक्ति में host की जगह सर्वर का पता रखें, और बाकी कुछ नहीं हिलता।

Server mode शुरू करने से CapSkip का port हर पते के लिए खुल जाता है। जिन पतों से आप उम्मीद नहीं करते उनके लिए Windows Firewall में block rule जोड़ें, और CapSkipClient पंक्ति में apiKey के साथ API Key Validation चालू करें।

FAQ

अगर पेज में mtcaptchaConfig नहीं है तो sitekey कहाँ है?

widget iframe के पते में, service.mtcaptcha.com से। डेमो पेज पर उसमें config वाले मान के साथ एक sitekey parameter था।

क्या C# में MTCaptcha हल करने के लिए Playwright चाहिए?

नहीं। CapSkip हल के लिए कोई ब्राउज़र नहीं चलाता, और Playwright यहाँ इसलिए है क्योंकि उदाहरण पेज अपनी config script में बनाता है। सादा form post भी वही mtcaptcha-verifiedtoken फ़ील्ड ले जाता है, और C# में hCaptcha पोस्ट HttpClient के साथ वही रास्ता दिखाती है।

साइट मेरा पाया हुआ token क्यों ठुकराएगी?

तीन इनकार कारण, जो validate token गाइड में बताए गए हैं, ये हैं: एक token जिसकी जाँच पहले हो चुकी है, एक जो expire हो गया (आम तौर पर 120 सेकंड बाद), और एक जो किसी दूसरे sitekey से आया। साइट को action की भी तुलना करनी चाहिए। मेरे पास कोई असली साइट नहीं थी, इसलिए मैं इन कारणों को क्रम में नहीं रख सकता।

C# में MTCaptcha का मतलब है mtcaptchaConfig पढ़ना, एक MtCaptchaAsync call, और click से ठीक पहले भरा गया hidden फ़ील्ड। CapSkip फिक्स्ड कीमत वाला कैप्चा सॉल्वर है जो आपके अपने PC पर चलता है, इसलिए ठुकराए गए फ़ॉर्म पर बस एक और कोशिश लगती है। .NET में दूसरे CAPTCHA प्रकारों के लिए C# कैप्चा सॉल्वर पेज देखें। widget को पास होते देखने के लिए MTCaptcha डेमो खोलें, और रॉ रिक्वेस्ट फ़ॉर्मैट के लिए यह पढ़ें: API दस्तावेज़.