Notification de l'utilisation des cookies

Ce site utilise des cookies. Les cookies se souviennent de vous, afin que nous puissions vous fournir des services personnalisés. En savoir plus.

Contournement de captcha en Python

Contournement de captcha en Python

Intégrer le paquet Python pour résoudre automatiquement les captchas sur n'importe quel site.

paquet Python pour une intégration facile avec l'API de2Captcha service de résolution de captcha par contournement reCAPTCHA, hCaptcha, Arkose captcha, et résoudre tous les autres captchas

Démarrage rapide

Installation

Le paquet de scripts peut être installé à l'aide du programme d'installation des paquets ou manuellement.

Pip

Pour installer automatiquement un paquet de bibliothèques, vous devez utiliser la solution de paquetage standard de Python - Pip. Téléchargez-la depuis le lien et installez-la en suivant les instructions. Après l'installation de l'application, utilisez la commande :

pip3 install 2captcha-python

Nous vous invitons à explorer notre répertoire GitHub où vous trouverez des bibliothèques et des modules pour une intégration facile avec notre API.

Configuration

Description de tous les paramètres nécessaires pour configurer le paquet installé

Une instance de la classe TwoCaptcha peut être créée comme suit :

from twocaptcha import TwoCaptcha

solver = TwoCaptcha('YOUR_API_KEY')

Vous avez également la possibilité de personnaliser certaines des options de l'instance créée :

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)
Options de l'instance TwoCaptcha
OptionValeur par défautDescription
serveur'2captcha.com'Serveur API. Vous pouvez le définir sur 'rucaptcha.com' si votre compte y est enregistré.
softId-votre ID de logiciel obtenu après publication dans 2Captcha le catalogue de logiciel
rappel-L'URL de votre web-sever qui reçoit le résultat de la reconnaissance du captcha. L'URL doit d'abord être enregistrée dans pingback settings de votre compte.
defaultTimeout120Délai d'attente d'interrogation en secondes pour tous les types de captcha sauf reCAPTCHA. Définit la durée pendant laquelle le module essaie d'obtenir la réponse du point de terminaison de l'API res.php
recaptchaTimeout600Délai d'interrogation pour reCAPTCHA en secondes. Définit combien de temps le module essaie d'obtenir la réponse du res.php endpoint API.
pollingInterval10Intervalle en secondes entre les requêtes au point de terminaison de l'API res.php, la définition de valeurs inférieures à 5 secondes n'est pas recommandée.
IMPORTANT: une fois rappel est défini pour TwoCaptcha l'instance, toutes les méthodes renvoient uniquement l'identifiant captcha et n'interrogent PAS l'API pour obtenir le résultat. Le résultat sera envoyé à l'URL de rappel. Pour obtenir la réponse manuellement, utilisez la méthode getResult

Résoudre le captcha

Lorsque vous soumettez un captcha basé sur une image, vous pouvez fournir des options supplémentaires pour aider les travailleurs de 2Captcha à le résoudre correctement.

Options de captcha
OptionValeur par défautDescription
numeric0Définit si le captcha contient des symboles numeric ou autres voir plus d'infos dans les docs de l'API.
minLength0longueur minimale de réponse
maxLength0longueur maximale de la réponse
phrase0définit si la réponse contient des mots multiples ou non
caseSensitive0définit si la réponse est sensible à la casse
calc0définit que le captcha nécessite un calcul
lang-définit la langue du captcha, voir la liste des langues prises en charge.
hintImg-une image avec un indice montré aux travailleurs avec le captcha
hintText-Indice ou texte de tâche montré aux travailleurs avec le captcha.
simpleCaptcha

Pour contourner un captcha normal (texte déformé sur l'image), utilisez la méthode suivante. Cette méthode peut également être utilisée pour reconnaître n'importe quel texte sur l'image.

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

Cette méthode peut être utilisée pour contourner un captcha qui demande de répondre à une question fournie en clair.

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

Utilisez cette méthode pour résoudre le reCAPTCHA V2 et obtenir un jeton pour contourner la protection.

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

Cette méthode fournit la résolution reCAPTCHA V3 et retourne un jeton.

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

Méthode de résolution de FunCaptcha (Arkoselabs). Retourne un jeton.

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

Méthode pour résoudre le puzzle captcha de GeeTest. Retourne un ensemble de jetons en JSON.

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

Utilisez cette méthode pour résoudre le défi hCaptcha. Retourne un jeton pour contourner le captcha.

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

Méthode basée sur les jetons pour résoudre 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

Méthode basée sur un jeton pour contourner le captcha du puzzle Capy.

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

La méthode de la grille est initialement appelée méthode Old reCAPTCHA V2. Cette méthode peut être utilisée pour contourner tout type de captcha où vous pouvez appliquer une grille sur l'image et où vous devez cliquer sur des cases spécifiques de la grille. Retourne le nombre de cases.

canvas

La méthode Canvas peut être utilisée lorsque vous avez besoin de dessiner une ligne autour d'un objet sur une image. Renvoie un ensemble de coordonnées de points pour dessiner un polygone.

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

La méthode ClickCaptcha renvoie les coordonnées des points sur l'image captcha. Peut être utilisée si vous avez besoin de cliquer sur des points particuliers de l'image.

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

Cette méthode peut être utilisée pour résoudre un captcha qui demande de faire tourner un objet. Principalement utilisé pour contourner FunCaptcha. Retourne l'angle de rotation.

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

Autres méthodes

Méthodes valides supplémentaires utilisées pendant le travail des scripts principaux

send / getResult

Ces méthodes peuvent être utilisées pour la soumission manuelle de captcha et le sondage des réponses.

import time
. . . . . 

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

code = solver.get_result(id)

balance

Utilisez cette méthode pour obtenir le solde de votre compte.

balance = solver.balance()

report

Utilisez cette méthode pour signaler une bonne ou une mauvaise réponse au captcha.

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

Traitement des erreurs

Variantes possibles des erreurs standard renvoyées par le service lors du traitement des demandes

En cas d'erreur, la résolution captcha lève une exception. Il est important de bien gérer ces cas. Nous vous recommandons d'utiliser try/except pour gérer les exceptions.

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)

Proxys

Vous pouvez passer votre proxy comme argument supplémentaire pour les méthodes : recaptcha, funcaptcha et geetest. Le proxy sera transmis à l'API pour résoudre le captcha.

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

Appels Async

Vous pouvez également effectuer des appels asynchrones avec asyncio, par exemple :

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

Autres langues pour l'intégration avec l'API de service

L'extension Captcha Bypass est compatible avec les navigateurs Chrome et Firefox.Extension Captcha BypassRecommended extension
Alternative extensions
CaptchaTheCat