Python module to help solve captchas with Capmonster, 2captcha and Anticaptcha API's!
Project description
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
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
- For 2Captcha, don't run more than 60 tasks per API key.
- Handle exceptions appropriately.
- If a
NoBalanceException
is thrown, tasks should stop. Some sites will temporarily ban IP's if constant requests come in.
- If a
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
- [] Document code better
- [] 2Captcha
- [] Clean up code
- [] Proxy support
- [] Cookie support
- [] User Agent Support
- [] Different type of captchas
- [] Anticaptcha
- [] Clean up code
- [] Proxy support
- [] Cookie support
- [] User Agent Support
- [] Different type of captchas
- [] Capmonster
- [] Clean up code
- [] Proxy support
- [] Cookie support
- [] User Agent Support
- [] Different type of captchas
- [] Add DeathByCaptcha
- [] More defined exceptions
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
Close
Hashes for captchatools-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | feab2e481c027ac7c22015702b79d703f2e4fc0905de864289bc1716be2faedf |
|
MD5 | f4046a0369866f9b7ef5a02d812351ac |
|
BLAKE2b-256 | 9a4142c4d41d8311a2ae02eecef0d58a7bb148991cf1f91898fa6cd0e813d1e3 |