2captcha

2captcha — это CLI-инструмент для программного решения CAPTCHA через сервис 2Captcha с участием реальных людей. Поддерживает широкий спектр типов CAPTCHA и возвращает готовые токены для внедрения в целевые страницы.

Что делает этот инструмент

Инструмент отправляет CAPTCHA в сервис 2Captcha и получает решение в виде токена, который можно сразу использовать в автоматизации. Поддерживаются различные типы задач, включая изображения, reCAPTCHA, hCaptcha и другие популярные системы защиты.

• Image CAPTCHA
• reCAPTCHA v2 / v3
• hCaptcha
• Cloudflare Turnstile
• FunCaptcha (Arkose)
• GeeTest

Решение обычно занимает от 10 до 60 секунд в зависимости от сложности CAPTCHA. :

Когда использовать

• Автоматизация отправки форм с защитой reCAPTCHA
• Парсинг сайтов с hCaptcha или Turnstile
• Тестирование регистраций и логина с CAPTCHA в CI
• Массовое создание аккаунтов
• Разблокировка скриптов браузерной автоматизации

Установка

# Установка одной командой
curl -fsSL https://raw.githubusercontent.com/adinvadim/2captcha-cli/main/solve-captcha \
 -o /usr/local/bin/solve-captcha && chmod +x /usr/local/bin/solve-captcha

# Проверка
solve-captcha --version

Настройка

# Сохранение API-ключа
mkdir -p ~/.config/2captcha
echo "YOUR_API_KEY" > ~/.config/2captcha/api-key

# Или через переменную окружения
export TWOCAPTCHA_API_KEY="your-key"

Получить API-ключ можно на сайте 2Captcha.

Быстрый старт

Перед началом рекомендуется проверить баланс:

./solve-captcha balance

Примеры использования

Image CAPTCHA:

./solve-captcha image /path/to/captcha.png
./solve-captcha image "https://site.com/captcha.jpg"

reCAPTCHA v2:

./solve-captcha recaptcha2 --sitekey "KEY" --url "https://example.com"

hCaptcha:

./solve-captcha hcaptcha --sitekey "KEY" --url "URL"

Как извлечь параметры CAPTCHA

• Ищите data-sitekey в HTML
• Проверяйте iframe и сетевые запросы
• Анализируйте запросы к API CAPTCHA-сервисов

Типичный workflow автоматизации

• Обнаружить CAPTCHA на странице
• Извлечь параметры (sitekey, challenge)
• Отправить задачу через CLI
• Получить токен
• Вставить его в форму или вызвать callback

Пример внедрения токена

document.getElementById('g-recaptcha-response').value = token;

// или через callback
___grecaptcha_cfg.clients[0].callback(token);

Стоимость

• Image CAPTCHA — около $0.001 за решение
• reCAPTCHA / hCaptcha — около $0.003

Обработка ошибок

• ERROR_ZERO_BALANCE — недостаточно средств
• ERROR_NO_SLOT_AVAILABLE — повторить позже
• ERROR_CAPTCHA_UNSOLVABLE — невозможно решить
• ERROR_WRONG_CAPTCHA_ID — неверный ID задачи

Примечания

• Решение занимает 10–60 секунд
• reCAPTCHA v3 может требовать несколько попыток
• Некоторые сайты выявляют автоматизацию
• Токены действуют ограниченное время (2–5 минут)