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
Publié sur GitHub sont examples de contournement de captcha en utilisant Python et Selenium. Le dépôt contient des scripts prêts à l'emploi pour automatiser les processus de résolution de captcha, permettant une intégration facile dans les projets existants.
Démarrage rapideInstallation
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
Option | Valeur par défaut | Description |
---|---|---|
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. |
defaultTimeout | 120 | Dé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 |
recaptchaTimeout | 600 | Dé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. |
pollingInterval | 10 | Intervalle 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 foisrappel
est défini pourTwoCaptcha
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
Option | Valeur par défaut | Description |
---|---|---|
numeric | 0 | Définit si le captcha contient des symboles numeric ou autres voir plus d'infos dans les docs de l'API. |
minLength | 0 | longueur minimale de réponse |
maxLength | 0 | longueur maximale de la réponse |
phrase | 0 | définit si la réponse contient des mots multiples ou non |
caseSensitive | 0 | définit si la réponse est sensible à la casse |
calc | 0 | dé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. |
- Normal Captcha
- Texte Captcha
- reCAPTCHA v2
- reCAPTCHA v3
- FunCaptcha
- GeeTest
- hCaptcha
- KeyCaptcha
- Capy
- Grille
- Canvas
- ClickCaptcha
- Pivoter
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=..., ...)
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=..., ...)
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=..., ...)
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=..., ...)
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=..., ...)
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=..., ...)
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=..., ...)
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=..., ...)
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=..., ...)
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.
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=..., ...)
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=..., ...)
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
Paquet PHP pour l'intégration avec l'API de service
Paquet Java pour l'intégration avec l'API de service
Paquet C# pour l'intégration avec l'API de service
Paquet Golang pour l'intégration avec l'API de service
Paquet Ruby pour l'intégration avec l'API de service
Paquet JavaScript pour l'intégration avec l'API de service