Skip to content

Turnstile token required: что значит ошибка и как её исправить ​

Ошибка «Turnstile token required» означает, что форма отправлена без токена Cloudflare Turnstile. Сайт ждёт токен в поле cf-turnstile-response, но поле оказалось пустым или его не было, поэтому сервер отклонил запрос, ничего больше не проверяя.

Формулировка зависит от сайта: «Turnstile token required», «Turnstile token is required», «Please verify you are human» или код ошибки Cloudflare missing-input-response. Смысл у всех один: токен до сервера не дошёл.

Turnstile token required: форма без токена, API Cap.guru получает токен, токен вставляется в cf-turnstile-response

Что такое поле cf-turnstile-response ​

  1. На странице показан виджет Turnstile: блок div с классом cf-turnstile и атрибутом data-sitekey.
  2. Когда проверка пройдена, Turnstile записывает токен в скрытое поле cf-turnstile-response внутри формы. Если сайт задал атрибут data-response-field-name, поле называется так, как указано в нём.
  3. Форма отправляется вместе с токеном.
  4. Сервер сайта отправляет токен в Cloudflare (siteverify) и получает ответ «да» или «нет».

Ошибка появляется на шаге 3 или 4: поле пустое или токен в нём уже недействителен.

Почему токена нет или его не принимают ​

ПричинаЧто видноКак исправить
Форму отправили до окончания проверкиTurnstile token required, missing-input-responseДождаться, пока в cf-turnstile-response появится значение, и только потом отправлять
Токен не вставили в формуТо жеВставить токен в поле cf-turnstile-response той же формы
Токену больше 5 минутtimeout-or-duplicate, invalid-input-responseПолучать новый токен прямо перед отправкой
Токен уже использованtimeout-or-duplicateТокен действует один раз: на каждую отправку нужен новый
Токен выдан для другого ключа сайта или другой страницыinvalid-input-responseИспользовать data-sitekey и адрес той страницы, с которой отправляется форма
Сайт ждёт вызова callback, а не поле формыФорма остаётся заблокированной, кнопка неактивнаВызвать функцию из data-callback с токеном

Токен Turnstile действует 300 секунд (5 минут) и рассчитан на одну проверку. Его длина — до 2048 символов.

Как найти ключ сайта (sitekey) ​

Откройте код страницы (правой кнопкой → Просмотреть код страницы или вкладка Elements в инструментах разработчика) и найдите cf-turnstile или data-sitekey:

html
<div class="cf-turnstile" data-sitekey="0x4AAAAAAAxxxxxxxxxxxxxx" data-callback="onTurnstileSuccess"></div>

Значение data-sitekey и есть ключ сайта. Если виджет создаётся из JavaScript, ищите в скриптах turnstile.render и параметр sitekey.

Как исправить в автоматизации ​

Если форму отправляет скрипт, автотест или ИИ-агент, виджет может так и не получить токен сам. Токен можно получить через API Cap.Guru и вставить в форму.

1. Получить токен ​

python
import time
import requests

API_KEY = "ВАШ_API_КЛЮЧ"
SERVER = "https://api.cap.guru"   # за пределами России: https://api2.cap.guru


def get_turnstile_token(sitekey: str, pageurl: str) -> str:
    r = requests.get(f"{SERVER}/in.php", params={
        "key": API_KEY, "method": "turnstile",
        "sitekey": sitekey, "pageurl": pageurl, "json": 1,
    }).json()
    if r["status"] != 1:
        raise RuntimeError(r["request"])
    task_id = r["request"]

    for _ in range(36):                       # до 3 минут
        time.sleep(5)
        res = requests.get(f"{SERVER}/res.php", params={
            "key": API_KEY, "action": "get", "id": task_id, "json": 1,
        }).json()
        if res["status"] == 1:
            return res["request"]
        if res["request"] != "CAPCHA_NOT_READY":
            raise RuntimeError(res["request"])
    raise TimeoutError("Токен Turnstile не готов")

2. Вставить токен в форму и отправить ​

Токен нужно использовать в течение 5 минут и только один раз:

javascript
// Выполнить на странице (Playwright: page.evaluate, Selenium: execute_script)
(token) => {
  const field = document.querySelector('[name="cf-turnstile-response"]');
  if (field) field.value = token;

  const widget = document.querySelector('.cf-turnstile[data-callback]');
  const cb = widget && window[widget.dataset.callback];
  if (typeof cb === 'function') cb(token);
}

Затем отправьте форму как обычно.

Готовые модули ​

Писать это самому не обязательно. Модуль для Node.js одним вызовом находит ключ сайта, получает токен и вставляет его в поле и callback:

javascript
await solver.solveTurnstileToken();

То же самое для ИИ-ассистентов вроде Claude и Cursor делает MCP-сервер.

Ошибка не исчезла? ​

  • Токен в поле есть, но сайт всё равно пишет, что он нужен. Возможно, сайт читает токен из другого поля. Проверьте атрибут data-response-field-name у виджета и сам запрос на вкладке Network в инструментах разработчика.
  • Ошибка появляется при каждой второй отправке. Токен использовали повторно. Получайте новый на каждую отправку.
  • Токен отклоняется как недействительный. Проверьте, что вы передали ключ сайта и точный адрес страницы с формой, а не другой страницы.

Связанные страницы ​