Bypassa captcha con Python

Integra il pacchetto Python per risolvere il captcha automaticamente su qualsiasi sito.

Il pacchetto Python per integrare facilmente l'API di 2Captcha il servizio di risoluzione captcha per bypassare reCAPTCHA, hCaptcha, Arkose captcha, Geetest e risolvere tutti gli altri tipi di captcha.

Su GitHub sono pubblicati esempi di aggiramento di captcha utilizzando Python e Selenium. Il repository contiene script pronti all'uso per automatizzare i processi di risoluzione dei captcha, garantendo una facile integrazione nei progetti esistenti.

Avvio rapido

Installazione

Il pacchetto di script può essere installato manualmente o usando il programma di installazione del pacchetto

Pip

Per installare automaticamente un pacchetto libreria, bisogna usare la soluzione standard per i pacchetti Python - Pip. Scaricala al link e installala seguendo le istruzioni. Dopo aver installato l'applicazione, usa il comando:

pip3 install 2captcha-python

Vi invitiamo ad esplorare il nostro archivio GitHub nel quale potrete trovare le librerie e i moduli per integrare facilmente il nostro API.

Configurazione

Descrizione di tutti i parametri necessari per configurare il pacchetto installato

Un'istanza dell'ordine di TwoCaptcha può essere creata in questo modo:

from twocaptcha import TwoCaptcha

solver = TwoCaptcha('YOUR_API_KEY')

Hai anche la possibilità di personalizzare alcune delle opzioni per l'istanza:

config = {
            'server':           '2captcha.com',
            'apiKey':           'YOUR_API_KEY',
            'softId':            123,
            'callback':         'https://your.site/result-receiver',
            'defaultTimeout':    120,
            'recaptchaTimeout':  600,
            'pollingInterval':   10,
        }
solver = TwoCaptcha(**config)

Opzioni per istanza TwoCaptcha

Opzione	Valore di default	Descrizione
server	'2captcha.com'	Server API. Puoi impostarlo su 'rucaptcha.com' se il tuo account è registrato lì
softId	-	l'ID del tuo software è stata ottenuta dopo aver pubblicato su 2Captcha software catalog
callback	-	L'URL del tuo server che riceve il risultato del riconoscimento captcha. L'URL dovrebbe venire registrato sul tuo account nella sezione impostazioni pingback
defaultTimeout	120	Timeout in secondi per tutti i tipi di captcha eccetto i reCAPTCHA. Definisce per quanto tempo il modulo prova a ricevere una risposta dal terminale API `res.php`
recaptchaTimeout	600	Timeout in secondi per i reCAPTCHA. Definisce per quanto tempo il modulo prova a ricevere una risposta dal terminale API `res.php`
pollingInterval	10	Intervallo in secondi tra le richieste al terminale API `res.php`. Impostare un valore minore a 5 secondi non è consigliato

IMPORTANTE: una volta che il callback viene creato per l'istanza TwoCaptcha, tutti i metodi rimandano solo l'ID del captcha e NON interpellano l'API per avere il risultato. I risultati verranno mandati all'URL del callback. Per ricere le risposte manualmente usare getResult method

Risolvere i captcha

Quando invii qualsiasi captcha con un'immagine, puoi fornire opzioni aggiuntive per aiutare gli operatori di 2Captcha a risolverlo correttamente

Opzioni captcha

Opzione	valore di default	Descrizione
numeric	0	Definisce se il captcha contiene nnumeri o altri simboli a href='/2captcha-api#normal_post'>scopri di più sul documento API
minLength	0	Lunghezza minima della risposta
maxLength	0	Lunghezza massima della risposta
phrase	0	definisce se la risposta contiene più parole o no
caseSensitive	0	definisce se la risposta distingue le maiuscole dalle minuscole
calc	0	definisce se il captcha necessita di un calcolo
lang	-	definisce il linguaggio del captcha, guarda la lista dei linguaggi supportati
hintImg	-	un'immagine con il suggerimento mostrata agli operatori con il captcha
hintText	-	suggerimento o testo mostrato agli operatori con il captcha

Per bypassare un normal captcha (testo distorto in un'immagine) usa il metodo seguente. QUesta modalità può venire utilizzata anche per riconoscere il testo nell'immagine

result = solver.normal('path/to/captcha.jpg', param1=..., ...)

Questo metodo può essere usato per bypassare un captcha che richiede di rispondere ad una domanda di testo.

result = solver.text('If tomorrow is Saturday, what day is today?', param1=..., ...)

Usa questo metodo per risolvere i reCAPTCHA V2 e ottenere il token per bypassare la protezione.

result = solver.recaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
  url='https://mysite.com/page/with/recaptcha',
  param1=..., ...)

Questo metodo permette di risolvere il reCAPTCHA V3 e ricevere il token.

result = solver.recaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
  url='https://mysite.com/page/with/recaptcha',
  version='v3',
  param1=..., ...)

Metodo per risolvere FunCaptcha (Arkoselabs). In cambio viene dato un token.

result = solver.funcaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
  url='https://mysite.com/page/with/funcaptcha',
  param1=..., ...)

Metodo per risolvere un captcha puzzle GeeTest. In cambio viene dato un set di token come JSON.

result = solver.geetest(gt='f1ab2cdefa3456789012345b6c78d90e',
  challenge='12345678abc90123d45678ef90123a456b',
  url='https://www.site.com/page/',
  param1=..., ...)

Usa questo metodo per risolvere i hCaptcha. Viene dato un token per bypassare il captcha.

result = solver.hcaptcha(sitekey='10000000-ffff-ffff-ffff-000000000001',
  url='https://www.site.com/page/', 
  param1=..., ...)

Metodo basato su token per risolvere i KeyCaptcha.

result = solver.keycaptcha(s_s_c_user_id=10,
    s_s_c_session_id='493e52c37c10c2bcdf4a00cbc9ccd1e8',
    s_s_c_web_server_sign='9006dc725760858e4c0715b835472f22-pz-',
    s_s_c_web_server_sign2='2ca3abe86d90c6142d5571db98af6714',
    url='https://www.keycaptcha.ru/demo-magnetic/', 
    param1=..., ...)

Metodo basato su token per bypassare i captcha Capy Puzzle.

result = solver.capy(sitekey='PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v',
  url='http://mysite.com/',
  api_server='https://jp.api.capy.me/',
  param1=..., ...)

Il metodo Grid era in origine chiamato il metodo per i vecchi reCAPTCHA V2. Può essere usato per bypassare qualsiasi tipo di captcha nel quale bisogna applicare una griglia ad un'immagine e cliccare su specifiche sezioni di essa. In cambio vengono dati i numeri delle sezioni.

result = solver.grid('path/to/captcha.jpg', param1=..., ...)

Il metodo canvas può essere usato quando bisogna disegnare una linea intorno ad un oggetto o un'immagine. Riporta un set di coordinate di punti per disegnare un poligono.

result = solver.canvas('path/to/captcha.jpg', param1=..., ...)

Il metodo clickCaptcha riporta le coordinate di alcuni punti sull'immagine del captcha. Può essere usato se c'è bisogno di cliccaresu un particolare punto dell'immagine.

result = solver.coordinates('path/to/captcha.jpg', param1=..., ...)

Questo metodo può essere usato per risolvere un captcha che richiede di girare un oggetto. Viene usato principalmente per ricolvere i FunCaptcha. Riporta l'angolo di rotazione.

result = solver.rotate('path/to/captcha.jpg', param1=..., ...)

Altre modalità

Ulteriori metodi validi usati durante il lavoro degli script principali

send / getResult

Queste modalità possono essere utilizzate per inserire il captcha manualmente e rispondere ai sondaggi.

import time
. . . . . 

id = solver.send(file='path/to/captcha.jpg')
time.sleep(20)

code = solver.get_result(id)

balance

Usa questa modalità per accedere al saldo del tuo conto.

balance = solver.balance()

report

Usa questa modalità per segnalare una risposta captcha giusta o sbagliata.

solver.report(id, True) # captcha solved correctly
solver.report(id, False) # captcha solved incorrectly

Gestione degli errori

Possibili varianti di errori standard sperimentato dal servizio mentre processa le richieste

Nel caso in cui un risolutore di captcha si trovi davanti ad un errore, manda un segnale di eccezione. È importante gestire bene questi casi. Si raccomanda di usare try/catch per gestire le eccezioni.

Try:
    result = solver.text('If tomorrow is Saturday, what day is today?')
Except ValidationException as e:
    # invalid parameters passed
  print(e)
Except NetworkException as e:
  # network error occurred
  print(e)
Except ApiException as e:
  # api respond with error
  print(e)
Except TimeoutException as e:
  # captcha is not solved so far
  print(e)

Proxies

Puoi passare il tuo proxy come ulteriore gestione di: recaptcha, funcaptcha e geetest. Il proxy verrà mandato all'API per risolvere il captcha.

proxy={
    'type': 'HTTPS',
    'uri': 'login:password@IP_address:PORT'
}

Async calls

Puoi anche fare async calls con asyncio, ad esempio:

import asyncio
import concurrent.futures
from twocaptcha import TwoCaptcha

captcha_result = await captchaSolver(image)

async def captchaSolver(image):
    loop = asyncio.get_running_loop()
    with concurrent.future.ThreadPoolExecutor() as pool:
        result = await loop.run_in_executor(pool, lambda: TwoCaptcha(API_KEY).normal(image))
        return result

Bypassa captcha con Python

Installazione

Pip

Configurazione

Risolvere i captcha

Altre modalità

send / getResult

balance

report

Gestione degli errori

Proxies

Async calls

Altri linguaggi per l'integrazione con il servizio API

Pacchetto PHP per l'integrazione con il service API

Pacchetto Java per l'integrazione con il service API

Pacchetto C# per l'integrazione con il service API

Pacchetto Golang per l'integrazione con il service API

Pacchetto Ruby per l'integrazione con il service API

Pacchetto JavaScript per l'integrazione con il service API