Логотип «2Captcha»Перейти на главную страницу
Туториалы по обходу капчи

Эта статья была полезной?

Как решить капчу CaptchaFox на сайте signup.mail.com

Катя Пушкаренва

Технический специалист

Введение

Если вы интегрируете автоматическое решение капчи CaptchaFox для mail.com и сталкиваетесь с отклонением токенов из‑за отсутствия префикса MAM_, это руководство для вас.

Сервис 2Captcha поддерживает решение CaptchaFox через API v2 с параметром apiServer. Это критично для сайтов с кастомной инфраструктурой, где формат токена зависит от источника виджета.

Материал содержит общие рекомендации по настройке запросов, анализу страницы и отладке интеграции на примере mail.com.

Общие сведения

CaptchaFox — токенизированная система защиты с интерактивными задачами (чаще слайдеры) и поведенческим анализом. Для mail.com используется кастомная версия с собственным API-сервером, что влияет на формат возвращаемого токена.

Особенности CaptchaFox для mail.com

Параметр Значение Примечание
apiServer https://s.uicdn.com/mampkg/@mamdev/core.frontend.libs.captchafox/ Обязателен для получения токена с префиксом MAM_
websiteKey sk_ILKWNruBBVKDOM7dZs50WPNUuCUKR Постоянное значение для домена mail.com
Формат токена MAM_xxxxxxxx... Без префикса токен отклоняется сервером mail.com
Challenge endpoint POST https://mam-api.captchafox.com/captcha/sk_.../challenge Используется внутри виджета
Verify endpoint POST https://mam-api.captchafox.com/captcha/verify Финальная валидация токена

Почему параметр apiServer критичен

Если не указать apiServer или передать неверное значение, воркеры 2Captcha используют дефолтный эндпоинт https://cdn.captchafox.com/. В результате возвращается стандартный токен без префикса MAM_, который mail.com отклоняет с ошибкой HTTP 424.

Подготовка окружения

Перед началом работы убедитесь, что у вас есть:

  • Доступ к API 2Captcha — API-ключ из личного кабинета
  • Резидентный прокси — с геолокацией, соответствующей целевому сайту (для mail.com: GB, DE или US)
  • Актуальный User-Agent — строка из реального браузера, от имени которого идёт запрос
  • Инструменты для отладки — браузер с DevTools, клиент для HTTP-запросов (curl, Postman, библиотека на вашем языке)

Требования к прокси

Требование Описание
Тип Резидентный (residential) или мобильный
Протокол HTTP/HTTPS
Геолокация Соответствует целевому сайту (mail.com)
Аутентификация По логину/паролю или по IP
Стабильность Минимальное время отклика, отсутствие частых разрывов

Анализ страницы и извлечение параметров

Определение наличия капчи

На странице регистрации https://signup.mail.com капча CaptchaFox отображается при создании нового аккаунта. Визуально — это слайдер с логотипом CaptchaFox.

Поиск websiteKey

  1. Откройте DevTools (F12) на целевой странице
  2. Перейдите во вкладку "Elements" или "Sources"
  3. Найдите скрипт, подключающий CaptchaFox, или выполните поиск по sk_

Пример тега:

html Copy
<script src="https://s.uicdn.com/mampkg/@mamdev/core.frontend.libs.captchafox/api.js?key=sk_ILKWNruBBVKDOM7dZs50WPNUuCUKR"></script>

Значение параметра key — это ваш websiteKey.

Анализ сетевых запросов

  1. Во вкладке "Network" отфильтруйте запросы по captchafox
  2. Найдите запросы к challenge или verify
  3. Зафиксируйте:
    • Полный URL эндпоинта
    • Заголовки запроса (особенно User-Agent, Origin, Referer)
    • Структуру тела запроса и ответа

Эти данные помогут корректно сформировать задачу для 2Captcha.

Реализация

Структура задачи CaptchaFoxTask

Задача отправляется методом createTask на эндпоинт https://api.2captcha.com/createTask.

Обязательные поля задачи:

Поле Тип Описание
type String Всегда CaptchaFoxTask
websiteURL String URL страницы, где отображается капча
websiteKey String Ключ виджета, извлечённый из исходного кода
apiServer String URL кастомного API-сервера (обязателен для mail.com)
userAgent String Строка User-Agent браузера
proxyType String Тип прокси: http, https, socks4, socks5
proxyAddress String IP-адрес или хост прокси
proxyPort Integer Порт прокси
proxyLogin String Логин для аутентификации прокси (если требуется)
proxyPassword String Пароль для аутентификации прокси (если требуется)

Пример тела запроса (JSON)

json Copy
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "CaptchaFoxTask",
    "websiteURL": "https://signup.mail.com",
    "apiServer": "https://s.uicdn.com/mampkg/@mamdev/core.frontend.libs.captchafox/",
    "websiteKey": "sk_ILKWNruBBVKDOM7dZs50WPNUuCUKR",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36",
    "proxyType": "http",
    "proxyAddress": "1.2.3.4",
    "proxyPort": 8080,
    "proxyLogin": "login",
    "proxyPassword": "password"
  }
}

Получение результата

После создания задачи используйте метод getTaskResult для опроса статуса:

json Copy
{
  "clientKey": "YOUR_API_KEY",
  "taskId": 123456789
}

Возможные значения поля status:

Значение Описание
processing Задача в работе, продолжайте опрос
ready Решение готово, токен в поле solution.token
error Произошла ошибка, проверьте errorDescription

Проверка токена

После получения ответа всегда проверяйте:

  1. Наличие поля solution.token
  2. Наличие префикса MAM_ в начале токена
  3. Соответствие токена требованиям целевого сайта

Пример валидации (псевдокод):

Copy
если токен начинается с "MAM_":
    отправить токен на mail.com
иначе:
    залогировать ошибку и отправить reportIncorrect

Пояснения к параметрам

Параметр apiServer

  • Указывается как полный URL пути к JS-файлу или домену кастомного API
  • Для mail.com используйте: https://s.uicdn.com/mampkg/@mamdev/core.frontend.libs.captchafox/
  • Неправильное значение приводит к получению токена без префикса MAM_

Прокси и геолокация

  • Без прокси задача CaptchaFox не будет принята
  • Геолокация прокси должна соответствовать целевому сайту
  • Используйте резидентные прокси для минимизации риска блокировки

User-Agent

  • Должен соответствовать браузеру, от имени которого идёт запрос
  • Рекомендуется копировать актуальную строку из реального браузера
  • Несоответствие может привести к отклонению токена на стороне mail.com

Обратная связь по результатам решения

После проверки токена на целевом сайте рекомендуется отправить обратную связь.

Если сайт отклонил решение

Отправьте POST-запрос на эндпоинт reportIncorrect:

Эндпоинт: https://api.2captcha.com/reportIncorrect

Метод: POST

Content-Type: application/json

Пример запроса:

json Copy
{
   "clientKey": "YOUR_API_KEY",
   "taskId": 74455221488
}

Пример ответа:

json Copy
{
    "errorId": 0,
    "status": "success"
}

Важно: не используйте этот метод, если ваш процент успеха близок к 0%. Это может указывать на ошибку в вашем коде, а не в решениях капчи.

Если сайт принял решение

Отправьте POST-запрос на эндпоинт reportCorrect:

Эндпоинт: https://api.2captcha.com/reportCorrect

Метод: POST

Content-Type: application/json

Пример запроса:

json Copy
{
   "clientKey": "YOUR_API_KEY",
   "taskId": 74455221488
}

Пример ответа:

json Copy
{
    "errorId": 0,
    "status": "success"
}

Политика возвратов

  • Каждый случай рассматривается индивидуально
  • Для стандартных капч проверяется корректность ответа
  • Для капч с токеном анализируется статистика исполнителя
  • Возврат средств не гарантируется по каждой жалобе
  • Итоговая сумма возвратов может отличаться от количества обращений

Отправляйте отчёты честно и только после реальной проверки на целевом сайте.

Требования к кастомному apiServer

Если вы используете собственный сервер для CaptchaFox, убедитесь, что он соответствует следующим требованиям:

Требование Описание
SSL/TLS Сервер должен поддерживать HTTPS с валидным сертификатом
CORS Разрешите запросы с доменов, используемых воркерами 2Captcha
Заголовки Принимайте стандартные заголовки: User-Agent, Content-Type, Origin
Формат ответа Возвращайте JSON в формате, совместимом с оригинальным API CaptchaFox
Токен Генерируйте токены с префиксом MAM_ для совместимости с mail.com

Типичные ошибки и способы их устранения

Ошибка Возможная причина Решение
ERROR_CAPTCHA_UNSOLVABLE Некорректный apiServer или недоступность кастомного эндпоинта Проверьте URL apiServer, убедитесь в доступности сервера
Токен без префикса MAM_ apiServer не передан или воркер проигнорировал параметр Явно укажите полный путь к JS-файлу, используйте прокси той же геолокации
ERROR_PROXY_CONNECT Прокси не отвечает или требует аутентификации Проверьте данные прокси, протестируйте подключение отдельно
ERROR_WRONG_USERAGENT User-Agent устарел или не соответствует браузеру Используйте актуальную строку User-Agent из реального браузера
Таймаут при получении результата Медленное решение или перегрузка сервиса Увеличьте интервал опроса, добавьте логирование для анализа

Рекомендации по отладке

  • Включите детальное логирование запросов и ответов
  • Сохраняйте taskId для каждого запроса — это упростит обращение в поддержку
  • Тестируйте интеграцию в не-headless режиме перед запуском в продакшене
  • Проверяйте ответ целевого сайта после отправки токена

Дополнительные ресурсы

Контрольный список

  • Указан корректный apiServer: https://s.uicdn.com/mampkg/@mamdev/core.frontend.libs.captchafox/
  • websiteKey извлечён из исходного кода страницы
  • Прокси настроен и соответствует геолокации целевого сайта
  • User-Agent актуален и совпадает с браузерной сессией
  • В запросе присутствуют все обязательные поля: proxyType, proxyAddress, proxyPort
  • Полученный токен проверяется на наличие префикса MAM_
  • Включено логирование для отладки
  • Реализована отправка отчётов reportIncorrect / reportCorrect

Заключение

Корректная интеграция CaptchaFox для mail.com требует точной передачи параметра apiServer и соблюдения требований к прокси и User-Agent. При использовании кастомного API-сервера критически важно убедиться, что воркеры 2Captcha получают и используют указанный эндпоинт.

Параметр apiServer напрямую влияет на формат токена: только при правильном значении вы получите токен с префиксом MAM_, который принимает mail.com.

Не забывайте отправлять обратную связь через reportIncorrect и reportCorrect — это помогает улучшать качество сервиса и возвращать средства за ошибочные решения.

Автоматизируйте любые капчи с помощью API 2Captcha.