CaptchaFox

CaptchaFox — интерактивная капча, требующая прохождения браузерного челленджа. Сервис анализирует челлендж и возвращает токен, необходимый для обхода проверки, вместе с User-Agent решателя.

Обзор

• Встраивается как виджет на форме сайта
• Возвращает токен и User-Agent, которые нужно использовать вместе
• Требует прокси — обязателен для решения

Формат запроса

GET/in.php

keystringобязателен

Ваш API-ключ (32 символа)

methodstringобязателен

Значение: captchafox

pageurlstringобязателен

Полный URL страницы, где отображается CaptchaFox

sitekeystringобязателен

Сайткей со страницы (см. шаг 1)

proxystringобязателен

Обязателен. Формат: login:password@123.123.123.123:3128

proxytypestringобязателен

Тип прокси: HTTP, HTTPS, SOCKS4, SOCKS5

jsoninteger (0/1)по умолчанию: 0опционально

0 — ответ текстом, 1 — ответ JSON

Как решать капчу

Шаг 1. Найдите сайткей

Откройте вкладку Network в браузере и найдите запрос challenge. Сайткей — это часть URL между https://api.captchafox.com/captcha/ и /challenge.

Шаг 2. Отправьте задачу нам

cURL

curl -G "https://captcha-api.iwhat.pw/in.php" \
  -d key=YOUR_API_KEY \
  -d method=captchafox \
  -d sitekey=YOUR_SITEKEY \
  -d pageurl=https://example.com/page \
  -d proxy=user:password@111.111.111.111:8080 \
  -d proxytype=HTTP \
  -d json=1

Python

import requests

params = {
    'key': 'YOUR_API_KEY',
    'method': 'captchafox',
    'sitekey': 'YOUR_SITEKEY',
    'pageurl': 'https://example.com/page',
    'proxy': 'user:password@111.111.111.111:8080',
    'proxytype': 'HTTP',
    'json': '1'
}

response = requests.get('https://captcha-api.iwhat.pw/in.php', params=params)
result = response.json()
task_id = result['request']
print(f"ID задачи: {task_id}")

JavaScript

const params = new URLSearchParams({
  key: 'YOUR_API_KEY',
  method: 'captchafox',
  sitekey: 'YOUR_SITEKEY',
  pageurl: 'https://example.com/page',
  proxy: 'user:password@111.111.111.111:8080',
  proxytype: 'HTTP',
  json: '1',
});

const res = await fetch(`https://captcha-api.iwhat.pw/in.php?${params}`);
const { request: taskId } = await res.json();
console.log(`ID задачи: ${taskId}`);

Шаг 3. Получение решения

import time

time.sleep(15)

result = requests.get('https://captcha-api.iwhat.pw/res.php', params={
    'key': 'YOUR_API_KEY',
    'action': 'get',
    'id': task_id,
    'json': '1',
}).json()

if result['status'] == 1:
    token = result['request']
    user_agent = result['user_agent']
    print(f"Токен: {token}")
    print(f"User-Agent: {user_agent}")

Шаг 4. Используем данные

driver.execute_script(f'document.querySelector("[name=cf-fox-response]").value = "{token}";')
driver.find_element_by_tag_name('form').submit()

Формат ответа

JSON-ответ (при json=1):

{
  "status": 1,
  "request": "0zXpNq7WmVtRc3KdYoJ8sHfB1LaU9GnEkQ2iTmZ...",
  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)..."
}

Распространённые ошибки

Код	Описание
ERROR_WRONG_USER_KEY	Неверный формат API-ключа
ERROR_KEY_DOES_NOT_EXIST	Такого API-ключа не существует
ERROR_ZERO_BALANCE	Недостаточно средств на балансе
ERROR_PAGEURL	Отсутствует параметр pageurl
ERROR_WRONG_CAPTCHA_ID	Неверный sitekey
ERROR_BAD_PROXY	Прокси помечен как нерабочий
CAPCHA_NOT_READY	Решение ещё не готово, подождите 15 сек

Советы и рекомендации

• Прокси обязателен — без него задача не будет принята
• Используйте user_agent из ответа при отправке токена, иначе его могут отклонить