captcha-solution

Captcha Solution Python Package

Captcha Solution package is a simple interface to multiple captcha solving services.

Simple Image Captcha

The simplest case is to solve captcha image stored into file. Pass the file handler to the solve method. The solution will be stored into "solution" key of returned result. In "raw" key there is a full original response that captcha service returned.

from captcha_solution import CaptchaSolver

solver = CaptchaSolver('anticaptcha', api_key='YOUR-API-KEY')
with open('captcha.png', 'rb') as inp:
    res = solver.solve(inp)
    print(res['solution'])

Custom Captcha

If you want to solve non-image type of captcha (text captcha, recaptcha, etc) you have to use same solve method but you need to pass the dict of parameters. Each captcha service has its own request data schema so you need to consult with documentation to figure out format of request

Example, solving recaptcha with 2captcha.com

Documentation is https://2captcha.com/2captcha-api?form=3019071#solving_recaptchav2_new

Required POST parameters are: key, method, googlekey, pageurl. You do not have to pass key (api key), it is already done by solver. The code would be like:

res = solver.solve({
    "method": "userrecaptcha",
    "googlekey": "VALUE-OF-SITE-KEY",
    "pageurl": "URL-OF-PAGE-WHERE-RECAPTCHA-IS-DISPLAYED"
})
print('Solution: %s' % res['solution'])
print('Raw Response: %s' % res['raw'])

Example, solving recaptcha with anti-captcha.com

Documentation is https://anticaptcha.atlassian.net/wiki/spaces/API/pages/5079084/Captcha+Task+Types We need to use NoCaptchaTaskProxyless type of task. This task objects has required keys: type, websiteURL, websiteKey Code will looks like:

res = solver.solve({
    "task": {
        "type": "NoCaptchaTaskProxyless",
        "websiteKEY": "VALUE-OF-SITE-KEY",
        "websiteURL": "URL-OF-PAGE-WHERE-RECAPTCHA-IS-DISPLAYED",
    }
})
print('Solution: %s' % res['solution']['gRecaptchaResponse'])
print('Raw Response: %s' % res['raw'])

Supported Captcha Services

• 2captcha.com (aka rucaptcha.com)

  • alias: 2captcha and rucaptcha
  • docs (en): https://2captcha.com/2captcha-api
  • docs (ru): https://rucaptcha.com/api-rucaptcha

• anti-captcha.com

  • alias - anticaptcha
  • docs (en): https://anticaptcha.atlassian.net/wiki/spaces/API/pages/196635/Documentation+in+English
  • docs (ru): https://anticaptcha.atlassian.net/wiki/spaces/API/pages/196633