captchatools 1.0.0

Python module to help solve captchas with Capmonster, 2captcha and Anticaptcha API's!

Captcha Tools

Python module to help solve captchas with Capmonster, 2Captcha and Anticaptcha API's!

Install

pip3 install captchatools

How to use

import captchatools
solver = captchatools.captcha_harvesters(solving_site="capmonster", api_key="YOUR API KEY", sitekey="SITEKEY", captcha_url="https://www.google.com/recaptcha/api2/demo")
captcha_answer = solver.get_token()

or

from captchatools import captcha_harvesters, exceptions
solver = captcha_harvesters(solving_site=1, api_key="YOUR API KEY", sitekey="SITEKEY", captcha_url="https://www.google.com/recaptcha/api2/demo")
captcha_answer = solver.get_token()

Parameter	Required	Type	Default	Description
api_key	true	String	-	The API Key for the captcha solving site
solving_site	true	String (name of site) or int (site ID)	"capmonster"	Captcha solving site
sitekey	true	String	-	Google sitekey from the site where captcha is loaded
captcha_url	true	String	-	URL where the captcha is located
captcha_type	false	String	"v2"	Either captcha v2 or v3
invisible_captcha	false	bool	false	If the captcha is invisible or not
min_score	false	double	0.7	Minimum score for v3 captchas
action	false	String	"verify"	Action that is associated with the v3 captcha

Supported Sites

• Capmonster
• 2Captcha
• Anticaptcha

Site-Specific Support:

Site	Site ID	Captcha Types	Task Types
Capmonster	1	Recaptcha V2, Recaptcha V3	RecaptchaV2TaskProxyless, RecaptchaV3TaskProxyless
Anticaptcha	2	Recaptcha V2, Recaptcha V3	RecaptchaV2TaskProxyless, RecaptchaV3TaskProxyless
2Captcha	3	Recaptcha V2, Recaptcha V3	-

Recommendations

1. For 2Captcha, don't run more than 60 tasks per API key.
2. Handle exceptions appropriately.
   • If a NoBalanceException is thrown, tasks should stop. Some sites will temporarily ban IP's if constant requests come in.

Exceptions

Exception	Raised
NoBalanceException	Balance is below 0 for captcha solving site
WrongAPIKeyExceptionException	Incorrect API Key for captcha solving site
WrongSitekeyException	Incorrect Google sitekey

from captchatools import captcha_harvesters, exceptions as captchaExceptions
try:
    ...
except captchaExceptions.NoBalanceException:
    print("No balance.")

TO DO

1. [] Document code better
2. [] 2Captcha
   • [] Clean up code
   • [] Proxy support
   • [] Cookie support
   • [] User Agent Support
   • [] Different type of captchas
3. [] Anticaptcha
   • [] Clean up code
   • [] Proxy support
   • [] Cookie support
   • [] User Agent Support
   • [] Different type of captchas
4. [] Capmonster
   • [] Clean up code
   • [] Proxy support
   • [] Cookie support
   • [] User Agent Support
   • [] Different type of captchas
5. [] Add DeathByCaptcha
6. [] More defined exceptions