ta-captcha-solver 0.1.2

Thoughtful Automation BitWarden CLI installation package

Thoughtful Automation Captcha Solver

Installation

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

How to Use

In case captcha is obtained from browser:

1. Make sure you browser instance is on the page with captcha

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

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

In case captcha image will be provided as .jpg or .png file (suitable for desktop Automation):

1. Make sure you 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 only http://learn.captcha.guru/#/ service. You should have valid API key that could be obtained from web version of service after you put some money to the account balance

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.

Param	Required	Type	Description
captcha_type	Yes	All	One of supported captcha types
browser	Yes for ‘v2’ and for ‘image’ only when image_source is not provided.	All	Supported browser instance with opened captcha page
captcha_guru_api_key	Yes	All	Valid API key
image_xpath	Yes if browser is provided	Image	Locator of <img> with captcha pic
input_xpath	No	Image	Locator of input field for token
click_xpath	No	All	Locator of submit button
check_xpath	No	All	Locator that should be verified after solving
upper	No	Image	Perform token.upper()
image_source	Yes if browser not provided	Image	Path to .png or .jpg image with captcha to solve

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,
     captcha_guru_api_key="MY 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,
     captcha_guru_api_key="MY 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 ta_captcha_solver.ta_captcha_solver import TACaptchaSolver


 captcha = TACaptchaSolver.get(
     captcha_type="image",
     captcha_guru_api_key="MY 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 pytest

Push new package version:

bump2version minor
git push origin YOUR_BRANCH