Captcha Tools
Python module to help solve captchas with Capmonster, 2Captcha and Anticaptcha API's!
Go(lang)
To see documentation for the Go implementation, click here
Install
pip3 install captchatoolsTo update
pip3 install -U captchatoolsHow to use
Getting reCAPTCHA Tokens
import captchatools
solver = captchatools.captcha_harvesters(solving_site="capmonster", api_key="YOUR API KEY", sitekey="6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-", 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="6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-", captcha_url="https://www.google.com/recaptcha/api2/demo")
captcha_answer = solver.get_token()Getting Normal Captcha Tokens
import captchatools
solver = captchatools.captcha_harvesters(solving_site=2, captcha_type="normal", api_key="YOUR API KEY HERE")
url = "https://www.scienceabc.com/wp-content/uploads/ext-www.scienceabc.com/wp-content/uploads/2016/07/Captcha-ex.jpg-.jpg"
text_cap_answer = solver.get_normal(url)| 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 | - | Sitekey from the site where captcha is loaded |
| captcha_url | true | String | - | URL where the captcha is located |
| captcha_type | false | String | "v2" | Type of captcha you are solving. Either captcha v2, v3 or hcaptcha (hcap works aswell) |
| invisible_captcha | false | bool | false | If the captcha is invisible or not. This param is only required when solving invisible captchas |
| min_score | false | double | 0.7 | Minimum score for v3 captchas. This param is only required when solving V3 and it needs a higher / lower score |
| action | false | String | "verify" | Action that is associated with the V3 captcha. This param is only required when solving V3 captchas |
| soft_id | false | int | 4782723 | 2captcha Developer ID. Developers get 10% of spendings of their software users. |
Supported Sites
Site-Specific Support:
| Site | Site ID | Captcha Types Supported | Task Types Supported |
|---|---|---|---|
| Capmonster | 1 | Recaptcha V2, Recaptcha V3, HCaptcha |
RecaptchaV2TaskProxyless, RecaptchaV3TaskProxyless, HCaptchaTaskProxyless, ImageToTextTask |
| Anticaptcha | 2 | Recaptcha V2, Recaptcha V3, HCaptcha |
RecaptchaV2TaskProxyless, RecaptchaV3TaskProxyless, HCaptchaTaskProxyless ImageToTextTask |
| 2Captcha | 3 | Recaptcha V2, Recaptcha V3, HCaptcha |
- |
Recommendations
- For 2Captcha, don't run more than 60 tasks per API key.
- Handle exceptions appropriately.
- If a
NoBalanceExceptionis 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 sitekey |
NoHarvesterException |
When the user did not / incorrectly chose a captcha harvester. Refer to the guide |
CaptchaIMGTooBig |
The size of the captcha image is too big for the solving service. |
FailedToGetCapIMG |
Failed to get the captcha image from the URL. Tries 3 times before getting thrown. |
from captchatools import captcha_harvesters, exceptions as captchaExceptions
try:
...
except captchaExceptions.NoBalanceException:
print("No balance.")or
import captchatools
try:
...
except captchatools.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
- [] Release in Go
- [] Allow for refunds