NextCaptcha Solver Python SDK — установка, настройка и использование | Captcha Solver, автоматический обход Captcha Service

Python — это высокоуровневый интерпретируемый язык программирования. Он известен своей простотой и читабельностью. Это универсальный язык, который можно использовать для веб-разработки, анализа данных, искусственного интеллекта и многого другого.

Интегрируйте наш пакет решения капчи Python для автоматического решения капчи на любом веб-сайте.

Простая интеграция с API сервиса решения капчи для обхода reCAPTCHA и решения любой другой капчи

Установка

Установите NextCaptcha Python SDK с помощью pip или вручную

PIP

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

1. Установка с помощью pip (рекомендуется)#

Если NextCaptcha SDK опубликован на PyPI, вы можете установить его с помощью:

pip install nextcaptcha-python

Или, если он размещен на GitHub:

pip install git+https://github.com/nextcaptcha/nextcaptcha-python.git

2. Ручная установка#

Если у вас есть SDK в виде локального файла или ZIP-архива, выполните следующие действия:

Step 1: Загрузить SDK#

Клонируйте репозиторий:

git clone https://github.com/nextcaptcha/nextcaptcha-python.git
cd nextcaptcha-python

ИЛИ

Загрузите ZIP-файл с GitHub, распакуйте его и перейдите в папку.

Установить локально.#

pip install .

Или, если SDK не структурирован как пакет:

python setup.py install

Проверить установку#

Запустите Python и проверьте, правильно ли импортируется пакет:

import nextcaptcha
print(nextcaptcha.__version__)

Если у вас возникли какие-либо проблемы, убедитесь, что у вас установлены необходимые зависимости:

pip install -r requirements.txt

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

Настройте NextCaptcha Python SDK с необходимыми параметрами

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

Чтобы настроить NextCaptcha Python SDK, вам необходимо задать следующие параметры:

client_key: Ваш ключ API от NextCaptcha
soft_id: Ваш идентификатор программного обеспечения (необязательно)
callback_url: URL для получения ответов асинхронно (при использовании режима обратного вызова)
open_log: Включить ведение журнала для отладки

Пример конфигурации#

Вот как можно настроить и использовать NextCaptcha Python SDK:

from nextcaptcha import NextCaptchaAPI
 
# Configuration settings
config = {
    "client_key": "your_client_key_here",  # Replace with your NextCaptcha API key
    "soft_id": 12345,  # Your software ID (optional, replace if required)
    "callback_url": "https://your-callback-url.com",  # Callback URL (optional)
    "open_log": True  # Enable logging for debugging
}
 
# Initialize the NextCaptcha client
solver = NextCaptchaAPI(**config)
 
# Test request (example: solving a reCAPTCHA)
task = {
    "type": "ReCaptchaV2TaskProxyless",
    "websiteURL": "https://example.com",
    "websiteKey": "your_recaptcha_site_key"
}
 
# Send the task and get the result
try:
    task_id = solver.create_task(task)
    result = solver.get_result(task_id)
    print("Captcha solution:", result)
except Exception as e:
    print("Error:", str(e))

Объяснение параметров#

Параметр	Описание
`client_key`	Ваш ключ API NextCaptcha (обязательно)
`soft_id`	Ваш идентификатор программного обеспечения (необязательно)
`callback_url`	URL-адрес, на который будут отправлены результаты (необязательно, только для асинхронных задач)
`open_log`	Если `True`, включает ведение журнала для отладки.

примечания#

При использовании режима обратного вызова решение будет отправлено на `callback_url`, поэтому вам не придется извлекать результаты вручную.
Если `open_log=True`, будут распечатаны журналы для помощи в отладке.
Обязательно замените заполнители (`your_client_key_here` и т. д.) своими фактическими учетными данными.

Решить CAPTCHA

Решите reCAPTCHA v2/v3/Enterprise с помощью метода на основе токенов

Чтобы решить reCAPTCHA v2, v3, Enterprise или мобильную версию с помощью метода NextCaptcha на основе токенов, выполните следующие действия:

1. Решите reCAPTCHA с помощью метода на основе токенов#

Используйте подход на основе токенов для получения токена `g-recaptcha-response`.

Решите reCAPTCHA v2 с помощью метода Token Base#

 
# {props.t('solve6')}
 
result = api.recaptchav2(website_url="https://example.com", website_key="SITE_KEY")

Решите reCAPTCHA v2 Enterprise с помощью метода Token Base#

# {props.t('solve6')}
result = api.recaptchav2enterprise(website_url="https://example.com", website_key="SITE_KEY")

Решите reCAPTCHA v2 Enterprise с помощью метода с высоким баллом на основе токенов#

result = api.recaptchav2hs_enterprise(website_url="https://example.com", website_key="SITE_KEY")

Решите reCAPTCHA v3 или v3 Enterprise с помощью метода Token base#

result = api.recaptchav3(website_url="https://example.com", website_key="SITE_KEY")

Решите reCAPTCHA v3 или v3 Enterprise с помощью метода с высоким баллом Token base#

result = api.recaptchav3hs(website_url="https://example.com", website_key="SITE_KEY")

Решите reCAPTCHA Mobile с помощью метода Token Base#

result = api.recaptcha_mobile(app_key="APP_KEY", app_package_name="com.example.app", app_action="APP_ACTION", app_device="ios")

3. Используйте токен#

Получив токен `g-recaptcha-response`, введите его в форму веб-сайта и отправьте ее.

<input type="hidden" name="g-recaptcha-response" value="your_token_here" />

Объяснение параметров#

Параметр	Описание
`website_url`	URL-адрес веб-сайта, на котором расположена reCAPTCHA
`website_key`	Sitekey reCAPTCHA
`page_action`	Параметр действия, используемый для reCAPTCHA
`api_domain`	Домен API reCAPTCHA, если он отличается от домена по умолчанию
`website_info`	Подробная конфигурация reCAPTCHA о целевом веб-сайте

Ключевые заметки#

✅ Поддерживает reCAPTCHA v2, v3, Enterprise и Mobile

✅ Proxyless режим доступен (используйте прокси, если сайт требует определенные IP-адреса)

✅ Token-based Метод позволяет беспрепятственно обходить капчу.

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

Чтобы проверить баланс вашего счета NextCaptcha, используйте следующий метод:

Получить пример баланса#

# Get account balance
balance = api.get_balance()
print(f"Account balance: {balance}")

Ключевые заметки#

✅ Получает доступный баланс в долларах США.

✅ Убедитесь, что ваш ключ API действителен, чтобы получить правильный баланс.

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

Если при решении капчи возникает ошибка, SDK вернет словарь, содержащий информацию об ошибке. Вы можете проверить поле статуса, чтобы определить, был ли запрос успешным. Если статус «готов», капча была успешно решена, и решение будет предоставлено в поле решения. Если статус «не удалось», поле ошибки будет содержать описание ошибки.

Идентификатор	Код	Описание
0	-	никакой ошибки не произошло
1	`ERROR_KEY_DOES_NOT_EXIST`	Ваш ключ API неверен. Убедитесь, что вы настроили его правильно, и скопируйте его из режима клиента или разработчика в Панели управления.
10	`ERROR_ZERO_BALANCE`	Баланс вашего счета равен нулю
11	`ERROR_IP_NOT_ALLOWED`	Запрос был сделан с IP-адреса, которого нет в вашем списке доверенных IP-адресов.
12	`ERROR_CAPTCHA_UNSOLVABLE`	Капчу невозможно решить нормально. Он может столкнуться с прокси-сервером или решение не удастся по различным сетевым причинам. В общем, можно попробовать еще раз.
14	`ERROR_NO_SUCH_METHOD`	Был запрошен метод, которого нет в API.
15	`ERROR_IMAGE_TYPE_NOT_SUPPORTED`	Изображение невозможно обработать, так как его формат или размер неверны, либо изображение повреждено. Пожалуйста, проверьте изображение в вашем запросе
16	`ERROR_NO_SUCH_CAPCHA_ID`	Указанный вами идентификатор Captcha неверен.
21	`ERROR_IP_BLOCKED`	Ваш IP-адрес заблокирован из-за ненадлежащего использования API.
22	`ERROR_TASK_ABSENT`	Вы не включили атрибут задачи в вызов метода createTask.
23	`ERROR_TASK_NOT_SUPPORTED`	Атрибут задачи в вызове метода createTask содержит тип задачи, который не поддерживается нашим API, или атрибут типа неверен.
31	`ERROR_RECAPTCHA_INVALID_SITEKEY`	Указанное вами значение sitekey reCAPTCHA недействительно.
55	`ERROR_ACCOUNT_SUSPENDED`	Ваш аккаунт заблокирован из-за неправильного использования API. Пожалуйста, свяжитесь через службу поддержки Telegram, чтобы решить эту проблему.
130	`ERROR_BAD_PROXY`	Неверные параметры прокси или невозможно установить соединение через прокси
110	`ERROR_BAD_PARAMETERS`	В вашем запросе отсутствует обязательный параметр капчи или неверный формат параметра. Убедитесь, что формат полезных данных вашего запроса соответствует выбранному типу задачи.
500	`ERROR_UNKNOWN`	Неизвестная ошибка. Это может быть непредвиденная ошибка в системе. Вы можете обратиться к администратору, отправившему ошибку, для решения проблемы.

Установка

PIP

1. Установка с помощью pip (рекомендуется)#

2. Ручная установка#

Step 1: Загрузить SDK#

Установить локально.#

Проверить установку#

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

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

** Пример конфигурации**#

Объяснение параметров#

примечания#

Решить CAPTCHA

1. Решите reCAPTCHA с помощью метода на основе токенов#

Решите reCAPTCHA v2 с помощью метода Token Base#

Решите reCAPTCHA v2 Enterprise с помощью метода Token Base#

Решите reCAPTCHA v2 Enterprise с помощью метода с высоким баллом на основе токенов#

Решите reCAPTCHA v3 или v3 Enterprise с помощью метода Token base#

Решите reCAPTCHA v3 или v3 Enterprise с помощью метода с высоким баллом Token base#

Решите reCAPTCHA Mobile с помощью метода Token Base#

3. Используйте токен#

Объяснение параметров#

Ключевые заметки#

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

Получить пример баланса#

Ключевые заметки#

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

Пример конфигурации#