diff --git a/README.md b/README.md index 59a1293..96907cc 100644 --- a/README.md +++ b/README.md @@ -26,6 +26,7 @@ Examples of API requests for different captcha types are available on the [Pytho - [FunCaptcha](#funcaptcha) - [GeeTest](#geetest) - [GeeTest v4](#geetest-v4) + - [Yandex Smart](#yandex-smart) - [Lemin Cropped Captcha](#lemin-cropped-captcha) - [Cloudflare Turnstile](#cloudflare-turnstile) - [Amazon WAF](#amazon-waf) @@ -240,6 +241,15 @@ result = solver.lemin(captcha_id='CROPPED_1abcd2f_a1234b567c890d12ef3a456bc78d90 ``` +### Yandex Smart + +Use this method to solve Yandex Smart Captcha. Returns JSON with the token. +```python +result = solver.yandex_smart(sitekey='0x1AAAAh45AAAAkg0s2VIOD34y5hy4h4h', + url='http://mysite.com/', + proxy={'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}, + userAgent='Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36') +``` ### Cloudflare Turnstile diff --git a/examples/yandex_smart.py b/examples/yandex_smart.py new file mode 100644 index 0000000..a8eb4c4 --- /dev/null +++ b/examples/yandex_smart.py @@ -0,0 +1,28 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from twocaptcha import TwoCaptcha + +# in this example we store the API key inside environment variables that can be set like: +# export APIKEY_2CAPTCHA=1abc234de56fab7c89012d34e56fa7b8 on Linux or macOS +# set APIKEY_2CAPTCHA=1abc234de56fab7c89012d34e56fa7b8 on Windows +# you can just set the API key directly to it's value like: +# api_key="1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_2CAPTCHA', 'YOUR_API_KEY') + +solver = TwoCaptcha(api_key) + +try: + result = solver.yandex_smart( + sitekey="FEXfAbHQsToo97VidNVk3j4dC74nGW1DgdxK4OoR", + url="https://www.site.com/page/" + ) + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) \ No newline at end of file diff --git a/examples/yandex_smart_options.py b/examples/yandex_smart_options.py new file mode 100644 index 0000000..3a8b548 --- /dev/null +++ b/examples/yandex_smart_options.py @@ -0,0 +1,42 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from twocaptcha import TwoCaptcha + +# in this example we store the API key inside environment variables that can be set like: +# export APIKEY_2CAPTCHA=1abc234de56fab7c89012d34e56fa7b8 on Linux or macOS +# set APIKEY_2CAPTCHA=1abc234de56fab7c89012d34e56fa7b8 on Windows +# you can just set the API key directly to it's value like: +# api_key="1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_2CAPTCHA', 'YOUR_API_KEY') + + +config = { + 'server': '2captcha.com', # can be also set to 'rucaptcha.com' + 'apiKey': api_key, + 'softId': 123, + # 'callback': 'https://your.site/result-receiver', # if set, sovler with just return captchaId, not polling API for the answer + 'defaultTimeout': 120, + 'recaptchaTimeout': 600, + 'pollingInterval': 10, + } + +solver = TwoCaptcha(**config) + +try: + result = solver.yandex_smart(sitekey="FEXfAbHQsToo97VidNVk3j4dC74nGW1DgdxK4OoR", + url="https://www.site.com/page/", + # proxy={ + # 'type': 'HTTPS', + # 'uri': 'login:password@IP_address:PORT' + # } + ) + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/tests/test_yandex_smart_captcha.py b/tests/test_yandex_smart_captcha.py new file mode 100644 index 0000000..e322191 --- /dev/null +++ b/tests/test_yandex_smart_captcha.py @@ -0,0 +1,29 @@ +#!/usr/bin/env python3 + +import unittest + +try: + from .abstract import AbstractTest +except ImportError: + from abstract import AbstractTest + + +class YandexSmartCaptchaTest(AbstractTest): + + def test_all_params(self): + params = { + 'sitekey': 'FEXfAbHQsToo97VidNVk3j4dC74nGW1DgdPpL4O', + 'url': 'https://www.site.com/page/', + } + + sends = { + 'method': 'yandex', + 'sitekey': 'FEXfAbHQsToo97VidNVk3j4dC74nGW1DgdPpL4O', + 'pageurl': 'https://www.site.com/page/', + } + + return self.send_return(sends, self.solver.yandex_smart, **params) + + +if __name__ == '__main__': + unittest.main() \ No newline at end of file diff --git a/twocaptcha/solver.py b/twocaptcha/solver.py index dbf4378..af7b6b5 100755 --- a/twocaptcha/solver.py +++ b/twocaptcha/solver.py @@ -856,6 +856,33 @@ def cybersiara(self, master_url_id, pageurl, userAgent, **kwargs): **kwargs) return result + def yandex_smart(self, sitekey, url, **kwargs): + '''Wrapper for solving Yandex Smart. + + Parameters + __________ + sitekey : str + The value of data-sitekey attribute of captcha's div element on page. + url : str + Full URL of the page where you solve the captcha. + softId : int, optional + ID of software developer. Developers who integrated their software with 2Captcha get reward: 10% of + spendings of their software users. + callback : str, optional + URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on + the server. More info here https://2captcha.com/2captcha-api#pingback. + proxy : dict, optional + {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}. + userAgent: str, optional + User-Agent of the browser that will be used by the employee when loading the captcha. + ''' + + result = self.solve(sitekey=sitekey, + url=url, + method='yandex', + **kwargs) + return result + def solve(self, timeout=0, polling_interval=0, **kwargs): '''Sends captcha, receives result.