Thoughtful Automation BitWarden CLI installation package
Project description
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:
Make sure you browser instance is on the page with captcha
Use TACaptchaSolver.get() method with appropriate params
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):
Make sure you provide a correct path to image in image_source param
Use TACaptchaSolver.get() method with appropriate params
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.