Notifica sull'uso dei cookie

Questo sito usa i cookies. I cookies si ricordano di te così possiamo fornirti un'esperienza e un servizio personalizzati.Scopri di più.

Bypassa captcha con Python

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.

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
OpzioneValore di defaultDescrizione
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
defaultTimeout120Timeout 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
recaptchaTimeout600Timeout in secondi per i reCAPTCHA. Definisce per quanto tempo il modulo prova a ricevere una risposta dal terminale API res.php
pollingInterval10Intervallo 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
Opzionevalore di defaultDescrizione
numeric0Definisce se il captcha contiene nnumeri o altri simboli a href='/api-docs#normal_post'>scopri di più sul documento API
minLength0Lunghezza minima della risposta
maxLength0Lunghezza massima della risposta
phrase0definisce se la risposta contiene più parole o no
caseSensitive0definisce se la risposta distingue le maiuscole dalle minuscole
calc0definisce 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
simpleCaptcha

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=..., ...)
textCaptcha

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=..., ...)
recaptchaV2

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=..., ...)
recaptchaV3

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=..., ...)
funCaptcha

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=..., ...)
geeTest

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=..., ...)
hCaptcha

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=..., ...)
keyCaptcha

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=..., ...)
capy

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=..., ...)
grid

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=..., ...)
canvas

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=..., ...)
clickCaptcha

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=..., ...)
rotateCaptcha

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

Altri linguaggi per l'integrazione con il servizio API