Обход капчи на Java

Используйте библиотеку Java для быстрого распознавания и обхода капчи. Сервис предоставляет простой API для решения капчи.

Пакет Java библиотек для простой интеграции с API сервиса решения капчи ruCaptcha для обхода recaptcha, hcaptcha, funcaptcha, geetest и решения любых других капч

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

Установка

Пакет скриптов можно установить с помощью установщика пакетов или вручную

Maven Central Repository

Артефакт 2captcha-java доступен в Maven Central

Примеры кода, а также библиотеки и модули для интеграции с нашим API вы также можете найти в репозитории на GitHub.

Конфигурация

Описание всех необходимых параметров для конфигурирования установленного пакета

Экземпляр класса TwoCaptcha можно создать вот так:

TwoCaptcha solver = new TwoCaptcha('YOUR_API_KEY');

Также у вас есть возможность настраивать некоторые опции созданного экземпляра:

solver.setSoftId(123);
solver.setCallback("https://your.site/result-receiver");
solver.setDefaultTimeout(120);
solver.setRecaptchaTimeout(600);
solver.setPollingInterval(10);
Опции экземпляра TwoCaptcha
ОпцияЗначение по умолчаниюОписание
softId-ваш id программного обеспечения, полученный после публикации в каталоге программ ruCaptcha
callback-URL вашего веб-сервера, который получает результат распознавания капчи. URL должен быть сначала зарегистрирован в настройках pingback вашей учетной записи
defaultTimeout120Таймаут опроса в секундах для всех типов капчи, кроме reCAPTCHA. Определяет, как долго модуль пытается получить ответ от конечной точки API res.php
recaptchaTimeout600Таймаут опроса reCAPTCHA в секундах. Определяет, как долго модуль пытается получить ответ от конечной точки API res.php
pollingInterval10Интервал в секундах между запросами к конечной точке API res.php, установка значений менее 5 секунд не рекомендуется
ВАЖНО: как только callback определен для одного экземпляра класса TwoCaptcha, все остальные методы возвращают только ID капчи и НЕ опрашивают API для получения результата. Результат будет отправлен на callback URL. Чтобы получить ответ вручную, используйте метод getResult

Решение капчи

Когда вы отправляете любую графическую капчу, вы можете передавать дополнительные параметры, которые помогут работникам ruCaptcha решить ее быстро и правильно.

Опции капчи
ОпцияЗначение по умолчаниюОписание
numeric0определяет, содержит ли капча числовые или другие символы, подробнее см. в документации по API
minLength0минимальная длина ответа
maxLength0максимальная длина ответа
phrase0определяет, содержит ли ответ несколько слов или нет
caseSensitive0определяет, чувствителен ли ответ к регистру
calc0определяет капчу, которая требует расчета
lang-определяет язык капчи, смотрите список поддерживаемых языков
hintImg-изображение с подсказкой, показанное работникам с помощью капчи
hintText-подсказка или текст задачи, показываемый работникам с помощью капчи

Базовый пример

В приведенном ниже примере показан базовый пример вызова распознавателя с обработкой ошибок.

Normal captcha = new Normal();
captcha.setFile("path/to/captcha.jpg");
captcha.setMinLen(4);
captcha.setMaxLen(20);
captcha.setCaseSensitive(true);
captcha.setLang("en");

try {
    solver.solve(captcha);
    System.out.println("Captcha solved: " + captcha.getCode());
} catch (Exception e) {
    System.out.println("Error occurred: " + e.getMessage());
}

Чтобы обойти обычную капчу (искаженный текст на изображении), используйте следующий метод. Этот метод также можно использовать для распознавания любого текста на изображении.

Normal captcha = new Normal();
captcha.setFile("path/to/captcha.jpg");
captcha.setNumeric(4);
captcha.setMinLen(4);
captcha.setMaxLen(20);
captcha.setPhrase(true);
captcha.setCaseSensitive(true);
captcha.setCalc(false);
captcha.setLang("en");
captcha.setHintImg(new File("path/to/hint.jpg"));
captcha.setHintText("Type red symbols only");

Этот метод можно использовать для обхода капчи, которая требует ответа на вопрос в виде открытого текста

Text captcha = new Text();
captcha.setText("If tomorrow is Saturday, what day is today?");
captcha.setLang("en");

Используйте этот метод для решения reCAPTCHA V2 и получения токена для обхода защиты

ReCaptcha captcha = new ReCaptcha();
captcha.setSiteKey("6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-");
captcha.setUrl("https://mysite.com/page/with/recaptcha");
captcha.setInvisible(true);
captcha.setAction("verify");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");

Этот метод позволяет обходить reCAPTCHA V3 и возвращает токен

ReCaptcha captcha = new ReCaptcha();
captcha.setSiteKey("6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-");
captcha.setUrl("https://mysite.com/page/with/recaptcha");
captcha.setVersion("v3");
captcha.setAction("verify");
captcha.setScore(0.3);
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");

Метод решения FunCaptcha (Аркоселабс). Возвращает токен для обхода капчи

FunCaptcha captcha = new FunCaptcha();
captcha.setSiteKey("69A21A01-CC7B-B9C6-0F9A-E7FA06677FFC");
captcha.setUrl("https://mysite.com/page/with/funcaptcha");
captcha.setSUrl("https://client-api.arkoselabs.com");
captcha.setUserAgent("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.61 Safari/537.36");
captcha.setData("anyKey", "anyValue");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");

Метод решения капчи головоломки GeeTest. Возвращает набор токенов в формате JSON

GeeTest captcha = new GeeTest();
captcha.setGt("f2ae6cadcf7886856696502e1d55e00c");
captcha.setApiServer("api-na.geetest.com");
captcha.setChallenge("12345678abc90123d45678ef90123a456b");
captcha.setUrl("https://mysite.com/captcha.html");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");

Используйте этот метод для решения hCaptcha. Возвращает токен для обхода капчи

HCaptcha captcha = new HCaptcha();
captcha.setSiteKey("10000000-ffff-ffff-ffff-000000000001");
captcha.setUrl("https://www.site.com/page/");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");

Метод решения KeyCaptcha на основе токенов

KeyCaptcha captcha = new KeyCaptcha();
captcha.setUserId(10);
captcha.setSessionId("493e52c37c10c2bcdf4a00cbc9ccd1e8");
captcha.setWebServerSign("9006dc725760858e4c0715b835472f22");
captcha.setWebServerSign2("2ca3abe86d90c6142d5571db98af6714");
captcha.setUrl("https://www.keycaptcha.ru/demo-magnetic/");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");

Токен-основанный способ обхода капчи Capy puzzle

Capy captcha = new Capy();
captcha.setSiteKey("PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v");
captcha.setUrl("https://www.mysite.com/captcha/");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");

Этот метод изначально назывался Old reCAPTCHA V2. Его можно использовать для обхода любого типа капчи, когда вы можете применить сетку к изображению и вам нужно щелкнуть определенные поля сетки. Возвращает количество ячеек сетки

Grid captcha = new Grid();
captcha.setFile("path/to/captcha.jpg");
captcha.setRows(3);
captcha.setCols(3);
captcha.setPreviousId(0);
captcha.setCanSkip(false);
captcha.setLang("en");
captcha.setHintImg(new File("path/to/hint.jpg"));
captcha.setHintText("Select all images with an Orange");

Метод Canvas можно использовать, когда вам нужно нарисовать линию вокруг объекта на изображении. Возвращает набор координат точек для рисования многоугольника.

Canvas captcha = new Canvas();
captcha.setFile("path/to/captcha.jpg");
captcha.setPreviousId(0);
captcha.setCanSkip(false);
captcha.setLang("en");
captcha.setHintImg(new File("path/to/hint.jpg"));
captcha.setHintText("Draw around apple");

Метод ClickCaptcha возвращает координаты точек на изображении капчи. Может использоваться, если вам нужно щелкнуть определенные точки на изображении.

Coordinates captcha = new Coordinates();
captcha.setFile("path/to/captcha.jpg");
captcha.setLang("en");
captcha.setHintImg(new File("path/to/hint.jpg"));
captcha.setHintText("Select all images with an Orange");

Этот метод можно использовать для решения капчи, которая просит повернуть объект. В основном используется для обхода FunCaptcha. Возвращает значение угла поворота.

Rotate captcha = new Rotate();
captcha.setFile("path/to/captcha.jpg");
captcha.setAngle(40);
captcha.setLang("en");
captcha.setHintImg(new File("path/to/hint.jpg"));
captcha.setHintText("Put the images in the correct way up");

Другие методы

Дополнительные допустимые методы применяемые в процессе работы основных скриптов

send / getResult

Этот метод можно использовать для ручной передачи капчи и получения ответов.

String captchaId = solver.send(captcha);

Thread.sleep(20 * 1000);

String code = solver.getResult(captchaId);

balance

Используйте этот метод, чтобы получить баланс своего аккаунта.

double balance = solver.balance();

report

Используйте этот метод, чтобы сообщить о правильном или неправильном решении капчи.

solver.report(captcha.getId(), true); // captcha solved correctly
solver.report(captcha.getId(), false); // captcha solved incorrectly

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

Возможные варианты стандартных ошибок возвращаемые сервисом при обработке запросов

В случае ошибки решатель капчи выдает исключение. Важно правильно обращаться с этими случаями. Мы рекомендуем использовать try/catch для обработки исключений

try {
    solver.solve(captcha);
} catch (ValidationException e) {
    // invalid parameters passed
} catch (NetworkException e) {
    // network error occurred
} catch (ApiException e) {
    // api respond with error
} catch (TimeoutException e) {
    // captcha is not solved so far
}

Другие языки для интеграции с API сервиса