MTCaptcha di C#: Pecahkan dengan Playwright dan MtCaptchaAsync

Untuk memecahkan MTCaptcha di C# dengan browser sungguhan, buka halaman di Playwright for .NET, baca sitekey dari objek mtcaptchaConfig milik halaman, dan teruskan ke MtCaptchaAsync dari paket NuGet CapSkip. Token yang dikembalikan masuk ke field tersembunyi mtcaptcha-verifiedtoken, dan sebuah klik mengirim formulir. Panggilan itu menuju pemecah MTCaptcha CapSkip di PC Windows Anda sendiri. CapSkip membaca teks yang terdistorsi itu sendiri, tanpa biaya per token.
Apa yang Anda butuhkan
- CapSkip 4.3.0 atau lebih baru di PC Windows, karena rilis itulah yang menghadirkan MTCaptcha. Jalankan dulu dengan mengikuti panduan penyiapan.
- SDK .NET 8 atau lebih baru, ditambah dua paket NuGet: Microsoft.Playwright dan CapSkip 1.7.0 atau lebih baru, yang memperkenalkan MtCaptchaAsync. Di sini hanya SDK 10.0.100 yang terpasang, jadi saya membangun untuk net10.0 dan net8.0 dengannya, memakai CapSkip 1.7.0 dan Playwright 1.64.1. Mesin yang hanya memiliki SDK 8 belum diuji.
- Windows PowerShell 5.1 atau lebih baru dan halaman dengan widget MTCaptcha yang boleh Anda otomatisasi.
- Sebuah alamat untuk CapSkip. Mode Local hanya menjawab di 127.0.0.1. Dalam mode Server, API juga dapat dijangkau di jaringan atau IP publik Anda, dari mesin lain. Mana yang Anda dapatkan bergantung pada pengaturan koneksi.
Tiga hal melatarbelakangi hasil ini. Aplikasi CapSkip asli di PC ini menerima tiga task: dua untuk nilai publik halaman demo 2Captcha dan satu untuk sitekey itu di domain lain. Folder build Release-nya bertuliskan 4.3.0, tetapi saya tidak dapat memastikan instance yang menjawab adalah build itu. Chromium memuat halaman demo secara read-only, dan tidak ada token yang dikirim ke situs mana pun. Sebuah mock buatan saya memerankan in.php, res.php, dan situs login, dengan aturan formulir saya sendiri. Tidak ada situs sungguhan yang diuji.
Langkah 1: siapkan proyek dan unduh browser
Paket NuGet tidak berisi browser. Proses build menulis playwright.ps1 ke folder output, jadi build sekali, lalu jalankan skripnya. Untuk menginstal browser, lihat dokumentasi Playwright yang menulis perintahnya dengan pwsh, yaitu PowerShell 7. PC saya hanya memiliki Windows PowerShell 5.1, dan skripnya berjalan di sana dengan bypass execution policy.
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"
Instalasi memakan waktu 33.5 detik dan mengunduh Chrome for Testing 156.0.8078.4 (197.5 MiB) dan sebuah headless shell (118.1 MiB). Tanpa browser untuk versi Playwright Anda, peluncuran gagal dengan PlaywrightException yang tidak tertangani, Executable doesn’t exist.
Hapus semua isi Program.cs, termasuk baris Console.WriteLine dari template. Lalu tempelkan blok Langkah 2, Langkah 3, dan Langkah 4 dalam urutan itu, dan lewati cuplikan Proxy. Hanya blok pertama yang memuat baris using, jadi program berfungsi setelah blok terakhir terpasang.
Langkah 2: baca konfigurasi halaman dan panggil MtCaptchaAsync
Halaman menetapkan sitekey-nya dalam variabel script bernama mtcaptchaConfig, dan objek yang sama dapat membawa action. Variabel script klasik adalah properti window, sehingga Playwright dapat membacanya dari halaman yang dimuat tanpa mengurai HTML.
Pada halaman demo 2Captcha, window.mtcaptchaConfig berstatus undefined saat GotoAsync kembali pada 16 dari 16 pemuatan (dua eksekusi read-only) dan muncul 0.3 sampai 1.8 detik kemudian, jadi kode menunggunya. Halaman mock saya membangunnya 1.5 detik setelah dimuat, dan dengan baris wait dihapus, program berhenti dengan PlaywrightException yang menyebut Cannot read properties of undefined. Kode membaca dua key, sitekey dan action, dan beralih ke action kosong. Objek pada halaman demo memiliki sitekey, tanpa action, dan array renderQueue yang ditambahkan widget.
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);
}
}Pakai page.Url untuk alamat, karena itulah posisi browser setelah redirect apa pun. SDK membuang opsi kosong, dan mock tidak melihat field action untuk halaman yang tidak menetapkannya. Balasan pemeriksaan di panduan validasi token MTCaptcha membawa action yang dipakai captcha saat dimulai, sehingga situs dapat membandingkannya: kirim action yang ditetapkan halaman Anda. Awalan sk= di depan dibuang. Opsi userAgent menetapkan User-Agent yang disampaikan CapSkip ke MTCaptcha, dan dokumentasi API menyebut CapSkip memakai User-Agent Chrome untuk Windows ketika Anda tidak mengirim apa pun. Opsi proxy ada di cuplikan di bawah.
// 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"),
};Hasilnya menaruh token di Token dan Code sekaligus. Pada aplikasi asli, token diawali v1( dan panjangnya 394 karakter, dengan UserAgent dan RespKey bernilai null. Diukur dari panggilan hingga kembali, aplikasi asli (build Release 4.3.0, versi yang berjalan belum terkonfirmasi, Windows, 2 eksekusi) memerlukan 3.85 dan 3.88 detik. SDK melakukan polling pada 0, 0.25, 0.75, 1.75, dan 3.75 detik, lalu menggandakan jedanya. Jadi token tiba pada polling kelima (disimpulkan dari waktunya, tidak dicatat di log) dan pemecahan selesai antara sekitar 1.8 dan 3.8 detik.
Sebelum mengirim apa pun, SDK memvalidasi yang Anda berikan. Sembilan panggilan buruk (sitekey kosong, tanpa prefiks, berspasi, atau 65 karakter, alamat halaman yang relatif, ftp, atau tidak ada, opsi yang tidak didukung, dan proxytype GOPHER) ditolak dengan ValidationException dan tidak mengirim apa pun ke mock. Aplikasi asli menolak jenis input yang sama pada permintaan mentah saya dengan ERROR_BAD_PARAMETERS, ERROR_PAGEURL, dan ERROR_PROXY_FORMAT.
MTCaptcha memakai defaultTimeout, 120 detik, karena tidak ada browser yang berjalan untuk pemecahan. recaptchaTimeout 300 detik tidak berlaku: diatur ke 3 terhadap mock tanpa token siap, ia tidak berpengaruh, dan anggaran 8 detik saya yang mengakhiri penantian. Dengan defaultTimeout 5, TimeoutException CapSkip tiba sekitar 8 detik setelah panggilan (7.86 pada net10.0, 7.88 dan 8.42 pada dua eksekusi net8.0), karena SDK tidur sampai polling berikutnya dan melempar error begitu polling itu jatuh tempo setelah tenggat.
Semua exception SDK memperluas CapSkipError. ApiException membawa seluruh balasan sebagai pesannya, misalnya {"status":0,"request":"ERROR_RECAPTCHA_INVALID_DOMAIN"}, yang dikembalikan aplikasi asli setelah 0.33 detik untuk sitekey demo di example.com. NetworkException berarti permintaannya sendiri gagal: tidak ada yang menjawab di host dan port itu, balasannya bukan HTTP 200, atau panggilan dibatalkan. Polling mencoba ulang hal ini, jadi dengan mock dimatikan di tengah polling, panggilan berakhir dengan TimeoutException, bukan NetworkException. Playwright menambahkan tiga jebakan. Implicit usings mengimpor System, yang juga memiliki TimeoutException, jadi TimeoutException polos di samping using CapSkip gagal dengan CS0104, dan blok pertama memberi alias pada class SDK sebagai SolverTimeout. Playwright melaporkan timeout-nya sendiri sebagai System.TimeoutException, yang ditangkap dengan nama lengkapnya di Langkah 4. Kedua pustaka juga mendefinisikan class Proxy, maka CapSkip.Proxy di cuplikan.
Tidak ada metode Playwright .NET yang menerima CancellationToken, dan masing-masing menunggu 30 detik secara default, jadi CancellationToken hanya mencakup panggilan CapSkip. Pada mock, anggaran 2 detik yang habis saat in.php menggantung muncul sebagai NetworkException yang membungkus TaskCanceledException, dan yang habis saat polling muncul sebagai TaskCanceledException biasa, keduanya setelah sekitar 2 detik.
Langkah 3: isi field tersembunyi dan kirim
Field token bersifat tersembunyi, dan FillAsync menunggu field yang terlihat: pada halaman mock saya, ia menunggu penuh 30 detik dan melempar System.TimeoutException. Jadi blok ini menetapkan nilainya di dalam halaman dengan EvaluateAsync, dan RunAndWaitForResponseAsync mengembalikan status POST formulir.
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"));
}
}Apa yang dilakukan widget terhadap field yang Anda isi sendiri? Pada halaman demo 2Captcha, Chromium 156.0.8078.4 menemukan satu input tersembunyi bernama mtcaptcha-verifiedtoken di dalam formulir, kosong sampai pengunjung menyelesaikan challenge. Saya mengisinya dengan placeholder dan menunggu 8 detik. Nilainya bertahan, dan widget tidak mengirim permintaan ke MTCaptcha. Metode getVerifiedToken miliknya tetap mengembalikan string kosong, jadi widget tidak membaca ulang field itu. Saya tidak mengklik Check atau memasukkan token asli pada halaman itu, jadi apa yang dilakukan servernya dengan nilai semacam itu belum diuji. MTCaptcha mendokumentasikan verified-callback yang berjalan ketika widget memverifikasi pengunjung, dan halaman demo tidak mendaftarkannya, jadi halaman yang tombolnya menunggu callback itu belum diuji.
Langkah 4: jalankan MTCaptcha di C# dari awal sampai akhir
Main datang terakhir. Ubah PageUrl (seperti yang ditempel, ia meminta example.com, yang tidak punya widget), lalu mulai program dengan dotnet run. Setiap percobaan mendapat konteks browser sendiri, jadi situs melihat sesi baru. Jawaban formulir di bawah 400 mengakhiri eksekusi, formulir yang ditolak atau ERROR_CAPTCHA_UNSOLVABLE memakan satu percobaan baru, dan error CapSkip lainnya mengakhirinya.
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;
}
}Baris-baris ini adalah hasil mock, yang tidak membuktikan apa pun tentang situs sungguhan, dan identik pada net10.0 dan net8.0.
| Pengaturan mock | Yang dilakukan program |
|---|---|
| Default, halaman menetapkan action login | 200 Signed in, dengan action di in.php. Halaman tanpa action tidak mengirimnya |
| POST formulir pertama dijawab 403 oleh situs | Percobaan kedua di konteks baru dengan task baru, lalu 200 |
| Token kedaluwarsa saat formulir tiba | Tiga baris 403, exit code 1 |
| ERROR_RECAPTCHA_INVALID_SITEKEY, atau ERROR_RECAPTCHA_INVALID_DOMAIN | Balasannya, exit code 1, satu task, tanpa percobaan ulang |
Kesalahan umum
| Apa yang Anda lihat | Penyebab | Perbaiki |
|---|---|---|
| ValidationException | SDK menolak panggilan secara lokal: sitekey yang buruk, alamat halaman yang bukan URL http atau https absolut, atau opsi yang tidak dimiliki API MTCaptcha | Perbaiki argumennya. Mencoba ulang tidak akan membantu |
| ERROR_RECAPTCHA_INVALID_SITEKEY atau ERROR_RECAPTCHA_INVALID_DOMAIN | MTCaptcha tidak mengenal sitekey (hanya pada mock), atau sitekey tidak diizinkan pada domain halaman itu (aplikasi asli, example.com) | Baca ulang sitekey dan alamat halaman dari halaman. Jangan coba ulang |
| ERROR_CAPTCHA_UNSOLVABLE | CapSkip tidak berhasil melewati challenge (dokumentasi API; saya tidak bisa memancingnya pada aplikasi asli) | Main mengirim task baru |
| CapSkip TimeoutException | Tidak ada token dalam defaultTimeout. Error ini muncul ketika polling pertama setelah tenggat jatuh tempo, jadi tenggat 5 detik berakhir sekitar 8 detik | Naikkan defaultTimeout |
| Formulir menolak token | Panduan validasi token mencantumkan token-expired (biasanya 120 detik), token-duplicate-cal, dan privatekey-mismatch-token (sitekey lain) | Minta token tepat sebelum POST, pakai sekali, dan pertahankan sitekey serta action milik halaman |
Mode Server: CapSkip di PC lain
Dalam mode Server, CapSkip mendengarkan di alamat jaringan Anda atau IP publik, jadi program ini dapat berjalan di PC lain sementara pemecah tetap berada di mesin Windows yang Anda kendalikan. Ganti host pada baris CapSkipClient dengan alamat server, dan tidak ada hal lain yang berubah.
Memulai mode Server membuka port CapSkip untuk semua alamat. Tambahkan aturan blokir Windows Firewall untuk alamat yang tidak Anda harapkan, dan aktifkan API Key Validation dengan apiKey pada baris CapSkipClient.
FAQ
Di mana sitekey jika halaman tidak punya mtcaptchaConfig?
Di alamat iframe widget, dari service.mtcaptcha.com. Pada halaman demo, alamat itu membawa parameter sitekey dengan nilai konfigurasi.
Apakah saya perlu Playwright untuk memecahkan MTCaptcha di C#?
Tidak. CapSkip tidak menjalankan browser untuk pemecahan, dan Playwright ada di sini karena halaman contoh membangun konfigurasinya lewat script. POST formulir biasa membawa field mtcaptcha-verifiedtoken yang sama, dan artikel hCaptcha di C# menunjukkan jalur itu dengan HttpClient.
Mengapa situs bisa menolak token yang saya dapatkan?
Tiga penolakan di panduan validasi token adalah token yang sudah diperiksa, token yang kedaluwarsa (biasanya setelah 120 detik), dan token yang berasal dari sitekey lain. Situs juga sebaiknya membandingkan action. Saya tidak punya situs sungguhan, jadi saya tidak dapat mengurutkan penyebabnya.
MTCaptcha di C# intinya membaca mtcaptchaConfig, satu panggilan MtCaptchaAsync, dan field tersembunyi yang diisi tepat sebelum klik. CapSkip adalah pemecah captcha dengan lisensi tetap di PC Anda sendiri, jadi formulir yang ditolak hanya memakan satu percobaan lagi. Untuk tipe CAPTCHA lain di .NET, lihat Halaman pemecah CAPTCHA C#. Untuk melihat widget berhasil dilewati, buka Demo MTCaptcha, dan untuk format permintaan mentah baca Dokumentasi API.
