Решение MTCaptcha на C# в Playwright через MtCaptchaAsync

Чтобы решить MTCaptcha на C# в настоящем браузере, откройте страницу в Playwright for .NET, прочитайте sitekey из объекта mtcaptchaConfig страницы и передайте его в MtCaptchaAsync из пакета CapSkip NuGet. Полученный токен попадает в скрытое поле mtcaptcha-verifiedtoken, а щелчок отправляет форму. Вызов уходит в решатель капчи CapSkip для MTCaptcha на вашем собственном ПК с Windows. CapSkip сам читает искажённый текст, без платы за токен.
Что понадобится
- ПК с Windows и CapSkip 4.3.0 или новее: именно в этом выпуске появилась MTCaptcha. Чтобы запустить его, сначала прочитайте руководство по настройке.
- SDK .NET 8 или новее и два пакета NuGet: Microsoft.Playwright и CapSkip 1.7.0 или новее, в котором появился MtCaptchaAsync. Здесь установлен только SDK 10.0.100, поэтому я собирал под net10.0 и net8.0 с ним, используя CapSkip 1.7.0 и Playwright 1.64.1. Машина с одним SDK 8 не проверялась.
- Windows PowerShell 5.1 или новее и страница, которую вам разрешено автоматизировать, с виджетом MTCaptcha.
- Адрес для CapSkip. Режим Local отвечает только на 127.0.0.1. В режиме Server API доступен также в вашей сети или по публичному IP, с других машин. Какой из них вы получите, определяют Настройки подключения.
Результаты опираются на три вещи. Настоящее приложение CapSkip на этом ПК получило три задания: два для публичных значений демо-страницы 2Captcha и одно для этого sitekey на другом домене. В папке его сборки Release стоит 4.3.0, но подтвердить, что отвечал экземпляр именно этой сборки, я не смог. Chromium загружал демо-страницу только для чтения, и ни один токен ни на какой сайт не отправлялся. Моя имитация изображает in.php, res.php и сайт с входом, с моими собственными правилами формы. Настоящий сайт не проверялся.
Шаг 1: настройка проекта и загрузка браузера
Пакет NuGet не содержит браузера. Сборка записывает playwright.ps1 в выходную папку, поэтому сначала соберите проект, затем запустите скрипт. Об установке браузеров в документации Playwright команда записана через pwsh, то есть PowerShell 7. На моём ПК только Windows PowerShell 5.1, и скрипт выполнялся там с обходом политики выполнения.
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 запуск завершается необработанным PlaywrightException, Executable doesn’t exist.
Удалите всё в Program.cs, включая строку Console.WriteLine из шаблона. Затем вставьте блоки шагов 2, 3 и 4 в этом порядке и пропустите фрагмент Proxy. Строки using есть только в первом блоке, поэтому программа заработает, когда добавлен последний блок.
Шаг 2: чтение конфига страницы и вызов MtCaptchaAsync
Страница задаёт sitekey в переменной скрипта с именем mtcaptchaConfig, и тот же объект может нести action. Переменная классического скрипта является свойством window, поэтому Playwright может прочитать её из загруженной страницы без разбора HTML.
На демо-странице 2Captcha window.mtcaptchaConfig был undefined, когда GotoAsync возвращал управление, в 16 загрузках из 16 (два запуска только для чтения), и появлялся от 0.3 до 1.8 секунды позже, поэтому код его ожидает. Моя имитация строит его через 1.5 секунды после загрузки, и при удалённой строке ожидания программа остановилась с PlaywrightException с текстом Cannot read properties of undefined. Код читает два ключа, sitekey и action, и при отсутствии action подставляет пустую строку. У объекта демо-страницы был sitekey, не было action и был массив renderQueue, который добавляет виджет.
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, поскольку это то место, где находится браузер после любых перенаправлений. SDK отбрасывает пустой параметр, и имитация не увидела поля action для страницы, которая его не задаёт. Ответ проверки в руководстве MTCaptcha по проверке токена несёт action, с которым запущена капча, так что сайт может его сравнить: отправляйте тот, что задаёт ваша страница. Ведущий sk= убирается. Параметр userAgent задаёт User-Agent, который CapSkip предъявляет MTCaptcha, а в документации API сказано, что без него используется строка Chrome для Windows. Параметр proxy показан во фрагменте ниже.
// 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, и в Code. На настоящем приложении он начинался с v1( и имел 394 символа, а UserAgent и RespKey были null. Время от вызова до возврата: настоящее приложение (сборка Release 4.3.0, запущенная версия не подтверждена, Windows, 2 запуска) потратило 3.85 и 3.88 секунды. SDK опрашивает на 0, 0.25, 0.75, 1.75 и 3.75 секунды, затем удваивает интервал. Значит, токен пришёл на пятом опросе (выведено по времени, не записано в журнал), а решение завершилось примерно между 1.8 и 3.8 секунды.
Перед отправкой чего-либо SDK проверяет переданное. Девять неверных вызовов (пустой sitekey, sitekey без префикса, с пробелом или в 65 символов, относительный, ftp или отсутствующий адрес страницы, неподдерживаемый параметр и proxytype GOPHER) были отклонены с ValidationException, и имитация ничего не получила. Настоящее приложение отклонило те же виды входных данных в моих сырых запросах с ERROR_BAD_PARAMETERS, ERROR_PAGEURL и ERROR_PROXY_FORMAT.
MTCaptcha использует defaultTimeout, 120 секунд, потому что для решения браузер не запускается. 300-секундный recaptchaTimeout не применяется: заданный равным 3 на имитации без готового токена, он ничего не сделал, а ожидание закончил мой бюджет в 8 секунд. При defaultTimeout, равном 5, CapSkip TimeoutException пришёл примерно через 8 секунд после вызова (7.86 на net10.0, 7.88 и 8.42 в двух запусках net8.0), потому что SDK спит до следующего опроса и выбрасывает исключение, когда этот опрос выпадает на момент после крайнего срока.
Все исключения SDK наследуют CapSkipError. ApiException несёт весь ответ как своё сообщение, например {"status":0,"request":"ERROR_RECAPTCHA_INVALID_DOMAIN"}, который настоящее приложение вернуло через 0.33 секунды для демо-sitekey на example.com. NetworkException означает, что сам запрос не удался: по этому хосту и порту никто не ответил, ответом был не HTTP 200 или вызов был отменён. Опрос его повторяет, поэтому когда имитацию убили посреди опроса, вызов закончился TimeoutException, а не NetworkException. Playwright добавляет три ловушки. Неявные using импортируют System, где тоже есть TimeoutException, поэтому голый TimeoutException рядом с using CapSkip завершается ошибкой CS0104, и первый блок задаёт для класса SDK псевдоним SolverTimeout. Собственные тайм-ауты Playwright сообщает как System.TimeoutException, и в шаге 4 он перехватывается под полным именем. Обе библиотеки также определяют класс Proxy, поэтому во фрагменте стоит CapSkip.Proxy.
Ни один метод Playwright для .NET не принимает CancellationToken, и каждый ждёт по умолчанию 30 секунд, поэтому токен охватывает только вызовы CapSkip. На имитации бюджет в 2 секунды, истёкший, пока in.php висел, проявился как NetworkException, оборачивающий TaskCanceledException, а истёкший во время опроса как простой TaskCanceledException, оба примерно через 2 секунды.
Шаг 3: заполнение скрытого поля и отправка
Поле токена скрыто, а FillAsync ждёт видимого: на моей странице-имитации он прождал все 30 секунд и выбросил System.TimeoutException. Поэтому блок задаёт значение внутри страницы через EvaluateAsync, а RunAndWaitForResponseAsync возвращает статус отправки формы.
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"));
}
}Что делает виджет с полем, которое вы заполнили сами? На демо-странице 2Captcha Chromium 156.0.8078.4 нашёл в форме один скрытый input с именем mtcaptcha-verifiedtoken, пустой, пока посетитель не пройдёт проверку. Я задал ему заглушку и подождал 8 секунд. Значение осталось, а виджет не отправил MTCaptcha никакого запроса. Его метод getVerifiedToken по-прежнему возвращал пустую строку, так что виджет не читает поле обратно. Я не нажимал Check и не вставлял настоящий токен на этой странице, поэтому что делает её сервер с таким значением, не проверено. MTCaptcha документирует verified-callback, который срабатывает, когда виджет проверяет посетителя, а демо-страница его не регистрирует, поэтому страница, кнопка которой его ждёт, не проверена.
Шаг 4: MTCaptcha на C# от начала до конца
Main идёт последним. Измените PageUrl (в том виде, как вставлен, он запрашивает example.com, где виджета нет), затем запустите программу командой dotnet run. Каждая попытка получает собственный контекст браузера, поэтому сайт видит новую сессию. Ответ формы ниже 400 завершает прогон, отклонённая форма или ERROR_CAPTCHA_UNSOLVABLE обходится новой попыткой, а любая другая ошибка CapSkip завершает его.
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;
}
}Эти строки показывают результаты на имитации, которые ничего не говорят о настоящем сайте, и они были одинаковыми на net10.0 и net8.0.
| Настройка имитации | Что сделала программа |
|---|---|
| По умолчанию, страница задаёт action login | 200 Signed in, action в in.php. Страница без action не отправила ничего |
| Первая отправка формы получила от сайта 403 | Вторая попытка в новом контексте с новым заданием, затем 200 |
| Токен истёк к моменту прихода формы | Три строки 403, код выхода 1 |
| ERROR_RECAPTCHA_INVALID_SITEKEY или ERROR_RECAPTCHA_INVALID_DOMAIN | Ответ, код выхода 1, одно задание, без повтора |
Частые ошибки
| Что вы видите | Причина | Исправить |
|---|---|---|
| ValidationException | SDK отклонил вызов локально: неверный sitekey, адрес страницы, не являющийся абсолютным URL с http или https, или параметр, которого нет в API MTCaptcha | Исправьте аргумент. Повтор не поможет |
| ERROR_RECAPTCHA_INVALID_SITEKEY или ERROR_RECAPTCHA_INVALID_DOMAIN | MTCaptcha не знает sitekey (только на имитации) или он не разрешён для домена этой страницы (настоящее приложение, example.com) | Заново прочитайте sitekey и адрес страницы со страницы. Не повторяйте |
| ERROR_CAPTCHA_UNSOLVABLE | CapSkip не прошёл проверку (документация API; вызвать это на настоящем приложении мне не удалось) | Main отправляет новое задание |
| CapSkip TimeoutException | Токен не пришёл за defaultTimeout. Исключение выбрасывается, когда подходит первый опрос после крайнего срока, поэтому срок в 5 секунд заканчивается примерно на 8 секундах | Увеличьте defaultTimeout |
| Форма отклоняет токен | В руководстве по проверке токена перечислены token-expired (обычно 120 секунд), token-duplicate-cal и privatekey-mismatch-token (другой sitekey) | Запрашивайте токен непосредственно перед отправкой, используйте его один раз и сохраняйте sitekey и action страницы |
Режим Server: CapSkip на другом ПК
В режиме Server CapSkip слушает ваш сетевой адрес или публичный IP, поэтому эта программа может работать на другом ПК, пока решатель остаётся на машине с Windows, которую вы контролируете. Подставьте адрес сервера вместо host в строке CapSkipClient, и больше ничего не меняется.
Запуск режима Server открывает порт CapSkip для всех адресов. Добавьте блокирующее правило Windows Firewall для адресов, от которых вы не ждёте обращений, и включите API Key Validation с apiKey в строке CapSkipClient.
FAQ
Где искать sitekey, если на странице нет mtcaptchaConfig?
В адресе iframe виджета, с service.mtcaptcha.com. На демо-странице он нёс параметр sitekey со значением из конфига.
Нужен ли Playwright, чтобы решать MTCaptcha на C#?
Нет. CapSkip не запускает браузер для решения, а Playwright здесь потому, что страница из примера строит свой конфиг в скрипте. Обычная отправка формы несёт то же поле mtcaptcha-verifiedtoken, и статья о hCaptcha на C# показывает этот путь с HttpClient.
Почему сайт может отклонить полученный мной токен?
Три причины отказа из руководства по проверке токена таковы: токен уже проверялся, срок токена истёк (обычно через 120 секунд) или токен получен для другого sitekey. Сайт должен также сравнивать action. Настоящего сайта у меня не было, поэтому ранжировать эти причины я не могу.
MTCaptcha на C# сводится к чтению mtcaptchaConfig, одному вызову MtCaptchaAsync и скрытому полю, заполненному прямо перед щелчком. CapSkip по фиксированной лицензии даёт распознавание капчи на вашем собственном ПК, поэтому отклонённая форма стоит лишь ещё одной попытки. Другие типы CAPTCHA для .NET смотрите на странице сервиса распознавания капчи для C#. Чтобы посмотреть, как виджет проходит проверку, откройте демо MTCaptcha, а о формате сырых запросов читайте здесь: Документация API.
