Решение Cloudflare Turnstile через API

Cloudflare Turnstile — альтернатива CAPTCHA от Cloudflare: вместо заданий с картинками она проверяет посетителя по сигналам браузера и оценке риска. У виджета три режима. Managed (рекомендуемый): Cloudflare сам выбирает между неинтерактивной проверкой и чекбоксом по уровню риска посетителя. Non-interactive: видимый виджет с индикатором загрузки, который никогда не требует действий. Invisible: виджета на странице нет совсем. CapMonster Cloud обрабатывает все три режима автоматически, поэтому указывать режим в задаче не нужно.

Нет. TurnstileTask работает без прокси, а поля прокси (proxyType, proxyAddress, proxyPort, proxyLogin, proxyPassword) необязательны. Прокси с той же географией, что и целевой сайт, может улучшить результат на страницах, чувствительных к региону, поэтому стоит проверить оба варианта. Прозрачные прокси и прокси на локальных машинах не допускаются. Без собственного прокси CapMonster Cloud решает задачу через встроенные прокси (IP-адрес 65.21.190.34).

Откройте DevTools, найдите элемент с атрибутом data-sitekey (и data-action, если страница задаёт действие) и скопируйте значения; ключ сайта Turnstile выглядит так: 0x4AAAAAAABUYP0XeMJF0xoy. Некоторые значения меняются при каждой загрузке страницы, поэтому извлекайте их непосредственно перед созданием задачи. Пошаговая инструкция — в разделе выше.

cf-turnstile-response — скрытое поле формы, в котором хранится токен Turnstile. Токен действует 300 секунд (5 минут) и проверяется только один раз; после этого Siteverify возвращает ошибку timeout-or-duplicate. Отправляйте токен от CapMonster Cloud сразу и запрашивайте новый для каждой отправки формы.

Чтобы подставить токен Turnstile, найдите скрытое поле ответа (элемент input с именем cf-turnstile-response) и запишите в него токен, полученный от CapMonster Cloud. Ниже — как это сделать в трёх фреймворках автоматизации.

Playwright / Puppeteer (Node.js):

javascript

const token = "YOUR_TOKEN";
await page.evaluate((t) => {
  document.querySelector('[name="cf-turnstile-response"]').value = t;
}, token);
await page.click('#submit-btn');

Selenium (Python):

javascript

token = "YOUR_TOKEN"
driver.execute_script("document.querySelector('[name=\"cf-turnstile-response\"]').value = arguments[0];", token)
driver.find_element("id", "submit-btn").click()

Если форма проверяет токен через функцию обратного вызова (атрибут data-callback виджета), вызовите эту функцию с токеном.

Используйте тестовые ключи Cloudflare. На клиенте укажите sitekey 1x00000000000000000000AA (всегда проходит), 2x00000000000000000000AB (всегда не проходит) или 3x00000000000000000000FF (всегда показывает интерактивную проверку); на сервере — тестовый секретный ключ, например 1x0000000000000000000000000000000AA. Тестовые sitekey работают на любом домене, включая localhost, и выдают токен XXXX.DUMMY.TOKEN.XXXX, который принимают только тестовые секретные ключи. Полный список — в разделе тестирования выше.

Siteverify возвращает success: false, если токену больше 300 секунд, он уже был проверен или секретный ключ неверный. Ваш сервер также может отклонить токен, если hostname или action в ответе не совпадают с ожидаемыми. Проверьте массив error-codes в ответе и таблицу кодов ошибок Siteverify. Запрашивайте новый токен для каждой отправки и отправляйте его сразу после получения.