NextCaptcha Solver Python SDK - Installazione, configurazione e utilizzo | Risolutore Captcha, servizio di bypass automatico Captcha

Python è un linguaggio di programmazione interpretato di alto livello. È noto per la sua semplicità e leggibilità. È un linguaggio versatile che può essere utilizzato per lo sviluppo web, l'analisi dei dati, l'intelligenza artificiale e altro ancora.

Integra il nostro pacchetto di risoluzione dei CAPTCHA Python per risolvere automaticamente i CAPTCHA su qualsiasi sito web.

Facile integrazione con l'API del servizio di risoluzione captcha per bypassare reCAPTCHA e risolvere qualsiasi altro CAPTCHA

Installazione

Installa NextCaptcha Python SDK con pip o manualmente

PIP

Per installare NextCaptcha Python SDK, puoi usare pip (consigliato) o installarlo manualmente.

1. Installa con pip (consigliato)#

Se l'SDK NextCaptcha è pubblicato su PyPI, puoi installarlo con:

pip install nextcaptcha-python

Oppure, se è ospitato su GitHub:

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

2. Installazione manuale#

Se disponi dell'SDK come file locale o archivio ZIP, segui questi passaggi:

Step 1: Scarica l'SDK#

Clonare il repository:

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

Scarica lo ZIP da GitHub, estrailo e vai alla cartella.

Installa localmente.#

pip install .

Oppure, se l'SDK non è strutturato come un pacchetto:

python setup.py install

Verifica installazione#

Esegui Python e verifica se il pacchetto viene importato correttamente:

import nextcaptcha
print(nextcaptcha.__version__)

Se riscontri problemi, assicurati di aver installato le dipendenze richieste con:

pip install -r requirements.txt

Configurazione

Configurare il NextCaptcha Python SDK con i parametri necessari

Configurazione di Solver SDK

Per configurare NextCaptcha Python SDK, dovrai impostare i seguenti parametri:

client_key: La tua chiave API da NextCaptcha
soft_id: Il tuo ID software (facoltativo)
callback_url: URL per ricevere risposte in modo asincrono (se si utilizza la modalità callback)
open_log: Abilita la registrazione per il debug

Esempio di configurazione#

Ecco come puoi configurare e utilizzare 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))

Spiegazione dei parametri#

Parametro	Descrizione
`client_key`	La tua chiave API NextCaptcha (obbligatoria)
`soft_id`	Il tuo ID software (facoltativo)
`callback_url`	Un URL a cui verranno inviati i risultati (facoltativo, solo per le attività asincrone)
`open_log`	Se `True`, abilita la registrazione per il debug

appunti#

Se si utilizza la modalità callback, la soluzione verrà inviata a `callback_url`, quindi non sarà necessario recuperare manualmente i risultati.
Se `open_log=True`, verranno stampati i log per facilitare il debug.
Assicurati di sostituire i segnaposto (`your_client_key_here`, ecc.) con le tue credenziali effettive.

Risolvi CAPTCHA

Risolvi reCAPTCHA v2/v3/Enterprise tramite metodo basato su token

Per risolvere reCAPTCHA v2, v3, Enterprise o la versione mobile utilizzando il metodo basato su token di NextCaptcha, segui questi passaggi:

1. Risolvi reCAPTCHA tramite metodo basato su token#

Utilizzare l'approccio basato su token per ottenere il token `g-recaptcha-response`.

Risolvi reCAPTCHA v2 con il metodo base del token#

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

Risolvi reCAPTCHA v2 Enterprise con il metodo basato sul token#

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

Risolvi reCAPTCHA v2 Enterprise con il metodo Token base a punteggio elevato#

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

Risolvi reCAPTCHA v3 o v3 Enterprise con il metodo basato sul token#

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

Risolvi reCAPTCHA v3 o v3 Enterprise con il metodo Token base a punteggio elevato#

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

Risolvi reCAPTCHA Mobile con il metodo basato sul token#

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

3. Usa il token#

Dopo aver ricevuto il token `g-recaptcha-response`, inseriscilo nel modulo del sito web e invialo.

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

Spiegazione dei parametri#

Parametro	Descrizione
`website_url`	L'URL del sito web in cui si trova il reCAPTCHA
`website_key`	La chiave del sito del reCAPTCHA
`page_action`	Il parametro di azione da utilizzare per il reCAPTCHA
`api_domain`	Il dominio dell'API reCAPTCHA se diverso da quello predefinito
`website_info`	Configurazione reCAPTCHA dettagliata su un sito web di destinazione

Note chiave#

✅ Supporti reCAPTCHA v2, v3, Enterprise e Mobile

✅ Proxyless la modalità è disponibile (utilizzare un proxy se il sito richiede IP specifici)

✅ Token-based metodo consente di aggirare il captcha senza problemi.

Altri metodi

Per controllare il saldo del tuo account NextCaptcha, utilizza il seguente metodo:

Ottieni un esempio di saldo#

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

Note chiave#

✅ Recupera il tuo saldo disponibile in USD.

✅ Assicurati che la tua chiave API sia valida per ottenere il saldo corretto.

Gestione degli errori

Se si verifica un errore durante la risoluzione di un captcha, l'SDK restituirà un dizionario contenente le informazioni sull'errore. Puoi controllare il campo di stato per determinare se la richiesta è andata a buon fine. Se lo stato è "pronto", il captcha è stato risolto con successo e la soluzione verrà fornita nel campo della soluzione. Se lo stato è "fallito", il campo di errore conterrà una descrizione dell'errore.

Id	Codice	Descrizione
0	-	non si è verificato alcun errore
1	`ERROR_KEY_DOES_NOT_EXIST`	La tua chiave API non è corretta, assicurati di averla configurata correttamente e copiala dalla modalità client o sviluppatore nel Pannello di controllo
10	`ERROR_ZERO_BALANCE`	Il saldo del tuo conto è pari a zero
11	`ERROR_IP_NOT_ALLOWED`	La richiesta è stata effettuata da un indirizzo IP non presente nell'elenco degli IP attendibili
12	`ERROR_CAPTCHA_UNSOLVABLE`	Il captcha non può essere risolto normalmente. Potrebbe incontrare un proxy o la soluzione non riesce per vari motivi di rete. In generale, puoi riprovare.
14	`ERROR_NO_SUCH_METHOD`	È stato richiesto un metodo che non esiste nell'API
15	`ERROR_IMAGE_TYPE_NOT_SUPPORTED`	Impossibile elaborare l'immagine perché il formato o la dimensione dell'immagine non sono corretti oppure l'immagine è danneggiata. Si prega di controllare l'immagine nella richiesta
16	`ERROR_NO_SUCH_CAPCHA_ID`	L'ID Captcha che hai fornito non è corretto
21	`ERROR_IP_BLOCKED`	Il tuo indirizzo IP è stato bannato a causa dell'uso inappropriato dell'API
22	`ERROR_TASK_ABSENT`	Non hai incluso l'attributo task nella chiamata al metodo createTask
23	`ERROR_TASK_NOT_SUPPORTED`	L'attributo task nella chiamata al metodo createTask contiene un tipo di attività non supportato dalla nostra API oppure l'attributo type non è corretto.
31	`ERROR_RECAPTCHA_INVALID_SITEKEY`	Il valore della chiave sito reCAPTCHA che hai fornito non è valido
55	`ERROR_ACCOUNT_SUSPENDED`	Il tuo account è stato sospeso a causa di un uso improprio dell'API. Collegati tramite il team di supporto di Telegram per risolvere questo problema
130	`ERROR_BAD_PROXY`	I parametri del proxy non sono corretti oppure non è possibile stabilire la connessione tramite il proxy
110	`ERROR_BAD_PARAMETERS`	Nella tua richiesta manca un parametro captcha obbligatorio oppure il formato del parametro non è corretto. Assicurati che il formato del payload della richiesta sia appropriato per il tipo di attività selezionato
500	`ERROR_UNKNOWN`	Errore sconosciuto. Potrebbe trattarsi di un errore imprevisto nel sistema. Puoi contattare l'amministratore che ha inviato l'errore per risolvere il problema.

Installazione

PIP

1. Installa con pip (consigliato)#

2. Installazione manuale#

Step 1: Scarica l'SDK#

Installa localmente.#

Verifica installazione#

Configurazione

Configurazione di Solver SDK

** Esempio di configurazione**#

Spiegazione dei parametri#

appunti#

Risolvi CAPTCHA

1. Risolvi reCAPTCHA tramite metodo basato su token#

Risolvi reCAPTCHA v2 con il metodo base del token#

Risolvi reCAPTCHA v2 Enterprise con il metodo basato sul token#

Risolvi reCAPTCHA v2 Enterprise con il metodo Token base a punteggio elevato#

Risolvi reCAPTCHA v3 o v3 Enterprise con il metodo basato sul token#

Risolvi reCAPTCHA v3 o v3 Enterprise con il metodo Token base a punteggio elevato#

Risolvi reCAPTCHA Mobile con il metodo basato sul token#

3. Usa il token#

Spiegazione dei parametri#

Note chiave#

Altri metodi

Ottieni un esempio di saldo#

Note chiave#

Gestione degli errori

Esempio di configurazione#