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. Смысл у всех один: токен до сервера не дошёл.

Что такое поле cf-turnstile-response
- На странице показан виджет Turnstile: блок
divс классомcf-turnstileи атрибутомdata-sitekey. - Когда проверка пройдена, Turnstile записывает токен в скрытое поле
cf-turnstile-responseвнутри формы. Если сайт задал атрибутdata-response-field-name, поле называется так, как указано в нём. - Форма отправляется вместе с токеном.
- Сервер сайта отправляет токен в 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:
<div class="cf-turnstile" data-sitekey="0x4AAAAAAAxxxxxxxxxxxxxx" data-callback="onTurnstileSuccess"></div>Значение data-sitekey и есть ключ сайта. Если виджет создаётся из JavaScript, ищите в скриптах turnstile.render и параметр sitekey.
Как исправить в автоматизации
Если форму отправляет скрипт, автотест или ИИ-агент, виджет может так и не получить токен сам. Токен можно получить через API Cap.Guru и вставить в форму.
1. Получить токен
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 минут и только один раз:
// Выполнить на странице (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:
await solver.solveTurnstileToken();То же самое для ИИ-ассистентов вроде Claude и Cursor делает MCP-сервер.
Ошибка не исчезла?
- Токен в поле есть, но сайт всё равно пишет, что он нужен. Возможно, сайт читает токен из другого поля. Проверьте атрибут
data-response-field-nameу виджета и сам запрос на вкладке Network в инструментах разработчика. - Ошибка появляется при каждой второй отправке. Токен использовали повторно. Получайте новый на каждую отправку.
- Токен отклоняется как недействительный. Проверьте, что вы передали ключ сайта и точный адрес страницы с формой, а не другой страницы.