Эта статья была полезной?
Как решить капчу 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
- Откройте DevTools (F12) на целевой странице
- Перейдите во вкладку "Elements" или "Sources"
- Найдите скрипт, подключающий CaptchaFox, или выполните поиск по
sk_
Пример тега:
html
<script src="https://s.uicdn.com/mampkg/@mamdev/core.frontend.libs.captchafox/api.js?key=sk_ILKWNruBBVKDOM7dZs50WPNUuCUKR"></script>
Значение параметра key — это ваш websiteKey.
Анализ сетевых запросов
- Во вкладке "Network" отфильтруйте запросы по
captchafox - Найдите запросы к
challengeилиverify - Зафиксируйте:
- Полный 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
{
"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
{
"clientKey": "YOUR_API_KEY",
"taskId": 123456789
}
Возможные значения поля status:
| Значение | Описание |
|---|---|
processing |
Задача в работе, продолжайте опрос |
ready |
Решение готово, токен в поле solution.token |
error |
Произошла ошибка, проверьте errorDescription |
Проверка токена
После получения ответа всегда проверяйте:
- Наличие поля
solution.token - Наличие префикса
MAM_в начале токена - Соответствие токена требованиям целевого сайта
Пример валидации (псевдокод):
если токен начинается с "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
{
"clientKey": "YOUR_API_KEY",
"taskId": 74455221488
}
Пример ответа:
json
{
"errorId": 0,
"status": "success"
}
Важно: не используйте этот метод, если ваш процент успеха близок к 0%. Это может указывать на ошибку в вашем коде, а не в решениях капчи.
Если сайт принял решение
Отправьте POST-запрос на эндпоинт reportCorrect:
Эндпоинт: https://api.2captcha.com/reportCorrect
Метод: POST
Content-Type: application/json
Пример запроса:
json
{
"clientKey": "YOUR_API_KEY",
"taskId": 74455221488
}
Пример ответа:
json
{
"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 режиме перед запуском в продакшене
- Проверяйте ответ целевого сайта после отправки токена
Дополнительные ресурсы
- Документация по CaptchaFox API v2
- Метод reportIncorrect — отчёт о неверном решении
- Метод reportCorrect — отчёт о верном решении
- Примеры кода на GitHub
- Обратиться в поддержку
Контрольный список
- Указан корректный 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.