Installation

python3 -m virtualenv venv
source venv/bin/activate
pip install ta-captcha-solver

How to Use

1. Make sure your browser instance is on the page with captcha or provide a correct path to image in image_source param

2. Use TACaptchaSolver.get() method with appropriate params

3. Call captcha.solve() method that would do all the magic

Supported Browsers

Currently only RPA.Browser.Selenium.Selenium() is supported. In future we will add a Playwright support as well

Supported Service Providers

Currently we support these:

1. http://learn.captcha.guru/#/

2. https://2captcha.com/2captcha-api

You should have valid API key that could be obtained from web version of service after you put some money to the account balance

Supported Captcha Types

Currently we support these:

1. CloudFlare

2. CloudFlare Challenge

3. Arkose Labs Fun Captcha

4. HCaptcha

5. ReCaptcha v2

6. Image Captcha

Available Settings

If param is not required and not set then this action would not be performed and you a responsible for it. E.g. if you dont provide check_xpath then you should check that captcha has been solved by you own.

Examples

 from RPA.Browser.Selenium import Selenium
 from ta_captcha_solver.ta_captcha_solver import TACaptchaSolver

 browser = Selenium()
 browser.open_browser("http://url_with_captcha")

 captcha = TACaptchaSolver.get(
     captcha_type="v2",
     browser=browser,
     service_provider_name="captcha.guru",
     service_provider_key="captcha.guru API KEY",
 )
captcha.solve()

 from RPA.Browser.Selenium import Selenium
 from ta_captcha_solver.ta_captcha_solver import TACaptchaSolver

 browser = Selenium()
 browser.open_browser("http://url_with_captcha")

 captcha = TACaptchaSolver.get(
     captcha_type="image",
     browser=browser,
     service_provider_name="captcha.guru",
     service_provider_key="captcha.guru API KEY",
     image_xpath="//img[@id='demoCaptcha_CaptchaImage']",
     input_xpath="//input[@id='captchaCode']",
     click_xpath="//input[@id='validateCaptchaButton']",
     check_xpath="//span[@id='validationResult']/span[@class='correct']",
     upper=False,
 )
captcha.solve()

from RPA.Browser.Selenium import Selenium
from ta_captcha_solver.ta_captcha_solver import TACaptchaSolver

browser = Selenium()
browser.open_browser("http://url_with_captcha")

captcha = TACaptchaSolver.get(
    captcha_type="fun_captcha",
    browser=self.browser,
    service_provider_name="2captcha",
    service_provider_key="2captcha API KEY"
    check_xpath="//input[@id='username']",
)
captcha.solve()

 from ta_captcha_solver.ta_captcha_solver import TACaptchaSolver

 captcha = TACaptchaSolver.get(
     captcha_type="image",
     service_provider_name="2captcha",
     service_provider_key="2captcha API KEY",
     image_source= "C:/your-path-to-image-captcha.png",
     upper=False,
 )
captcha.solve()
token = captcha.token

Development

Prepare local dev env:

python3 -m virtualenv venv
source venv/bin/activate
pip install -r requirements.txt

Testing:

CAPTCHA_GURU_API_KEY=XXX TWO_CAPTCHA_API_KEY=YYY pytest