SDK de Python para el solucionador NextCaptcha: instalación, configuración y uso

Python es un lenguaje de programación interpretado de alto nivel. Es conocido por su simplicidad y legibilidad. Es un lenguaje versátil que puede utilizarse para desarrollo web, análisis de datos, inteligencia artificial y más.

Integre nuestro paquete de resolución de captcha de Python para resolver CAPTCHA automáticamente en cualquier sitio web.

Fácil integración con la API del servicio de resolución de captcha para omitir reCAPTCHA y resolver cualquier otro CAPTCHA

Instalación

Instalar NextCaptcha Python SDK con pip o manualmente

PIP

Para instalar el NextCaptcha Python SDK, puede usar pip (recomendado) o instalarlo manualmente.

1. Instalar con pip (recomendado)#

Si el SDK de NextCaptcha está publicado en PyPI, puedes instalarlo con:

pip install nextcaptcha-python

O, si está alojado en GitHub:

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

2. Instalación manual#

Si tiene el SDK como un archivo local o un archivo ZIP, siga estos pasos:

Step 1: Descargar el SDK#

Clonar el repositorio:

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

Descargue el ZIP de GitHub, extráigalo y navegue hasta la carpeta.

Instalar localmente.#

pip install .

O, si el SDK no está estructurado como un paquete:

python setup.py install

Verificar la instalación#

Ejecute Python y verifique si el paquete se importa correctamente:

import nextcaptcha
print(nextcaptcha.__version__)

Si encuentra algún problema, asegúrese de tener instaladas las dependencias necesarias con:

pip install -r requirements.txt

Configuración

Configurar el SDK de Python de NextCaptcha con los parámetros necesarios

Configuración del SDK de Solver

Para configurar el NextCaptcha Python SDK, deberá configurar los siguientes parámetros:

client_key: Su clave API de NextCaptcha
soft_id: Su ID de software (opcional)
callback_url: La URL para recibir respuestas de forma asincrónica (si se utiliza el modo de devolución de llamada)
open_log: Habilitar el registro para la depuración

Ejemplo de configuración#

A continuación se explica cómo configurar y utilizar el SDK de Python de NextCaptcha:

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))

Explicación de los parámetros#

Parámetro	Descripción
`client_key`	Su clave API de NextCaptcha (obligatoria)
`soft_id`	Su ID de software (opcional)
`callback_url`	Una URL donde se enviarán los resultados (opcional, solo para tareas asincrónicas)
`open_log`	Si es "Verdadero", habilita el registro para depuración

notas#

Si usa el modo de devolución de llamada, la solución se enviará a `callback_url`, por lo que no necesitará obtener los resultados manualmente.
Si `open_log=True`, se imprimirán registros para ayudar con la depuración.
Asegúrese de reemplazar los marcadores de posición (`your_client_key_here`, etc.) con sus credenciales reales.

Resolver CAPTCHA

Resuelva reCAPTCHA v2/v3/Enterprise mediante un método basado en tokens

Para resolver reCAPTCHA v2, v3, Enterprise o la versión móvil utilizando el método basado en token de NextCaptcha, siga estos pasos:

1. Resolver reCAPTCHA mediante un método basado en tokens#

Utilice el enfoque basado en token para obtener el token `g-recaptcha-response`.

Resuelva reCAPTCHA v2 con el método basado en tokens#

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

Resuelva reCAPTCHA v2 Enterprise con el método basado en tokens#

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

Resuelva reCAPTCHA v2 Enterprise con el método de token de alta puntuación#

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

Resuelva reCAPTCHA v3 o v3 Enterprise con el método basado en token#

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

Resuelva reCAPTCHA v3 o v3 Enterprise con el método de base de token de alta puntuación#

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

Resuelva reCAPTCHA Mobile con el método basado en tokens#

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

3. Utilice el token#

Después de recibir el token `g-recaptcha-response`, inyéctelo en el formulario del sitio web y envíelo.

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

Explicación de los parámetros#

Parámetro	Descripción
`website_url`	La URL del sitio web donde se encuentra el reCAPTCHA
`website_key`	La clave del sitio del reCAPTCHA
`page_action`	El parámetro de acción a utilizar para el reCAPTCHA
`api_domain`	El dominio de la API reCAPTCHA si es diferente del predeterminado
`website_info`	Configuración detallada de reCAPTCHA sobre un sitio web de destino

Notas clave#

✅ Soportes reCAPTCHA v2, v3, Enterprise y Mobile

✅ Proxyless El modo está disponible (use un proxy si el sitio requiere IP específicas)

✅ Token-based El método permite eludir el captcha sin problemas.

Otros métodos

Para consultar el saldo de su cuenta NextCaptcha, utilice el siguiente método:

Obtener ejemplo de saldo#

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

Notas clave#

✅ Recupera tu saldo disponible en USD.

✅ Asegúrese de que su clave API sea válida para obtener el saldo correcto.

Manejo de errores

Si se produce un error al resolver un captcha, el SDK devolverá un diccionario con la información del error. Puede consultar el campo de estado para determinar si la solicitud se ha realizado correctamente. Si el estado es "listo", el captcha se ha resuelto correctamente y la solución se proporcionará en el campo de solución. Si el estado es "fallido", el campo de error contendrá una descripción del error.

Identificación	Código	Descripción
0	-	no ocurrió ningún error
1	`ERROR_KEY_DOES_NOT_EXIST`	Su clave API es incorrecta. Asegúrese de haberla configurado correctamente y copiarla desde el modo cliente o desarrollador en el Panel de control.
10	`ERROR_ZERO_BALANCE`	El saldo de tu cuenta es cero.
11	`ERROR_IP_NOT_ALLOWED`	La solicitud se realizó desde una dirección IP que no está en su lista de IP confiables
12	`ERROR_CAPTCHA_UNSOLVABLE`	El captcha no se puede resolver normalmente. Es posible que encuentre un proxy o que la solución falle por diversos motivos de red. En general, puedes intentarlo de nuevo.
14	`ERROR_NO_SUCH_METHOD`	Se solicitó un método que no existe en la API
15	`ERROR_IMAGE_TYPE_NOT_SUPPORTED`	La imagen no se puede procesar porque el formato o tamaño de la imagen es incorrecto o la imagen está dañada. Por favor revisa la imagen en tu solicitud.
16	`ERROR_NO_SUCH_CAPCHA_ID`	El ID de Captcha que proporcionaste es incorrecto
21	`ERROR_IP_BLOCKED`	Su dirección IP ha sido prohibida debido a un uso inadecuado de la API
22	`ERROR_TASK_ABSENT`	No incluiste el atributo de tarea en la llamada al método createTask.
23	`ERROR_TASK_NOT_SUPPORTED`	El atributo de tarea en su llamada al método createTask contiene un tipo de tarea que no es compatible con nuestra API, o el atributo de tipo es incorrecto.
31	`ERROR_RECAPTCHA_INVALID_SITEKEY`	El valor de la clave del sitio reCAPTCHA que proporcionó no es válido
55	`ERROR_ACCOUNT_SUSPENDED`	Su cuenta ha sido suspendida debido al uso inadecuado de la API. Conéctese a través del equipo de soporte de Telegram para resolver este problema
130	`ERROR_BAD_PROXY`	Los parámetros del proxy son incorrectos o no se puede establecer la conexión a través del proxy
110	`ERROR_BAD_PARAMETERS`	Falta un parámetro captcha requerido en su solicitud o el formato del parámetro es incorrecto. Asegúrese de que el formato de carga útil de su solicitud sea apropiado para el tipo de tarea seleccionado.
500	`ERROR_UNKNOWN`	Error desconocido. Puede ser un error inesperado en el sistema. Puedes contactar con el administrador que envió el error para solucionar el problema.

Instalación

PIP

1. Instalar con pip (recomendado)#

2. Instalación manual#

Step 1: Descargar el SDK#

Instalar localmente.#

Verificar la instalación#

Configuración

Configuración del SDK de Solver

** Ejemplo de configuración**#

Explicación de los parámetros#

notas#

Resolver CAPTCHA

1. Resolver reCAPTCHA mediante un método basado en tokens#

Resuelva reCAPTCHA v2 con el método basado en tokens#

Resuelva reCAPTCHA v2 Enterprise con el método basado en tokens#

Resuelva reCAPTCHA v2 Enterprise con el método de token de alta puntuación#

Resuelva reCAPTCHA v3 o v3 Enterprise con el método basado en token#

Resuelva reCAPTCHA v3 o v3 Enterprise con el método de base de token de alta puntuación#

Resuelva reCAPTCHA Mobile con el método basado en tokens#

3. Utilice el token#

Explicación de los parámetros#

Notas clave#

Otros métodos

Obtener ejemplo de saldo#

Notas clave#

Manejo de errores

Ejemplo de configuración#