C#’ta MTCaptcha: Playwright’ta MtCaptchaAsync ile Çözün

C#’ta MTCaptcha’yı gerçek bir tarayıcıyla çözmek için sayfayı Playwright for .NET ile açın, sitekey’i sayfanın mtcaptchaConfig nesnesinden okuyun ve onu CapSkip NuGet paketindeki MtCaptchaAsync çağrısına verin. Dönen token gizli mtcaptcha-verifiedtoken alanına girer ve bir tıklama formu gönderir. Çağrıyı yanıtlayan CapSkip MTCaptcha çözücüsü kendi Windows bilgisayarınızda çalışır. CapSkip çarpıtılmış metni kendisi okur, token başına ücret yoktur.
Neye ihtiyacınız var
- Bir Windows bilgisayarında CapSkip 4.3.0 veya daha yenisi; MTCaptcha o sürümle geldi. Önce çalışır hâle getirmek için bkz. kurulum kılavuzu.
- En az .NET 8 SDK ve iki NuGet paketi: Microsoft.Playwright ile MtCaptchaAsync metodunu getiren ilk sürüm olan CapSkip 1.7.0 veya üzeri. Burada yalnızca SDK 10.0.100 kurulu; bu yüzden onunla net10.0 ve net8.0 için CapSkip 1.7.0 ve Playwright 1.64.1 kullanarak derledim. Yalnızca .NET 8 SDK bulunan bir makine denenmedi.
- Windows PowerShell 5.1 veya üzeri ve üzerinde otomasyon yapmanıza izin verilen, MTCaptcha widget’ı olan bir sayfa.
- CapSkip için bir adres. Local modu yalnızca 127.0.0.1 üzerinde yanıt verir. Server modunda API, ağınızda veya genel IP’nizde de, diğer makinelerden erişilebilir. Hangisini kullanacağınızı seçtiğiniz yer: bağlantı ayarları.
Sonuçların arkasında üç şey var. Bu bilgisayardaki gerçek CapSkip uygulaması üç görev aldı: ikisi 2Captcha demo sayfasının herkese açık değerleri için, biri o sitekey’in başka bir alan adındaki hâli için. Release derleme klasörü 4.3.0 gösteriyor, ama yanıt veren örneğin o derleme olduğunu doğrulayamadım. Chromium demo sayfasını salt okunur yükledi ve hiçbir siteye token gitmedi. Benim yazdığım bir mock in.php, res.php ve bir giriş sitesinin yerini tutar, form kuralları da bana aittir. Gerçek bir site test edilmedi.
1. Adım: projeyi kurun ve tarayıcıyı indirin
NuGet paketi tarayıcı içermez. Derleme playwright.ps1 dosyasını çıktı klasörüne yazar; bu yüzden önce bir kez derleyin, sonra script’i çalıştırın. Tarayıcı kurulumu için Playwright belgeleri komutu pwsh ile, yani PowerShell 7 ile yazar. Bilgisayarımda yalnızca Windows PowerShell 5.1 var ve script burada bir execution policy bypass altında çalıştı.
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"
Kurulum 33,5 saniye sürdü ve Chrome for Testing 156.0.8078.4 (197,5 MiB) ile bir headless shell (118,1 MiB) indirdi. Playwright sürümünüz için bir tarayıcı yoksa başlatma, işlenmemiş bir PlaywrightException ile, Executable doesn’t exist iletisiyle başarısız olur.
Program.cs içindeki her şeyi silin; şablonun Console.WriteLine satırı da dahil. Sonra 2., 3. ve 4. Adım bloklarını bu sırayla yapıştırın ve Proxy parçasını dışarıda bırakın. Yalnızca ilk blok using satırları taşır, bu yüzden son blok girince program çalışır.
2. Adım: sayfanın config’ini okuyun ve MtCaptchaAsync çağrısını yapın
Bir sayfa sitekey’ini mtcaptchaConfig adlı bir script değişkeninde ayarlar ve aynı nesne bir action da taşıyabilir. Klasik bir script değişkeni window nesnesinin bir özelliğidir; bu yüzden Playwright HTML ayrıştırmadan onu yüklenmiş sayfadan okuyabilir.
2Captcha demo sayfasında GotoAsync döndüğünde window.mtcaptchaConfig, 16 yüklemenin 16 tanesinde undefined idi (iki salt okunur çalıştırma) ve 0,3 ile 1,8 saniye sonra belirdi; bu yüzden kod onu bekler. Mock sayfam onu yüklemeden 1,5 saniye sonra kurar ve bekleme satırı silindiğinde program Cannot read properties of undefined diyen bir PlaywrightException ile durdu. Kod iki anahtar okur, sitekey ve action, ve boş bir action değerine döner. Demo sayfası nesnesinde bir sitekey vardı, action yoktu ve widget’ın eklediği bir renderQueue dizisi vardı.
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);
}
}Adres için page.Url kullanın, çünkü tarayıcının herhangi bir yönlendirmeden sonra durduğu yer odur. SDK boş bir seçeneği atar ve mock, action ayarlamayan bir sayfa için action alanı görmedi. MTCaptcha validate token kılavuzundaki kontrol yanıtı, captcha’nın başladığı action değerini taşır; böylece bir site karşılaştırabilir: sayfanızın ayarladığını gönderin. Baştaki sk= soyulur. userAgent seçeneği CapSkip’in MTCaptcha’ya sunduğu User-Agent’ı belirler ve API belgeleri, hiçbir şey göndermezseniz Windows için bir Chrome dizesi kullandığını söyler. Proxy seçeneği aşağıdaki parçadadır.
// 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"),
};Sonuç token’ı hem Token hem Code içine koyar. Gerçek uygulamaya karşı v1( ile başladı ve 394 karakterdi; UserAgent ve RespKey null idi. Çağrıdan dönüşüne kadar ölçüldüğünde gerçek uygulama (Release derlemesi 4.3.0, çalışan sürüm doğrulanmadı, Windows, 2 çalıştırma) 3,85 ve 3,88 saniye sürdü. SDK 0; 0,25; 0,75; 1,75 ve 3,75 saniyede yoklar, sonra aralığı ikiye katlar. Yani token beşinci yoklamada geldi (sürelerden çıkarıldı, günlüğe yazılmadı) ve çözüm yaklaşık 1,8 ile 3,8 saniye arasında bitti.
Hiçbir şey göndermeden önce SDK verdiğiniz değerleri doğrular. Dokuz hatalı çağrı (boş, öneksiz, boşluklu ya da 65 karakterlik bir sitekey, göreli, ftp ya da eksik bir sayfa adresi, desteklenmeyen bir seçenek ve GOPHER değerli bir proxytype) ValidationException ile reddedildi ve mock’a hiçbir şey göndermedi. Gerçek uygulama ham isteklerimde aynı türden girdileri ERROR_BAD_PARAMETERS, ERROR_PAGEURL ve ERROR_PROXY_FORMAT ile reddetti.
MTCaptcha defaultTimeout kullanır, 120 saniye, çünkü çözüm için hiçbir tarayıcı çalışmaz. 300 saniyelik recaptchaTimeout geçerli değildir: token hazır olmayan bir mock’a karşı 3 yapıldığında hiçbir etkisi olmadı ve benim 8 saniyelik bütçem beklemeyi bitirdi. defaultTimeout 5 iken CapSkip TimeoutException çağrıdan yaklaşık 8 saniye sonra geldi (net10.0 üzerinde 7,86; iki net8.0 çalıştırmasında 7,88 ve 8,42), çünkü SDK bir sonraki yoklamaya kadar uyur ve o yoklama süre sonundan sonra esas olunca fırlatır.
Tüm SDK istisnaları CapSkipError sınıfından türer. ApiException yanıtın tamamını ileti olarak taşır, örneğin {"status":0,"request":"ERROR_RECAPTCHA_INVALID_DOMAIN"}; gerçek uygulama bunu, example.com üzerindeki demo sitekey için 0,33 saniye sonra döndürdü. NetworkException, isteğin kendisinin başarısız olduğu anlamına gelir: o host ve portta hiçbir şey yanıt vermedi, yanıt HTTP 200 değildi ya da çağrı iptal edildi. Yoklama bunu yeniden dener; bu yüzden mock yoklama sırasında kapatıldığında çağrı NetworkException ile değil TimeoutException ile bitti. Playwright üç tuzak ekler. Örtük using ifadeleri System ad alanını içe aktarır ve onun da bir TimeoutException sınıfı vardır; bu yüzden using CapSkip yanında yalın bir TimeoutException CS0104 ile başarısız olur ve ilk blok SDK sınıfına SolverTimeout takma adını verir. Playwright kendi zaman aşımlarını System.TimeoutException olarak bildirir ve 4. Adım’da tam adıyla yakalanır. İki kütüphane de bir Proxy sınıfı tanımlar, bu yüzden parçada CapSkip.Proxy yazıyor.
Hiçbir Playwright .NET metodu CancellationToken almaz ve her biri varsayılan olarak 30 saniye bekler; bu yüzden CancellationToken yalnızca CapSkip çağrılarını kapsar. Mock’ta, in.php takılıyken sona eren 2 saniyelik bir bütçe TaskCanceledException saran bir NetworkException olarak, yoklama sırasında sona eren ise düz bir TaskCanceledException olarak ortaya çıktı; ikisi de yaklaşık 2 saniye sonra.
3. Adım: gizli alanı doldurun ve gönderin
Token alanı gizlidir ve FillAsync görünür bir alan için bekler: mock sayfamda tam 30 saniye bekledi ve System.TimeoutException fırlattı. Bu yüzden blok değeri sayfanın içinde EvaluateAsync ile ayarlar ve RunAndWaitForResponseAsync form gönderiminin durumunu döndürür.
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 kendi ayarladığınız bir alana ne yapar? 2Captcha demo sayfasında Chromium 156.0.8078.4, bir form içinde mtcaptcha-verifiedtoken adlı, bir ziyaretçi challenge’ı çözene kadar boş olan tek bir gizli input buldu. Onu bir yer tutucuya ayarladım ve 8 saniye bekledim. Değer kaldı ve widget MTCaptcha’ya hiçbir istek göndermedi. getVerifiedToken metodu hâlâ boş bir dize döndürdü; yani widget alanı geri okumuyor. Check düğmesine tıklamadım ve o sayfaya gerçek bir token koymadım; bu yüzden sayfa sunucusunun böyle bir değerle ne yaptığı denenmedi. MTCaptcha, widget bir ziyaretçiyi doğruladığında çalışan bir verified-callback belgeler ve demo sayfası hiçbirini kaydetmez; bu yüzden düğmesi onu bekleyen bir sayfa denenmedi.
4. Adım: C#’ta MTCaptcha için uçtan uca çalıştırma
Main en sona gelir. PageUrl değerini değiştirin (yapıştırıldığı hâliyle widget’ı olmayan example.com adresini ister), sonra programı dotnet run ile başlatın. Her deneme kendi tarayıcı bağlamını alır, bu yüzden site yeni bir oturum görür. 400 değerinin altındaki bir form yanıtı çalıştırmayı bitirir, reddedilen bir form ya da ERROR_CAPTCHA_UNSOLVABLE yeni bir deneme gerektirir ve başka her CapSkip hatası çalıştırmayı sonlandırır.
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;
}
}Bu satırlar mock sonuçlarıdır; gerçek bir site hakkında hiçbir şey söylemezler ve net10.0 ile net8.0 üzerinde aynıydılar.
| Mock ayarı | Program ne yaptı |
|---|---|
| Varsayılanlar, sayfa action değerini login yapıyor | 200 Signed in, action in.php içinde. Action değeri olmayan bir sayfa hiçbir şey göndermedi |
| Site ilk form gönderimine 403 yanıtı verdi | Yeni bağlamda, yeni bir görevle ikinci deneme, sonra 200 |
| Form geldiğinde token süresi dolmuş | Üç 403 satırı, çıkış kodu 1 |
| ERROR_RECAPTCHA_INVALID_SITEKEY veya ERROR_RECAPTCHA_INVALID_DOMAIN | Yanıt, çıkış kodu 1, bir görev, yeniden deneme yok |
Yaygın hatalar
| Gördüğünüz | Neden | Düzeltme |
|---|---|---|
| ValidationException | SDK çağrıyı yerel olarak reddetti: hatalı bir sitekey, mutlak bir http veya https URL’si olmayan bir sayfa adresi ya da MTCaptcha API’sinin almadığı bir seçenek | Argümanı düzeltin. Yeniden denemek yardımcı olmaz |
| ERROR_RECAPTCHA_INVALID_SITEKEY veya ERROR_RECAPTCHA_INVALID_DOMAIN | MTCaptcha sitekey’i tanımıyor (yalnızca mock) ya da sitekey o sayfanın alan adında kullanılamaz (gerçek uygulama, example.com) | Sitekey’i ve sayfa adresini sayfadan yeniden okuyun. Yeniden denemeyin |
| ERROR_CAPTCHA_UNSOLVABLE | CapSkip challenge’ı geçemedi (API belgeleri; gerçek uygulamada tetikleyemedim) | Main yeni bir görev gönderir |
| CapSkip TimeoutException | defaultTimeout içinde token yok. İlk yoklama süre sonundan sonra esas olduğunda fırlatılır; bu yüzden 5 saniyelik bir süre sonu yaklaşık 8 saniyede biter | defaultTimeout değerini artırın |
| Form bir token’ı reddediyor | validate token kılavuzu token-expired (genellikle 120 saniye), token-duplicate-cal ve privatekey-mismatch-token (başka bir sitekey) değerlerini listeler | Token’ı gönderimden hemen önce isteyin, bir kez kullanın ve sayfanın sitekey ve action değerlerini koruyun |
Server modu: CapSkip başka bir bilgisayarda
Server modunda CapSkip ağ adresinizi ya da bir genel IP’yi dinler; bu yüzden bu program başka bir bilgisayarda çalışabilir, çözücü ise sizin denetlediğiniz bir Windows makinesinde kalır. CapSkipClient satırındaki host yerine sunucunun adresini yazın, başka hiçbir şey değişmez.
Server modunu başlatmak CapSkip portunu her adrese açar. Beklemediğiniz adresler için bir Windows Firewall engelleme kuralı ekleyin ve CapSkipClient satırında bir apiKey ile API Key Validation’ı açın.
FAQ
Sayfada mtcaptchaConfig yoksa sitekey nerede?
service.mtcaptcha.com adresinden gelen widget iframe adresinde. Demo sayfasında config değerini taşıyan bir sitekey parametresi vardı.
C#’ta MTCaptcha çözmek için Playwright gerekir mi?
Hayır. CapSkip çözüm için hiçbir tarayıcı çalıştırmaz; Playwright burada yalnızca örnek sayfa config’ini script ile kurduğu için var. Düz bir form gönderimi aynı mtcaptcha-verifiedtoken alanını taşır; C#’ta hCaptcha yazısı bu yolu HttpClient ile gösterir.
Bir site aldığım token’ı neden reddeder?
Üç ret nedeni validate token kılavuzunda listelenir: daha önce denetlenmiş bir token, süresi dolmuş bir token (genellikle 120 saniye sonra) ve başka bir sitekey’den gelen bir token. Bir site action değerini de karşılaştırmalıdır. Gerçek bir sitem yoktu, bu yüzden bu nedenleri sıralayamam.
C#’ta MTCaptcha çözmek, mtcaptchaConfig nesnesini okumaya, tek bir MtCaptchaAsync çağrısına ve tıklamadan hemen önce doldurulan bir gizli alana iner. CapSkip, sabit lisanslı bir captcha çözücü olduğundan ve kendi bilgisayarınızda çalıştığından, reddedilen bir form yalnızca bir deneme daha demektir. .NET’te diğer CAPTCHA türleri için bkz. C# CAPTCHA çözücü sayfası. Bir widget’ın geçtiğini görmek için bkz. MTCaptcha demosu, ham istek biçimi için ise bkz. API belgeleri.
