From 9485706a68a7f67be250a4b636697f65df4f8e63 Mon Sep 17 00:00:00 2001 From: captchasolver Date: Thu, 20 Mar 2025 22:05:27 +0200 Subject: [PATCH] init --- LICENSE | 21 + README.md | 411 ++++++++++++++++ examples/canvas.py | 26 ++ examples/canvas_base64.py | 31 ++ examples/canvas_options.py | 33 ++ examples/coordinates.py | 26 ++ examples/coordinates_base64.py | 31 ++ examples/coordinates_options.py | 29 ++ examples/funcaptcha.py | 29 ++ examples/funcaptcha_options.py | 36 ++ examples/geetest.py | 37 ++ examples/geetest_options.py | 46 ++ examples/geetest_v4.py | 28 ++ examples/geetest_v4_options.py | 42 ++ examples/grid.py | 30 ++ examples/grid_base64.py | 34 ++ examples/grid_options.py | 36 ++ examples/hcaptcha.py | 34 ++ examples/hcaptcha_options.py | 49 ++ examples/images/canvas.jpg | Bin 0 -> 63893 bytes examples/images/canvas_hint.jpg | Bin 0 -> 26872 bytes examples/images/grid.jpg | Bin 0 -> 40405 bytes examples/images/grid_2.jpg | Bin 0 -> 30347 bytes examples/images/grid_hint.jpg | Bin 0 -> 5897 bytes examples/images/normal.jpg | Bin 0 -> 825 bytes examples/images/normal_2.jpg | Bin 0 -> 5207 bytes examples/images/rotate.jpg | Bin 0 -> 5475 bytes examples/keycaptcha.py | 32 ++ examples/keycaptcha_options.py | 47 ++ examples/normal.py | 27 ++ examples/normal_base64.py | 31 ++ examples/normal_options.py | 38 ++ examples/recaptcha_v2.py | 33 ++ examples/recaptcha_v2_options.py | 46 ++ examples/recaptcha_v3.py | 31 ++ examples/recaptcha_v3_options.py | 46 ++ examples/rotate.py | 27 ++ examples/rotate_options.py | 32 ++ examples/text.py | 28 ++ examples/text_options.py | 28 ++ examples/turnstile.py | 33 ++ examples/turnstile_options.py | 47 ++ requirements.txt | 1 + setup.py | 41 ++ solvecaptcha/__init__.py | 3 + solvecaptcha/api.py | 117 +++++ solvecaptcha/solver.py | 774 +++++++++++++++++++++++++++++++ tests/abstract.py | 67 +++ tests/test_coordinates.py | 84 ++++ tests/test_funcaptcha.py | 44 ++ tests/test_geetest.py | 41 ++ tests/test_geetest_v4.py | 34 ++ tests/test_grid.py | 91 ++++ tests/test_hcaptcha.py | 38 ++ tests/test_keycaptcha.py | 44 ++ tests/test_normal.py | 102 ++++ tests/test_recaptcha.py | 64 +++ tests/test_text.py | 40 ++ tests/test_turnstile.py | 36 ++ 59 files changed, 3156 insertions(+) create mode 100644 LICENSE create mode 100644 README.md create mode 100644 examples/canvas.py create mode 100644 examples/canvas_base64.py create mode 100644 examples/canvas_options.py create mode 100644 examples/coordinates.py create mode 100644 examples/coordinates_base64.py create mode 100644 examples/coordinates_options.py create mode 100644 examples/funcaptcha.py create mode 100644 examples/funcaptcha_options.py create mode 100644 examples/geetest.py create mode 100644 examples/geetest_options.py create mode 100644 examples/geetest_v4.py create mode 100644 examples/geetest_v4_options.py create mode 100644 examples/grid.py create mode 100644 examples/grid_base64.py create mode 100644 examples/grid_options.py create mode 100644 examples/hcaptcha.py create mode 100644 examples/hcaptcha_options.py create mode 100644 examples/images/canvas.jpg create mode 100644 examples/images/canvas_hint.jpg create mode 100644 examples/images/grid.jpg create mode 100644 examples/images/grid_2.jpg create mode 100644 examples/images/grid_hint.jpg create mode 100644 examples/images/normal.jpg create mode 100644 examples/images/normal_2.jpg create mode 100644 examples/images/rotate.jpg create mode 100644 examples/keycaptcha.py create mode 100644 examples/keycaptcha_options.py create mode 100644 examples/normal.py create mode 100644 examples/normal_base64.py create mode 100644 examples/normal_options.py create mode 100644 examples/recaptcha_v2.py create mode 100644 examples/recaptcha_v2_options.py create mode 100644 examples/recaptcha_v3.py create mode 100644 examples/recaptcha_v3_options.py create mode 100644 examples/rotate.py create mode 100644 examples/rotate_options.py create mode 100644 examples/text.py create mode 100644 examples/text_options.py create mode 100644 examples/turnstile.py create mode 100644 examples/turnstile_options.py create mode 100644 requirements.txt create mode 100644 setup.py create mode 100644 solvecaptcha/__init__.py create mode 100644 solvecaptcha/api.py create mode 100644 solvecaptcha/solver.py create mode 100755 tests/abstract.py create mode 100755 tests/test_coordinates.py create mode 100755 tests/test_funcaptcha.py create mode 100755 tests/test_geetest.py create mode 100755 tests/test_geetest_v4.py create mode 100755 tests/test_grid.py create mode 100755 tests/test_hcaptcha.py create mode 100755 tests/test_keycaptcha.py create mode 100644 tests/test_normal.py create mode 100755 tests/test_recaptcha.py create mode 100755 tests/test_text.py create mode 100755 tests/test_turnstile.py diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..4ab723b --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2025 Solvecaptcha + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/README.md b/README.md new file mode 100644 index 0000000..01516b8 --- /dev/null +++ b/README.md @@ -0,0 +1,411 @@ +![solvecaptcha-python](https://github.com/user-attachments/assets/b3526dc7-a0aa-4f07-a4f7-51e0ad742941) + + + + + + + + + + +# Python library for interacting with the Solvecaptcha API (captcha-solving service) + +A simple and efficient method to integrate the [Solvecaptcha] captcha-solving service into your code, enabling the automation of solving various types of captchas. +Examples of API requests for different captcha types can be found on the [Python captcha solver](https://solvecaptcha.com/captcha-solver/python-captcha-solver-bypass) page. + +- [Python Library for Interacting with the Solvecaptcha API](#python-library-for-interacting-with-the-solvecaptcha-api-captcha-solving-service) + - [Installation](#installation) + - [Configuration](#configuration) + - [Solvecaptcha instance options](#solvecaptcha-instance-options) + - [Solve captcha](#solve-captcha) + - [Captcha options](#captcha-options) + - [Normal Captcha](#normal-captcha) + - [Text Captcha](#text-captcha) + - [reCAPTCHA v2](#recaptcha-v2) + - [reCAPTCHA v3](#recaptcha-v3) + - [FunCaptcha](#funcaptcha) + - [GeeTest](#geetest) + - [GeeTest v4](#geetest-v4) + - [Cloudflare Turnstile](#cloudflare-turnstile) + - [KeyCaptcha](#keycaptcha) + - [Grid](#grid) + - [ClickCaptcha](#clickcaptcha) + - [Rotate](#rotate) + - [Other methods](#other-methods) + - [send / get_result](#send--get_result) + - [balance](#balance) + - [report](#report) + - [Error handling](#error-handling) + - [Proxies](#proxies) + - [Async calls](#async-calls) + - [Examples](#examples) + + - [Useful articles](#useful-articles) + - [Get in touch](#get-in-touch) + - [License](#license) + +## Installation + +This package can be installed using Pip: + +```bash +pip3 install solvecaptcha-python +``` + +## Configuration + +An instance of `Solvecaptcha` can be created as follows: + +```python +from solvecaptcha import Solvecaptcha + +solver = Solvecaptcha('YOUR_API_KEY') +``` + +Additionally, there are several options available for configuration: + +```python +config = { + 'server': 'solvecaptcha.com', + 'apiKey': 'YOUR_API_KEY', + 'callback': 'https://your.site/result-receiver', + 'defaultTimeout': 120, + 'recaptchaTimeout': 600, + 'pollingInterval': 10, + 'extendedResponse': False + } +solver = Solvecaptcha(**config) +``` + +### Solvecaptcha instance options + +| Option | Default value | Description | +| ---------------- | ------------------ | -------------- | +| server | `solvecaptcha.com` | API server. You can configure it to `solvecaptcha.com` if your account is registered on this platform. | +| callback | - | The URL of your web server that receives the captcha recognition result. This URL must first be registered in your account's [pingback settings]. | +| defaultTimeout | 120 | Polling timeout in seconds for all captcha types except reCAPTCHA. Specifies the duration for which the module attempts to retrieve the response from the `res.php` API endpoint. | +| recaptchaTimeout | 600 | Polling timeout for reCAPTCHA in seconds. Specifies the duration for which the module attempts to retrieve the response from the `res.php` API endpoint. | +| pollingInterval | 10 | Interval in seconds between requests to the `res.php` API endpoint. It is not recommended to set a value lower than 5 seconds. | +| extendedResponse | None | Set to `True` to receive the response with additional fields or in a more structured format (enables `JSON` response from the `res.php` API endpoint). Recommended for [ClickCaptcha](#clickcaptcha) and [Canvas](#canvas). | + +> [!IMPORTANT] +> Once `callback` is defined for the `Solvecaptcha` instance, all methods return only the captcha ID and DO NOT poll the API to get the result. The result will be sent to the callback URL. + +To get the answer manually, use the [get_result method](#send--get_result). + +## Solve captcha + +When submitting any image-based CAPTCHA, you can provide additional options to assist Solvecaptcha workers in solving it correctly. + +### Captcha options + +| Option | Default Value | Description | +| ------------- | ------------- | --------------------------------------------------------------------------------------------- | +| numeric | 0 | Specifies whether the captcha consists only of numbers or includes other symbols. More details are available in the [API documentation][post options]. | +| minLen | 0 | Sets the minimum length of the expected answer. | +| maxLen | 0 | Sets the maximum length of the expected answer. | +| phrase | 0 | Indicates whether the response consists of multiple words. | +| caseSensitive | 0 | Determines if the response must match the original case. | +| calc | 0 | Specifies if the captcha involves a mathematical calculation. | +| lang | - | Defines the language of the captcha. Refer to the [list of supported languages]. | +| hintImg | - | Provides an additional image as a hint for workers alongside the captcha. | +| hintText | - | Displays a text hint or task description for workers along with the captcha. | + + +Below, you can find basic examples for each captcha type. For more examples with all available options, check the [examples directory]. + +### Normal Captcha + +[API method description.](https://solvecaptcha.com/captcha-solver-api#solving_normal_captcha) + +To solve a standard captcha (distorted text on an image), use the following method. This method can also be applied for text recognition in any image. + + +```python +result = solver.normal('path/to/captcha.jpg', param1=..., ...) +# OR +result = solver.normal('https://site-with-captcha.com/path/to/captcha.jpg', param1=..., ...) +``` + +```python +result = solver.audio('path/to/captcha.mp3', lang = 'lang', param1=..., ...) +# OR +result = solver.audio('https://site-with-captcha.com/path/to/captcha.mp3', lang = 'lang', param1=..., ...) +``` + +### Text Captcha + +[API method description.](https://solvecaptcha.com/captcha-solver-api#solving_text_captcha) + +This method can be used to solve captchas that require answering a question presented in plain text. + +```python +result = solver.text('If tomorrow is Saturday, what day is today?', param1=..., ...) +``` + +### reCAPTCHA v2 + +[API method description.](https://solvecaptcha.com/captcha-solver-api#solving_recaptchav2_new) + +Use the following method to solve reCAPTCHA V2 and retrieve a token for bypassing the protection. + +```python +result = solver.recaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-', + url='https://mysite.com/page/with/recaptcha', + param1=..., ...) +``` + +### reCAPTCHA v3 + +[API method description.](https://solvecaptcha.com/captcha-solver-api#solving_recaptchav3) + +This method offers a reCAPTCHA V3 solver and returns a token. + +```python +result = solver.recaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-', + url='https://mysite.com/page/with/recaptcha', + version='v3', + param1=..., ...) +``` + +### FunCaptcha + +[API method description.](https://solvecaptcha.com/captcha-solver-api#solving_funcaptcha_new) + +FunCaptcha (Arkoselabs) solving method that returns a token. + +```python +result = solver.funcaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-', + url='https://mysite.com/page/with/funcaptcha', + param1=..., ...) + +``` + +### GeeTest + +[API method description.](https://solvecaptcha.com/captcha-solver-api#solving_geetest) + +Method for solving GeeTest puzzle captcha. Returns a set of tokens in JSON format. + +```python +result = solver.geetest(gt='f1ab2cdefa3456789012345b6c78d90e', + challenge='12345678abc90123d45678ef90123a456b', + url='https://www.site.com/page/', + param1=..., ...) + +``` + +### GeeTest v4 + +[API method description.](https://solvecaptcha.com/captcha-solver-api#solving_geetest_v4) + +Use this method to solve GeeTest v4. The response is returned in JSON format. + +```python +result = solver.geetest_v4(captcha_id='e392e1d7fd421dc63325744d5a2b9c73', + url='https://www.site.com/page/', + param1=..., ...) + +``` + +### Cloudflare Turnstile + +[API method description.](https://solvecaptcha.com/captcha-solver-api#solving_cloudflare_turnstile) + +Use this method to solve Cloudflare Turnstile. The response is returned as JSON containing the token. + +```python +result = solver.turnstile(sitekey='0x1AAAAAAAAkg0s2VIOD34y5', + url='http://mysite.com/', + data='foo', + pagedata='bar', + action='challenge', + 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') +``` + +### KeyCaptcha + +[API method description.](https://solvecaptcha.com/captcha-solver-api#solving_keycaptcha) + +Token-based method for solving KeyCaptcha. + +```python +result = solver.keycaptcha(s_s_c_user_id=10, + s_s_c_session_id='493e52c37c10c2bcdf4a00cbc9ccd1e8', + s_s_c_web_server_sign='9006dc725760858e4c0715b835472f22-pz-', + s_s_c_web_server_sign2='2ca3abe86d90c6142d5571db98af6714', + url='https://www.keycaptcha.ru/demo-magnetic/', + param1=..., ...) + +``` + +### Grid + +[API method description.](https://solvecaptcha.com/captcha-solver-api#solving_grid) + +The grid method was initially known as the Old reCAPTCHA V2 method. It can be used to bypass any captcha that requires selecting specific grid boxes on an image. Returns the numbers of the selected boxes. + +```python +result = solver.grid('path/to/captcha.jpg', param1=..., ...) +``` + +### ClickCaptcha + +[API method description.](https://solvecaptcha.com/captcha-solver-api#solving_clickcaptcha) + +The ClickCaptcha method returns the coordinates of specific points on the captcha image. It is useful when solving captchas that require clicking on designated areas within the image. + +```python +result = solver.coordinates('path/to/captcha.jpg', param1=..., ...) +``` + +### Rotate + +[API method description.](https://solvecaptcha.com/captcha-solver-api#solving_rotatecaptcha) + +This method is used to solve captchas that require rotating an object. It is primarily utilized for bypassing FunCaptcha and returns the rotation angle. + +```python +result = solver.rotate('path/to/captcha.jpg', param1=..., ...) +``` + +### Canvas + +[API method description.](https://solvecaptcha.com/captcha-solver-api#canvas) + +The canvas method is used for captchas that require drawing a line around an object in an image. It returns a set of point coordinates for constructing a polygon. + +```python +result = solver.canvas('path/to/captcha.jpg', param1=..., ...) +``` + +## Other methods + +### send / get_result + +These methods allow manual captcha submission and answer polling. The `send()` method supports sending any captcha type. To specify the captcha type, you must manually set the `method` parameter, for example, `method='recaptcha'` for solving reCAPTCHA. +You can find the available values for the `method` parameter in the [API documentation](https://solvecaptcha.com/captcha-solver-api). + +Example of manually solving a Normal captcha: + +```python +import time +. . . . . + + +id = solver.send(file='path/to/captcha.jpg') +time.sleep(20) + +code = solver.get_result(id) +``` + +### balance + +[API method description.](https://solvecaptcha.com/captcha-solver-api#additional) + +Use this method to retrieve your account balance. + +```python +balance = solver.balance() +``` + +### report + +[API method description.](https://solvecaptcha.com/captcha-solver-api#complain) + +Use this method to report whether a captcha answer was correct or incorrect. + +```python +solver.report(id, True) # captcha solved correctly +solver.report(id, False) # captcha solved incorrectly +``` + +## Error handling + +If an error occurs, the captcha solver throws an exception. Proper error handling is essential. We recommend using `try except` to manage exceptions. +A complete list of possible errors can be found in the [API documentation](https://solvecaptcha.com/captcha-solver-api#error_handling). + +```python +try: + result = solver.text('If tomorrow is Saturday, what day is today?') +except ValidationException as e: + # invalid parameters passed + print(e) +except NetworkException as e: + # network error occurred + print(e) +except ApiException as e: + # api respond with error + print(e) +except TimeoutException as e: + # captcha is not solved so far + print(e) +``` + +## Proxies + +You can provide your proxy as an additional argument for the following methods: reCAPTCHA, FunCaptcha, GeeTest, GeeTest v4, KeyCaptcha, hCaptcha, Turnstile, Amazon WAF, and other captchas. + +The proxy will be passed to the API to facilitate captcha solving. + +We also offer our own proxies that you can use. + +```python +proxy={ + 'type': 'HTTPS', + 'uri': 'login:password@IP_address:PORT' +} +``` + +## Async calls + +You can also perform asynchronous calls using [asyncio], for example: + +```python +import asyncio +import concurrent.futures +from solvecaptcha import Solvecaptcha + +API_KEY = "YOUR_API_KEY" +image = "data:image/png;base64,iVBORw0KGgoA..." + +async def captchaSolver(image): + loop = asyncio.get_running_loop() + with concurrent.futures.ThreadPoolExecutor() as pool: + result = await loop.run_in_executor(pool, lambda: Solvecaptcha(API_KEY).normal(image)) + return result + +captcha_result = asyncio.run(captchaSolver(image)) +``` + +## Examples + +Examples of solving all supported captcha types can be found in the [examples] directory. + + + +## Useful articles + +- [Solve and bypass Google reCAPTCHA, hCaptcha, Image CAPTCHA, Cloudflare Challenge and any captcha in Selenium with captcha solver.](https://solvecaptcha.com/captcha-solver/selenium-captcha-solver-bypass) +- [Solve and bypass Google reCAPTCHA, hCaptcha, Arkose FunCaptcha, Cloudflare Turnstile, and any captcha in Puppeteer with captcha solver.](https://solvecaptcha.com/captcha-solver/puppeteer-captcha-solver-bypass) + +## Get in touch + + + + +## License + +The code in this repository is licensed under the MIT License. For more details, see the [LICENSE](./LICENSE) file. + + +[Solvecaptcha]: https://solvecaptcha.com/ +[pingback settings]: https://solvecaptcha.com/captcha-solver-api#manage_pingback +[post options]: https://solvecaptcha.com/captcha-solver-api#normal_post +[list of supported languages]: https://solvecaptcha.com/captcha-solver-api#language +[examples directory]: /examples +[asyncio]: https://docs.python.org/3/library/asyncio.html +[examples]: ./examples diff --git a/examples/canvas.py b/examples/canvas.py new file mode 100644 index 0000000..a8c8460 --- /dev/null +++ b/examples/canvas.py @@ -0,0 +1,26 @@ +import sys +import os +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +try: + result = solver.canvas('./images/canvas.jpg', hintText='Draw around apple') + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/canvas_base64.py b/examples/canvas_base64.py new file mode 100644 index 0000000..5268606 --- /dev/null +++ b/examples/canvas_base64.py @@ -0,0 +1,31 @@ +import sys +import os +from base64 import b64encode + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +with open('./images/canvas.jpg', 'rb') as f: + b64 = b64encode(f.read()).decode('utf-8') + +try: + result = solver.canvas(b64, hintText='Draw around apple') + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/canvas_options.py b/examples/canvas_options.py new file mode 100644 index 0000000..e176b62 --- /dev/null +++ b/examples/canvas_options.py @@ -0,0 +1,33 @@ +import sys +import os +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key, defaultTimeout=120, pollingInterval=5, server='solvecaptcha.com') + +try: + result = solver.canvas( + './images/canvas.jpg', + previousId=0, + canSkip=0, + lang='en', + hintImg='./images/canvas_hint.jpg', + hintText='Draw around apple', + ) + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/coordinates.py b/examples/coordinates.py new file mode 100644 index 0000000..e295da1 --- /dev/null +++ b/examples/coordinates.py @@ -0,0 +1,26 @@ +import sys +import os +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +try: + result = solver.coordinates('./images/grid.jpg') + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/coordinates_base64.py b/examples/coordinates_base64.py new file mode 100644 index 0000000..ede301c --- /dev/null +++ b/examples/coordinates_base64.py @@ -0,0 +1,31 @@ +import sys +import os +from base64 import b64encode + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +with open('./images/grid.jpg', 'rb') as f: + b64 = b64encode(f.read()).decode('utf-8') + +try: + result = solver.coordinates(b64) + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/coordinates_options.py b/examples/coordinates_options.py new file mode 100644 index 0000000..e750cfc --- /dev/null +++ b/examples/coordinates_options.py @@ -0,0 +1,29 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key, defaultTimeout=120, pollingInterval=5, extendedResponse=True) + +try: + result = solver.coordinates('./images/grid_2.jpg', + lang='en', + hintImg='./images/grid_hint.jpg', + hintText='Select all images with an Orange') +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/funcaptcha.py b/examples/funcaptcha.py new file mode 100644 index 0000000..764f95c --- /dev/null +++ b/examples/funcaptcha.py @@ -0,0 +1,29 @@ +import sys +import os +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +try: + result = solver.funcaptcha(sitekey='1C2BB537-D5F7-4A66-BC74-25881B58F1D6', + url='https://agoda-api.arkoselabs.com/v2/1C2BB537-D5F7-4A66-BC74-25881B58F1D6/api.js', + surl='https://client-api.arkoselabs.com') + + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/funcaptcha_options.py b/examples/funcaptcha_options.py new file mode 100644 index 0000000..7c941b2 --- /dev/null +++ b/examples/funcaptcha_options.py @@ -0,0 +1,36 @@ +import sys +import os +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key, defaultTimeout=180, pollingInterval=15) + +try: + result = solver.funcaptcha( + sitekey='1C2BB537-D5F7-4A66-BC74-25881B58F1D6', + url='https://agoda-api.arkoselabs.com/v2/1C2BB537-D5F7-4A66-BC74-25881B58F1D6/api.js', + surl='https://client-api.arkoselabs.com', + userAgent='Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.61 Safari/537.36', + # **{'data[key]': 'value'}, #optional data param used by some websites + # proxy={ + # 'type': 'HTTP', + # 'uri': 'login:password@123.123.123.123:8080' + # } + ) + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/geetest.py b/examples/geetest.py new file mode 100644 index 0000000..5de017a --- /dev/null +++ b/examples/geetest.py @@ -0,0 +1,37 @@ +import sys +import os +import requests +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +""" +Important: The value of the 'challenge' parameter is dynamic. You must obtain a new value for each request to our API. +""" + +resp = requests.get("https://mysite.com/api/v1/ captcha-demo/gee-test/init-params") +challenge = resp.json()['challenge'] + +try: + result = solver.geetest(gt='81388ea1fc187e0c335c0a8907ff2625', + apiServer='http://api.geetest.com', + challenge=challenge, + url='https://mysite.com/page/with//geetest') + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) \ No newline at end of file diff --git a/examples/geetest_options.py b/examples/geetest_options.py new file mode 100644 index 0000000..c407b99 --- /dev/null +++ b/examples/geetest_options.py @@ -0,0 +1,46 @@ +import sys +import os +import requests +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key, + defaultTimeout=300, + pollingInterval=10, + extendedResponse=True) + +""" +**Important:** The value of the `challenge` parameter is dynamic. You must obtain a new value for each request to our API. +""" + +resp = requests.get("https://mysite.com/api/v1/ captcha-demo/gee-test/init-params") +challenge = resp.json()['challenge'] + +try: + result = solver.geetest( + gt='81388ea1fc187e0c335c0a8907ff2625', + apiServer='http://api.geetest.com', + challenge=challenge, + url='https://mysite.com/page/with//geetest', + # proxy={ + # 'type': 'HTTPS', + # 'uri': 'login:password@IP_address:PORT' + # } + ) + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) \ No newline at end of file diff --git a/examples/geetest_v4.py b/examples/geetest_v4.py new file mode 100644 index 0000000..126a2e9 --- /dev/null +++ b/examples/geetest_v4.py @@ -0,0 +1,28 @@ +import sys +import os +import requests +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +try: + result = solver.geetest_v4(captcha_id='e392e1d7fd421dc63325744d5a2b9c73', + url='https://mysite.com/page/with//geetest-v4') + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/geetest_v4_options.py b/examples/geetest_v4_options.py new file mode 100644 index 0000000..12c9412 --- /dev/null +++ b/examples/geetest_v4_options.py @@ -0,0 +1,42 @@ +import sys +import os +import requests +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +config = { + 'server': 'solvecaptcha.com', + 'apiKey': api_key, + # 'callback': 'https://your.site/result-receiver', # If set, the solver will return only the `captchaId` without polling the API for the answer. + 'defaultTimeout': 120, + 'recaptchaTimeout': 600, + 'pollingInterval': 10, + } + +solver = Solvecaptcha(**config) + +try: + result = solver.geetest_v4(captcha_id='e392e1d7fd421dc63325744d5a2b9c73', + url='https://mysite.com/page/with//geetest-v4', + # 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/examples/grid.py b/examples/grid.py new file mode 100644 index 0000000..0f1554c --- /dev/null +++ b/examples/grid.py @@ -0,0 +1,30 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +try: + result = solver.grid('./images/grid_2.jpg', + hintText='Select all images with an Orange', + rows=3, + cols=3) + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/grid_base64.py b/examples/grid_base64.py new file mode 100644 index 0000000..4c21d74 --- /dev/null +++ b/examples/grid_base64.py @@ -0,0 +1,34 @@ +import sys +import os +from base64 import b64encode + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +with open('./images/grid_2.jpg', 'rb') as f: + b64 = b64encode(f.read()).decode('utf-8') + +try: + result = solver.grid(b64, + hintText='Select all images with an Orange', + rows=3, + cols=3) + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/grid_options.py b/examples/grid_options.py new file mode 100644 index 0000000..78e4230 --- /dev/null +++ b/examples/grid_options.py @@ -0,0 +1,36 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key, defaultTimeout=100, pollingInterval=12) + +try: + result = solver.grid( + file='./images/grid_2.jpg', + rows=3, + cols=3, + previousId=0, + canSkip=0, + lang='en', + hintImg='./images/grid_hint.jpg', + # hintText='Select all images with an Orange', + ) + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/hcaptcha.py b/examples/hcaptcha.py new file mode 100644 index 0000000..0015d4b --- /dev/null +++ b/examples/hcaptcha.py @@ -0,0 +1,34 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +try: + result = solver.hcaptcha( + sitekey='bf8ccfbf-6a05-45f6-982a-7a7964c2f50c', + url='https://portalunico.siscomex.gov.br', + ) + + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) + + + diff --git a/examples/hcaptcha_options.py b/examples/hcaptcha_options.py new file mode 100644 index 0000000..ea6dbf5 --- /dev/null +++ b/examples/hcaptcha_options.py @@ -0,0 +1,49 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +config = { + 'server': 'solvecaptcha.com', + 'apiKey': api_key, + # 'callback': 'https://your.site/result-receiver', # If set, the solver will return only the `captchaId` without polling the API for the answer. + 'defaultTimeout': 120, + 'recaptchaTimeout': 600, + 'pollingInterval': 10, + } + +solver = Solvecaptcha(**config) + +try: + result = solver.hcaptcha( + sitekey='bf8ccfbf-6a05-45f6-982a-7a7964c2f50c', + url='https://portalunico.siscomex.gov.br', + invisible=0, + domain="hcaptcha.com", + # 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/examples/images/canvas.jpg b/examples/images/canvas.jpg new file mode 100644 index 0000000000000000000000000000000000000000..8d4a70dbab631e840032b793fca4f1da116363c1 GIT binary patch literal 63893 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 literal 0 HcmV?d00001 diff --git a/examples/images/grid.jpg b/examples/images/grid.jpg new file mode 100644 index 0000000000000000000000000000000000000000..064e4aa14d8d5870b4ba1f7a4a1543f7a9935b9f GIT binary patch literal 40405 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 literal 0 HcmV?d00001 diff --git a/examples/images/grid_2.jpg b/examples/images/grid_2.jpg new file mode 100644 index 0000000000000000000000000000000000000000..b9ce6685ca23b96c38df0f1d121c407c13281bdc GIT binary patch literal 30347 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%0D7{ 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 E0MnFK^#A|> literal 0 HcmV?d00001 diff --git a/examples/images/normal.jpg b/examples/images/normal.jpg new file mode 100644 index 0000000000000000000000000000000000000000..f1770b3f545f5b18c6c5560dfdf37fa4662972a2 GIT binary patch literal 825 zcmeAS@N?(olHy`uVBq!ia0vp^CxF<7g9%8ku}nG!q&N#aB8wRq_>O=u<5X=vX$A(S z*PbqpAr*7p&e6>~>>$uOdDQ}Sj_qAtT!)ydrZvcEE2L{`XlrP#I#k@WNn}k*4Y5XtjT|gpt_lG< zOpQr`9OzOl?yvO&ICrPbkJ}TsPvqa%jh0{H?Bnf3|NR!YeRS^es@l3!KUTlLzyHyF zl?$sw#OK60dzEgy)V(D4COa7YG|^0Y7c%3O(7G4X_czqVOpH_OR{iqq@$-~>QJRy>UR%xnK4k@`vFDC6 zM^3HC{&h7#cU>FXfr8jzeg4l03^(>@XQza+yk94JRPQ=P2NjpyxXGG zclMylF|A1R8)e}_Ja=zJO!2s~QF8T4g9IZUsl0p9yIS=py}Th~a$4!h4WBI0Equ!g zSw+3={?0t#nHjKhXQ;)-oMx>9cSBGA{FG^`KJCrMwl%AE=U%_RN59Fa(^M!VWA&fy zZ(p+%U0CmGzdC|_?gag5=1Z@&wLdpge$uhEXz9A?>)-7#FM4yMtUUGflV^9QhWec| z;$Ut1_G$0s`41N#&g@LRv1GRr*IM66(Q1)TU!}Zc*?4WI?}WuVlOOhZHI;mR_t{kc zc96wMl>pf(yO-X%+g-J0;hIky(#>7ob^UBC|2s2qN<>j(*o{5X`;zV(O^Oc7?l_cG z8aUxha|GjIdDf4d0c#p6<=uP)d|S)!zf)34x>l)ka<|n@c|WnUYuYbNH0LqC6!d9< wysfhC>EEvQn>e&8z1u6Av7|I;B77+SYqI0Tb(ODufq8+!)78&qol`;+0O6>7ga7~l literal 0 HcmV?d00001 diff --git a/examples/images/normal_2.jpg b/examples/images/normal_2.jpg new file mode 100644 index 0000000000000000000000000000000000000000..a1f50355b6cc202368eee79e5551041167735248 GIT binary patch literal 5207 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 RaXo82UIlpiZ-H@#{{s=9O{f3> literal 0 HcmV?d00001 diff --git a/examples/keycaptcha.py b/examples/keycaptcha.py new file mode 100644 index 0000000..625ae5b --- /dev/null +++ b/examples/keycaptcha.py @@ -0,0 +1,32 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +try: + result = solver.keycaptcha( + s_s_c_user_id=184015, + s_s_c_session_id='e34ddd2c72e67593ac0b4ca8e4f44725', + s_s_c_web_server_sign='a5ebd41ae22348b2cdbdc211792e982d', + s_s_c_web_server_sign2='29255689423dd92990f8d06de50560d0', + url='https://mysite.com/page/with//keycaptcha') + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/keycaptcha_options.py b/examples/keycaptcha_options.py new file mode 100644 index 0000000..5979012 --- /dev/null +++ b/examples/keycaptcha_options.py @@ -0,0 +1,47 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + + +config = { + 'server': 'solvecaptcha.com', + 'apiKey': api_key, + # 'callback': 'https://your.site/result-receiver', # If set, the solver will return only the `captchaId` without polling the API for the answer. + 'defaultTimeout': 120, + 'recaptchaTimeout': 600, + 'pollingInterval': 10, + } + +solver = Solvecaptcha(**config) + +try: + result = solver.keycaptcha(s_s_c_user_id=184015, + s_s_c_session_id='e34ddd2c72e67593ac0b4ca8e4f44725', + s_s_c_web_server_sign='a5ebd41ae22348b2cdbdc211792e982d', + s_s_c_web_server_sign2='29255689423dd92990f8d06de50560d0', + url='https://mysite.com/page/with//keycaptcha', + # proxy = {'type': 'HTTPS', + # 'uri': 'login:password@IP_address:PORT'} + ) + + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) + + \ No newline at end of file diff --git a/examples/normal.py b/examples/normal.py new file mode 100644 index 0000000..65f7032 --- /dev/null +++ b/examples/normal.py @@ -0,0 +1,27 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +try: + result = solver.normal('./images/normal.jpg') + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/normal_base64.py b/examples/normal_base64.py new file mode 100644 index 0000000..21c0e70 --- /dev/null +++ b/examples/normal_base64.py @@ -0,0 +1,31 @@ +import sys +import os +from base64 import b64encode + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +with open('./images/normal.jpg', 'rb') as f: + b64 = b64encode(f.read()).decode('utf-8') + +try: + result = solver.normal(b64) + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/normal_options.py b/examples/normal_options.py new file mode 100644 index 0000000..92046eb --- /dev/null +++ b/examples/normal_options.py @@ -0,0 +1,38 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key, defaultTimeout=30, pollingInterval=5) + +try: + result = solver.normal( + './images/normal_2.jpg', + numeric=4, + minLen=4, + maxLen=20, + phrase=0, + caseSensitive=0, + calc=0, + lang='en', + # hintImg='./images/normal_hint.jpg', + # hintText='Type red symbols only', + ) + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/recaptcha_v2.py b/examples/recaptcha_v2.py new file mode 100644 index 0000000..2ddcfca --- /dev/null +++ b/examples/recaptcha_v2.py @@ -0,0 +1,33 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +try: + result = solver.recaptcha( + sitekey='6LdO5_IbAAAAAAeVBL9TClS19NUTt5wswEb3Q7C5', + url='https://mysite.com/page/with/recaptcha-v2' + ) + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) + + + diff --git a/examples/recaptcha_v2_options.py b/examples/recaptcha_v2_options.py new file mode 100644 index 0000000..8d59fea --- /dev/null +++ b/examples/recaptcha_v2_options.py @@ -0,0 +1,46 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + + +config = { + 'server': 'solvecaptcha.com', + 'apiKey': api_key, + # 'callback': 'https://your.site/result-receiver', # If set, the solver will return only the `captchaId` without polling the API for the answer. + 'defaultTimeout': 120, + 'recaptchaTimeout': 600, + 'pollingInterval': 10, + } + +solver = Solvecaptcha(**config) + +try: + result = solver.recaptcha( + sitekey='6LdO5_IbAAAAAAeVBL9TClS19NUTt5wswEb3Q7C5', + url='https://mysite.com/page/with//recaptcha-v2-invisible', + invisible=1, + # header_acao=1, + # pingback="http://mysite.com/pingback/url/", + # 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/examples/recaptcha_v3.py b/examples/recaptcha_v3.py new file mode 100644 index 0000000..8da27ef --- /dev/null +++ b/examples/recaptcha_v3.py @@ -0,0 +1,31 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +try: + result = solver.recaptcha( + sitekey='6LfdxboZAAAAAMtnONIt4DJ8J1t4wMC-kVG02zIO', + url='https://mysite.com/page/with//recaptcha-v3', + action='login', + version='v3') + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/recaptcha_v3_options.py b/examples/recaptcha_v3_options.py new file mode 100644 index 0000000..1c2626a --- /dev/null +++ b/examples/recaptcha_v3_options.py @@ -0,0 +1,46 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + + +config = { + 'server': 'solvecapcha.com', + 'apiKey': api_key, + # 'callback': 'https://your.site/result-receiver', # If set, the solver will return only the `captchaId` without polling the API for the answer. + 'defaultTimeout': 120, + 'recaptchaTimeout': 600, + 'pollingInterval': 10, + } + +solver = Solvecaptcha(**config) + +try: + result = solver.recaptcha( + sitekey='6LfdxboZAAAAAMtnONIt4DJ8J1t4wMC-kVG02zIO', + url='https://mysite.com/page/with//recaptcha-v3', + version='v3', + action='verify', + # 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/examples/rotate.py b/examples/rotate.py new file mode 100644 index 0000000..3d81db2 --- /dev/null +++ b/examples/rotate.py @@ -0,0 +1,27 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +try: + result = solver.rotate('./images/rotate.jpg') + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/rotate_options.py b/examples/rotate_options.py new file mode 100644 index 0000000..78a8a9c --- /dev/null +++ b/examples/rotate_options.py @@ -0,0 +1,32 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key, defaultTimeout=100, pollingInterval=10) + +try: + result = solver.rotate( + './images/rotate.jpg', + angle=40, + lang='en', + # hintImg = 'images/rotate_hint.jpg' + hintText='Put the images in the correct way up') + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/text.py b/examples/text.py new file mode 100644 index 0000000..cc6c8bc --- /dev/null +++ b/examples/text.py @@ -0,0 +1,28 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +try: + result = solver.text('If tomorrow is Saturday, what day is today?') + +except Exception as e: + sys.exit(e) + +else: + print(result) + sys.exit('result: ' + str(result)) diff --git a/examples/text_options.py b/examples/text_options.py new file mode 100644 index 0000000..9ea6f0f --- /dev/null +++ b/examples/text_options.py @@ -0,0 +1,28 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key, defaultTimeout=50, pollingInterval=10) + +try: + result = solver.text('If tomorrow is Saturday, what day is today?', + lang='en') + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/turnstile.py b/examples/turnstile.py new file mode 100644 index 0000000..d622c42 --- /dev/null +++ b/examples/turnstile.py @@ -0,0 +1,33 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + +solver = Solvecaptcha(api_key) + +try: + result = solver.turnstile( + sitekey='0x4AAAAAAAFhFmVSpJiMM20Z', + url='https://tvboom.net/packages/view/id/1/packages/view/id/1/', + useragent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36", + ) + +# {"sitekey":"0x4AAAAAAAFhFmVSpJiMM20Z","pageurl":"https:\/\/tvboom.net\/packages\/view\/id\/1\/packages\/view\/id\/1\/","pagedata":"","captchatype":"turnstile","data":"","action":"",","proxy":"","proxytype":"HTTP"} + +except Exception as e: + sys.exit(e) + +else: + sys.exit('result: ' + str(result)) diff --git a/examples/turnstile_options.py b/examples/turnstile_options.py new file mode 100644 index 0000000..0c1f62c --- /dev/null +++ b/examples/turnstile_options.py @@ -0,0 +1,47 @@ +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +# In this example, we store the API key in environment variables, which can be set as follows: +# On Linux or macOS: +# export APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# On Windows: +# set APIKEY_SOLVECAPTCHA=1abc234de56fab7c89012d34e56fa7b8 +# Alternatively, you can directly assign the API key to a variable: +# api_key = "1abc234de56fab7c89012d34e56fa7b8" + +api_key = os.getenv('APIKEY_SOLVECAPTCHA', 'YOUR_API_KEY') + + +config = { + 'server': 'solvecaptcha.com', + 'apiKey': api_key, + # 'callback': 'https://your.site/result-receiver', # If set, the solver will return only the `captchaId` without polling the API for the answer. + 'defaultTimeout': 120, + 'recaptchaTimeout': 600, + 'pollingInterval': 10, + } + +solver = Solvecaptcha(**config) + +try: + result = solver.turnstile(sitekey='0x4AAAAAAADnPIDROrmt1LDg', + url='https://dexscreener.com/', + data="8ffc47422ae4e297", + pagedata="JD.BAzfWHWAX2ZIXTgOkwU7SIJIXB3TYI6x0fplCxPo-1736508032-1.3.1.1-2Qy7twd2XO5laG9G6QrjYSQ.g3LszfU1A1osszzbbz.EHIJLRM4lHyZMnyTex7nIl7U8xVZrb99.lVWJ6RSSWG.0x_95kiDv.kqnQACTDl072eVFdyd1IRA.3SJsKl0ptevnsQx6pShakPgm2HWX65d5Jv.CDvbLLPSDz1SJk35ULnsY0fC9B_7NfgjEai5D2sYdYx5XxIIOOrQLkOHD963SqC6DQu9VXq09o8qlWsjHEORy_4VOsxf.7hjBw9y3Auziyh7ISo2mgAEHqCnYMjJtyLDqc4CGSnmYBRvSGMj96KvTLfSx2PCNxwWpUiEHb1WcM9Y1zjyz6.JVos.mjx5MDQ3UADASMJbtdWHMpH0yDfiDgtWNpxW1F.chfJ.q5MhSip4lLAXMVYLMDi.10C0pjIhwOHM0tuFhbyjAoq7MOfvL9t0sNQLKlrk1RUayK6alVy2Y0Zf1BH4p7lOSPQ", + action="managed", + useragent="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36", + # 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/requirements.txt b/requirements.txt new file mode 100644 index 0000000..1480256 --- /dev/null +++ b/requirements.txt @@ -0,0 +1 @@ +requests>=2.20.0 \ No newline at end of file diff --git a/setup.py b/setup.py new file mode 100644 index 0000000..c61f417 --- /dev/null +++ b/setup.py @@ -0,0 +1,41 @@ +#!/usr/bin/env python3 + +from setuptools import setup, find_packages +import re + +with open("README.md", "r") as fh: + long_description = fh.read() + + +def get_version(): + with open('solvecaptcha/__init__.py', 'r') as f: + return re.search(r'__version__ = ["\'](.*?)["\']', f.read()).group(1) + + +setup(name='solvecaptcha-python', + version=get_version(), + description='Python module for easy integration with solvecaptcha.com API', + long_description=long_description, + long_description_content_type="text/markdown", + url='https://github.com/solvercaptcha/solvecaptcha-python/', + install_requires=['requests'], + author='solvecaptcha.com', + author_email='info@solvecaptcha.com', + packages=find_packages(), + include_package_data=True, + classifiers=[ + "Programming Language :: Python :: 3", + "License :: OSI Approved :: MIT License", + "Operating System :: OS Independent", + "Topic :: Software Development :: Libraries :: Python Modules", + "Topic :: Scientific/Engineering :: Image Recognition", + "Topic :: Utilities", + "Intended Audience :: Developers", + ], + keywords=[ + 'solvecaptcha', 'captcha', 'api', 'captcha solver', 'reCAPTCHA', + 'FunCaptcha', 'Geetest', 'image captcha', 'Coordinates', 'Click Captcha', + 'Geetest V4', 'Lemin captcha', 'Amazon WAF', 'Cloudflare Turnstile', + 'hcaptcha'], + python_requires='>=3.6', + test_suite='tests') diff --git a/solvecaptcha/__init__.py b/solvecaptcha/__init__.py new file mode 100644 index 0000000..d364224 --- /dev/null +++ b/solvecaptcha/__init__.py @@ -0,0 +1,3 @@ +from .api import ApiClient +from .solver import (Solvecaptcha, SolverExceptions, ValidationException, + NetworkException, ApiException, TimeoutException) \ No newline at end of file diff --git a/solvecaptcha/api.py b/solvecaptcha/api.py new file mode 100644 index 0000000..d7eca11 --- /dev/null +++ b/solvecaptcha/api.py @@ -0,0 +1,117 @@ +#!/usr/bin/env python3 + +import requests + + +class NetworkException(Exception): + pass + + +class ApiException(Exception): + pass + + +class ApiClient(): + def __init__(self, post_url='api.solvecaptcha.com'): + self.post_url = post_url + + def in_(self, files={}, **kwargs): + ''' + + sends POST-request (files and/or params) to solve captcha + + Parameters + ---------- + files : TYPE, optional + DESCRIPTION. The default is {}. + **kwargs : TYPE + DESCRIPTION. + + Raises + ------ + NetworkException + DESCRIPTION. + ApiException + DESCRIPTION. + + Returns + ------- + resp : TYPE + DESCRIPTION. + + ''' + + try: + current_url = 'https://' + self.post_url + '/in.php' + if files: + + files = {key: open(path, 'rb') for key, path in files.items()} + resp = requests.post(current_url, + data=kwargs, + files=files) + + [f.close() for f in files.values()] + + elif 'file' in kwargs: + + with open(kwargs.pop('file'), 'rb') as f: + resp = requests.post(current_url, + data=kwargs, + files={'file': f}) + + else: + resp = requests.post(current_url, + data=kwargs) + + except requests.RequestException as e: + raise NetworkException(e) + + if resp.status_code != 200: + raise NetworkException(f'bad response: {resp.status_code}') + + resp = resp.content.decode('utf-8') + + if 'ERROR' in resp: + raise ApiException(resp) + + return resp + + def res(self, **kwargs): + ''' + sends additional GET-requests (solved captcha, balance, report etc.) + + Parameters + ---------- + **kwargs : TYPE + DESCRIPTION. + + Raises + ------ + NetworkException + DESCRIPTION. + ApiException + DESCRIPTION. + + Returns + ------- + resp : TYPE + DESCRIPTION. + + ''' + + try: + current_url_out = 'https://' + self.post_url + '/res.php' + resp = requests.get(current_url_out, params=kwargs) + + if resp.status_code != 200: + raise NetworkException(f'bad response: {resp.status_code}') + + resp = resp.content.decode('utf-8') + + if 'ERROR' in resp: + raise ApiException(resp) + + except requests.RequestException as e: + raise NetworkException(e) + + return resp diff --git a/solvecaptcha/solver.py b/solvecaptcha/solver.py new file mode 100644 index 0000000..c2353a3 --- /dev/null +++ b/solvecaptcha/solver.py @@ -0,0 +1,774 @@ +#!/usr/bin/env python3 + +import os, sys +import time +import requests +from base64 import b64encode + + +try: + from .api import ApiClient + +except ImportError: + from api import ApiClient + + +class SolverExceptions(Exception): + pass + + +class ValidationException(SolverExceptions): + pass + + +class NetworkException(SolverExceptions): + pass + + +class ApiException(SolverExceptions): + pass + + +class TimeoutException(SolverExceptions): + pass + + +class Solvecaptcha(): + def __init__(self, + apiKey, + softId=1000001, + callback=None, + defaultTimeout=120, + recaptchaTimeout=600, + pollingInterval=10, + server = 'api.solvecaptcha.com', + extendedResponse=None): + + self.API_KEY = apiKey + self.soft_id = softId + self.callback = callback + self.default_timeout = defaultTimeout + self.recaptcha_timeout = recaptchaTimeout + self.polling_interval = pollingInterval + self.api_client = ApiClient(post_url = str(server)) + self.max_files = 9 + self.exceptions = SolverExceptions + self.extendedResponse = extendedResponse + + def recaptcha(self, sitekey, url, version='v2', enterprise=0, **kwargs): + '''Wrapper for solving recaptcha (v2, v3). + + Parameters + _______________ + sitekey : str + Value of sitekey parameter you found on page. + url : str + Full URL of the page where you see the reCAPTCHA. + domain : str, optional + Domain used to load the captcha: google.com or recaptcha.net. Default: google.com. + invisible : int, optional + 1 - means that reCAPTCHA is invisible. 0 - normal reCAPTCHA. Default: 0. + version : str, optional + v3 — defines that you're sending a reCAPTCHA V3. Default: v2. + enterprise : str, optional + 1 - defines that you're sending reCAPTCHA Enterpise. Default: 0. + action : str, optional + Value of action parameter you found on page. Default: verify. + score : str, only for v3, optional + The score needed for resolution. Currently, it's almost impossible to get token with score higher than 0.3. + Default: 0.4. + cookies : str, only for v2, optional + Your cookies that will be passed to our worker who solve the captha. We also return worker's cookies in the + response if you use json=1. Format: KEY:Value, separator: semicolon, example: KEY1:Value1;KEY2:Value2; + userAgent : str, only for v2, optional + Your userAgent that will be passed to our worker and used to solve the captcha. + 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://solvecaptcha.com/captcha-solver-api#manage_pingback. + proxy : dict, optional + {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}. + ''' + + params = { + 'googlekey': sitekey, + 'url': url, + 'method': 'userrecaptcha', + 'version': version, + 'enterprise': enterprise, + **kwargs, + } + + result = self.solve(timeout=self.recaptcha_timeout, **params) + return result + + def hcaptcha(self, sitekey, url, **kwargs): + '''Wrapper for solving hcaptcha. + + Parameters + __________ + sitekey : str + Value of data-sitekey parameter you found on page. + url : str + Full URL of the page where you bypass the captcha. + invisible : num, optional + Use 1 for invisible version of hcaptcha. Currently it is a very rare case. + Default: 0. + data : str, optional + Custom data that is used in some implementations of hCaptcha, mostly with invisible=1. In most cases you see + it as rqdata inside network requests. Format: "data": "rqDataValue". + domain : str, optional + Domain used to load the captcha: hcaptcha.com or js.hcaptcha.com. Default: hcaptcha.com. + 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://solvecaptcha.com/captcha-solver-api#manage_pingback. + proxy : dict, optional + {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}. + ''' + + result = self.solve(sitekey=sitekey, + url=url, + method='hcaptcha', + **kwargs) + return result + + def turnstile(self, sitekey, url, **kwargs): + '''Wrapper for solving Cloudflare Turnstile. + + Parameters + __________ + sitekey : str + Value of sitekey parameter you found on page. + url : str + Full URL of the page where you see the captcha. + useragent : str + User-Agent of your browser. Must match the User-Agent you use to access the site. + Use only modern browsers released within the last 6 months. + action : str. optional + Value of optional action parameter you found on page, can be defined in data-action attribute or passed + to turnstile.render call. + data : str, optional + The value of cData passed to turnstile.render call. Also can be defined in data-cdata attribute. + pagedata : str, optional + The value of the chlPageData parameter when calling turnstile.render. + 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://solvecaptcha.com/captcha-solver-api#manage_pingback. + proxy : dict, optional + {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}. + ''' + + result = self.solve(sitekey=sitekey, + url=url, + method='turnstile', + **kwargs) + return result + + def geetest(self, gt, challenge, url, **kwargs): + '''Wrapper for solving geetest captcha. + + Parameters: + __________ + gt : str + Value of gt parameter you found on target website. + challenge : str + Value of challenge parameter you found on target website. + url : str + Full URL of the page where you see Geetest captcha. + offline : num, optional + In rare cases initGeetest can be called with offline parameter. If the call uses offline: true, set the + value to 1. Default: 0. + new_captcha : num, optional + In rare cases initGeetest can be called with new_captcha parameter. If the call uses new_captcha: true, set + the value to 1. Mostly used with offline parameter. + userAgent : str, optional + Your userAgent that will be passed to our worker and used to solve the captcha. + apiServer : str, optional + Value of api_server parameter you found on target website. + 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://solvecaptcha.com/captcha-solver-api#manage_pingback. + proxy : dict, optional + {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}. + ''' + + result = self.solve(gt=gt, + challenge=challenge, + url=url, + method='geetest', + **kwargs) + return result + + def geetest_v4(self, captcha_id, url, **kwargs): + '''Wrapper for solving geetest_v4 captcha. + + Parameters + __________ + captcha_id : str + Value of captcha_id parameter you found on target website. + url: str + Full URL of the page where you see Geetest captcha. + 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://solvecaptcha.com/captcha-solver-api#manage_pingback. + proxy : dict, optional + {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}. + ''' + + result = self.solve(captcha_id=captcha_id, + url=url, + method='geetest_v4', + **kwargs) + return result + + def normal(self, file, **kwargs): + '''Wrapper for solving a normal captcha (image). + + Parameters + __________ + file : file + Captcha image file. * required if you submit image as a file (method=post). + body : str + Base64-encoded captcha image. * required if you submit image as Base64-encoded string (method=base64). + phrase : int, optional + 0 - captcha contains one word. 1 - captcha contains two or more words. + Default: 0. + numeric : int, optional + 0 - not specified. 1 - captcha contains only numbers. 2 - captcha contains only letters. 3 - captcha + contains only numbers OR only letters. 4 - captcha MUST contain both numbers AND letters. + Default: 0 + minLen : int, optional + 0 - not specified. 1..20 - minimal number of symbols in captcha. + Default: 0. + maxLen : int, optional + 0 - not specified. 1..20 - maximal number of symbols in captcha. + Default: 0. + caseSensitive : int, optional + 0 - captcha in not case sensitive. 1 - captcha is case sensitive. + Default: 0. + calc : int, optional + 0 - not specified. 1 - captcha requires calculation (e.g. type the result 4 + 8 = ). + Default: 0. + lang : str, optional + Language code. See the list of supported languages https://solvecaptcha.com/captcha-solver-api#language. + hintText : str, optional + Max 140 characters. Endcoding: UTF-8. Text will be shown to worker to help him to solve the captcha correctly. + For example: type red symbols only. + hintImg : img, optional + Max 400x150px, 100 kB. Image with instruction for solving reCAPTCHA. Not required if you're sending + instruction as text with textinstructions. + 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://solvecaptcha.com/captcha-solver-api#manage_pingback. + ''' + + method = self.get_method(file) + result = self.solve(**method, **kwargs) + return result + + def text(self, text, **kwargs): + '''Wrapper for solving text captcha. + + Parameters + __________ + text : str + Max 140 characters. Endcoding: UTF-8. Text will be shown to worker to help him to solve the captcha correctly. + For example: type red symbols only. + lang: str, optional + Language code. See the list of supported languages https://solvecaptcha.com/captcha-solver-api#language. + 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://solvecaptcha.com/captcha-solver-api#manage_pingback. + ''' + + result = self.solve(text=text, method='post', **kwargs) + return result + + def funcaptcha(self, sitekey, url, **kwargs): + '''Wrapper for solving funcaptcha. + + Parameters + __________ + sitekey : str + Value of pk or data-pkey parameter you found on page. + url : str + Full URL of the page where you see the FunCaptcha. + surl : str, optional + Value of surl parameter you found on page. + userAgent: str, optional + Tells us to use your user-agent value. + data[key] : str, optional + Custom data to pass to FunCaptcha. For example: data[blob]=stringValue. + 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://solvecaptcha.com/captcha-solver-api#manage_pingback. + proxy : dict, optional + {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}. + ''' + + result = self.solve(publickey=sitekey, + url=url, + method='funcaptcha', + **kwargs) + return result + + def keycaptcha(self, s_s_c_user_id, s_s_c_session_id, + s_s_c_web_server_sign, s_s_c_web_server_sign2, url, + **kwargs): + '''Wrapper for solving. + + Parameters + __________ + s_s_c_user_id : str + Value of s_s_c_user_id parameter you found on page. + s_s_c_session_id : str + Value of s_s_c_session_id parameter you found on page. + s_s_c_web_server_sign : str + Value of s_s_c_web_server_sign parameter you found on page. + s_s_c_web_server_sign2 : str + Value of s_s_c_web_server_sign2 parameter you found on page. + url : str + Full URL of the page where you see the KeyCaptcha. + 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://solvecaptcha.com/captcha-solver-api#manage_pingback. + proxy : dict, optional + {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}. + ''' + + params = { + 's_s_c_user_id': s_s_c_user_id, + 's_s_c_session_id': s_s_c_session_id, + 's_s_c_web_server_sign': s_s_c_web_server_sign, + 's_s_c_web_server_sign2': s_s_c_web_server_sign2, + 'url': url, + 'method': 'keycaptcha', + **kwargs, + } + + result = self.solve(**params) + return result + + def grid(self, file, **kwargs): + '''Wrapper for solving grid captcha (image). + + Required: + file : file + Captcha image file. * required if you submit image as a file (method=post). + body : str + Base64-encoded captcha image. * required if you submit image as Base64-encoded string (method=base64). + hintText : str + Max 140 characters. Endcoding: UTF-8. Text with instruction for solving reCAPTCHA. For example: select images + with trees. Not required if you're sending instruction as an image with imginstructions. + hintImg : img + Max 400x150px, 100 kB. Image with instruction for solving reCAPTCHA. Not required if you're sending + instruction as text with textinstructions. + rows : int, optional + Number of rows in reCAPTCHA grid. + cols : itn, optional + Number of columns in reCAPTCHA grid. + previousId : str, optional + Id of your previous request with the same captcha challenge. + canSkip : int, optional + 0 - not specified. 1 - possibly there's no images that fit the instruction. Set the value to 1 only if it's + possible that there's no images matching to the instruction. We'll provide a button "No matching images" to + worker, and you will receive No_matching_images as answer. + Default: 0. + lang: str, optional + Language code. See the list of supported languages https://solvecaptcha.com/captcha-solver-api#language. + 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://solvecaptcha.com/captcha-solver-api#manage_pingback. + proxy : dict, optional + {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}. + ''' + + method = self.get_method(file) + + params = { + 'recaptcha': 1, + **method, + **kwargs, + } + + result = self.solve(**params) + return result + + def coordinates(self, file, **kwargs): + '''Wrapper for solving coordinates captcha (image). + + Parameters + __________ + file : file + Captcha image file. * required if you submit image as a file (method=post). + body : str + Base64-encoded captcha image. * required if you submit image as Base64-encoded string (method=base64). + hintText : str + Max 140 characters. Endcoding: UTF-8. Text with instruction for solving the captcha. For example: click on + images with ghosts. Not required if the image already contains the instruction. + hintImg : img + Max 400x150px, 100 kB. Image with instruction for solving reCAPTCHA. Not required if you're sending + instruction as text with textinstructions. + lang : str, optional + Language code. See the list of supported languages https://solvecaptcha.com/captcha-solver-api#language. + 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://solvecaptcha.com/captcha-solver-api#manage_pingback. + ''' + + method = self.get_method(file) + + params = { + 'coordinatescaptcha': 1, + **method, + **kwargs, + } + + result = self.solve(**params) + return result + + def rotate(self, files, **kwargs): + '''Wrapper for solving rotate captcha (image). + + Parameters + __________ + files : file + Captcha image file. * required if you submit image as a file (method=post). + body : str + Base64-encoded captcha image. * required if you submit image as Base64-encoded string (method=base64). + angle : int, optional + Angle for one rotation step in degrees. If not defined we'll use the default value for FunCaptcha: 40 degrees. + Default: 40. + lang : str, optional + Language code. See the list of supported languages https://solvecaptcha.com/captcha-solver-api#language. + hintImg : str, optional + Image with instruction for worker to help him to solve captcha correctly. + hintText : str, optional + Text will be shown to worker to help him to to solve captcha correctly. + 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://solvecaptcha.com/captcha-solver-api#manage_pingback. + proxy : dict, optional + {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}. + ''' + + if isinstance(files, str): + + file = self.get_method(files)['file'] + + result = self.solve(file=file, method='rotatecaptcha', **kwargs) + return result + + elif isinstance(files, dict): + files = list(files.values()) + + files = self.extract_files(files) + + result = self.solve(files=files, method='rotatecaptcha', **kwargs) + return result + + def canvas(self, file, **kwargs): + '''Wrapper for solving canvas captcha (image). + + Parameters + __________ + file : file + Captcha image file. * required if you submit image as a file (method=post). + body : str + Base64-encoded captcha image. * required if you submit image as Base64-encoded string (method=base64). + hintText : str + Max 140 characters. Endcoding: UTF-8. Text with instruction for solving reCAPTCHA. For example: select + images with trees. Not required if you're sending instruction as an image with imginstructions. + hintImg : img + Max 400x150px, 100 kB. Image with instruction for solving reCAPTCHA. Not required if you're sending + instruction as text with textinstructions. + canSkip : int, optional + 0 - not specified. 1 - possibly there's no images that fit the instruction. Set the value to 1 only if it's + possible that there's no images matching to the instruction. We'll provide a button "No matching images" to + worker, and you will receive No_matching_images as answer. + Default: 0. + lang : int, optional + 0 - not specified. 1 - Cyrillic captcha. 2 - Latin captcha. + Default: 0. + 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://solvecaptcha.com/captcha-solver-api#manage_pingback. + ''' + + if not ('hintText' in kwargs or 'hintImg' in kwargs): + raise ValidationException( + 'parameters required: hintText and/or hintImg') + + method = self.get_method(file) + + params = { + 'recaptcha': 1, + 'canvas': 1, + **method, + **kwargs, + } + + result = self.solve(**params) + return result + + def solve(self, timeout=0, polling_interval=0, **kwargs): + '''Sends captcha, receives result. + + Parameters + __________ + timeout : float + + polling_interval : int + + **kwargs : dict + all captcha params + + Returns + + result : string + ''' + + id_ = self.send(**kwargs) + result = {'captchaId': id_} + + if self.callback is None: + timeout = float(timeout or self.default_timeout) + sleep = int(polling_interval or self.polling_interval) + + code = self.wait_result(id_, timeout, sleep) + + if self.extendedResponse == True: + + new_code = { + key if key != 'request' else 'code': value + for key, value in code.items() + if key != 'status' + } + result.update(new_code) + else: + result.update({'code': code}) + + return result + + def wait_result(self, id_, timeout, polling_interval): + + max_wait = time.time() + timeout + + while time.time() < max_wait: + + try: + return self.get_result(id_) + + except NetworkException: + + time.sleep(polling_interval) + + raise TimeoutException(f'timeout {timeout} exceeded') + + def get_method(self, file): + + if not file: + raise ValidationException('File required') + + if not '.' in file and len(file) > 50: + return {'method': 'base64', 'body': file} + + if file.startswith('http'): + img_resp = requests.get(file) + if img_resp.status_code != 200: + raise ValidationException(f'File could not be downloaded from url: {file}') + return {'method': 'base64', 'body': b64encode(img_resp.content).decode('utf-8')} + + if not os.path.exists(file): + raise ValidationException(f'File not found: {file}') + + return {'method': 'post', 'file': file} + + def send(self, **kwargs): + """This method can be used for manual captcha submission + + Parameters + _________ + method : str + The name of the method must be found in the documentation https://solvecaptcha.com/captcha-solver-api + kwargs: dict + All captcha params + Returns + + """ + + params = self.default_params(kwargs) + params = self.rename_params(params) + + params, files = self.check_hint_img(params) + + response = self.api_client.in_(files=files, **params) + + if not response.startswith('OK|'): + raise ApiException(f'cannot recognize response {response}') + + return response[3:] + + def get_result(self, id_): + import json + """This method can be used for manual captcha answer polling. + + Parameters + __________ + id_ : str + ID of the captcha sent for solution + Returns + + answer : text + """ + + if self.extendedResponse == True: + + response = self.api_client.res(key=self.API_KEY, action='get', id=id_, json=1) + + response_data = json.loads(response) + + if response_data.get("status") == 0: + raise NetworkException + + if not response_data.get("status") == 1: + raise ApiException(f'Unexpected status in response: {response_data}') + + return response_data + + else: + + response = self.api_client.res(key=self.API_KEY, action='get', id=id_) + + if response == 'CAPCHA_NOT_READY': + raise NetworkException + + if not response.startswith('OK|'): + raise ApiException(f'cannot recognize response {response}') + + return response[3:] + + def balance(self): + '''Get my balance + + Returns + + balance : float + ''' + + response = self.api_client.res(key=self.API_KEY, action='getbalance') + return float(response) + + def report(self, id_, correct): + '''Report of solved captcha: good/bad. + + Parameters + __________ + id_ : str + captcha ID + + correct : bool + True/False + + Returns + None. + + ''' + + rep = 'reportgood' if correct else 'reportbad' + self.api_client.res(key=self.API_KEY, action=rep, id=id_) + + return + + def rename_params(self, params): + + replace = { + 'caseSensitive': 'regsense', + 'minLen': 'min_len', + 'maxLen': 'max_len', + 'minLength': 'min_len', + 'maxLength': 'max_len', + 'hintText': 'textinstructions', + 'hintImg': 'imginstructions', + 'url': 'pageurl', + 'score': 'min_score', + 'text': 'textcaptcha', + 'rows': 'recaptcharows', + 'cols': 'recaptchacols', + 'previousId': 'previousID', + 'canSkip': 'can_no_answer', + 'apiServer': 'api_server', + 'softId': 'soft_id', + 'callback': 'pingback', + 'datas': 'data-s', + } + + new_params = { + v: params.pop(k) + for k, v in replace.items() if k in params + } + + proxy = params.pop('proxy', '') + proxy and new_params.update({ + 'proxy': proxy['uri'], + 'proxytype': proxy['type'] + }) + + new_params.update(params) + + return new_params + + def default_params(self, params): + + params.update({'key': self.API_KEY}) + + callback = params.pop('callback', self.callback) + soft_id = params.pop('softId', self.soft_id) + + if callback: params.update({'callback': callback}) + if soft_id: params.update({'softId': soft_id}) + + self.has_callback = bool(callback) + + return params + + def extract_files(self, files): + + if len(files) > self.max_files: + raise ValidationException( + f'Too many files (max: {self.max_files})') + + not_exists = [f for f in files if not (os.path.exists(f))] + + if not_exists: + raise ValidationException(f'File not found: {not_exists}') + + files = {f'file_{e+1}': f for e, f in enumerate(files)} + return files + + def check_hint_img(self, params): + + hint = params.pop('imginstructions', None) + files = params.pop('files', {}) + + if not hint: + return params, files + + if not '.' in hint and len(hint) > 50: + params.update({'imginstructions': hint}) + return params, files + + if not os.path.exists(hint): + raise ValidationException(f'File not found: {hint}') + + if not files: + files = {'file': params.pop('file', {})} + + files.update({'imginstructions': hint}) + + return params, files + + +if __name__ == '__main__': + + key = sys.argv[1] + sol = Solvecaptcha(key) \ No newline at end of file diff --git a/tests/abstract.py b/tests/abstract.py new file mode 100755 index 0000000..6806489 --- /dev/null +++ b/tests/abstract.py @@ -0,0 +1,67 @@ +#!/usr/bin/env python3 +import unittest +import sys +import os + +sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))) + +from solvecaptcha import Solvecaptcha + +captcha_id = '123' +code = 'abcd' + + +class ApiClient(): + def in_(self, files={}, **kwargs): + + self.incomings = kwargs + self.incoming_files = files + + return 'OK|' + captcha_id + + def res(self, **kwargs): + + return 'OK|' + code # {'code': code} + + +class AbstractTest(unittest.TestCase): + def setUp(self): + + self.solver = Solvecaptcha('API_KEY', pollingInterval=1) + self.solver.api_client = ApiClient() + + def send_return(self, for_send, method, **kwargs): + + file = kwargs.pop('file', {}) + file = kwargs.pop('files', file) + + result = method(file, **kwargs) if file else method(**kwargs) + + incomings = self.solver.api_client.incomings + for_send.update({'key': 'API_KEY'}) + for_send.update({'soft_id': 1000001}) + + files = for_send.pop('files', {}) + self.assertEqual(incomings, for_send) + + incoming_files = self.solver.api_client.incoming_files + incoming_files and self.assertEqual(incoming_files, files) + + self.assertIsInstance(result, dict) + self.assertIn('code', result) + self.assertEqual(result['code'], code) + + def invalid_file(self, method, **kwargs): + + self.assertRaises(self.solver.exceptions, method, 'lost_file', + **kwargs) + + def too_many_files(self, method, **kwargs): + + files = ['../examples/images/rotate.jpg'] * (self.solver.max_files + 1) + self.assertRaises(self.solver.exceptions, method, files, **kwargs) + + +if __name__ == '__main__': + + unittest.main() diff --git a/tests/test_coordinates.py b/tests/test_coordinates.py new file mode 100755 index 0000000..c09357e --- /dev/null +++ b/tests/test_coordinates.py @@ -0,0 +1,84 @@ +#!/usr/bin/env python3 + +import unittest + + +file = '../examples/images/grid.jpg' +hint_img = '../examples/images/grid_hint.jpg' +hint_text = 'Select all images with an Orange' +checks = {'coordinatescaptcha': 1} + + +try: + from .abstract import AbstractTest + + file = file[3:] + hint_img = hint_img[3:] + +except ImportError: + from abstract import AbstractTest + + + + + + +class CoordinatesTest(AbstractTest): + + def test_file_param(self): + + sends = {'method': 'post', 'file': file, **checks} + return self.send_return(sends, self.solver.coordinates, file=file) + + + + def test_base64_param(self): + + b64 = 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA' + sends = { + 'method': 'base64', + 'body' : b64, + **checks, + } + + return self.send_return(sends, self.solver.coordinates, file=b64) + + + + def test_all_params(self): + + params = { + 'lang' : 'en', + 'hintImg' : hint_img, + 'hintText' : hint_text + } + + + sends = { + 'method' : 'post', + 'lang' : 'en', + 'files' : {'file': file,'imginstructions': hint_img}, + 'textinstructions' : hint_text, + **checks + } + + return self.send_return(sends, self.solver.coordinates, file=file, **params) + + + + def test_not_found(self): + + return self.invalid_file(self.solver.coordinates) + + + + + + + + + +if __name__ == '__main__': + + unittest.main() + diff --git a/tests/test_funcaptcha.py b/tests/test_funcaptcha.py new file mode 100755 index 0000000..9872598 --- /dev/null +++ b/tests/test_funcaptcha.py @@ -0,0 +1,44 @@ +#!/usr/bin/env python3 + +import unittest + +try: + from .abstract import AbstractTest +except ImportError: + from abstract import AbstractTest + + + +class FuncaptchaTest(AbstractTest): + + + def test_all_params(self): + + + params = { + 'sitekey' : '69A21A01-CC7B-B9C6-0F9A-E7FA06677FFC', + 'url' : 'https://mysite.com/page/with/funcaptcha', + 'surl' : 'https://client-api.arkoselabs.com', + 'userAgent' : 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.61 Safari/537.36', + 'data' : {'anyKey' : 'anyStringValue'}, + } + + sends = { + 'method' : 'funcaptcha', + 'publickey' : '69A21A01-CC7B-B9C6-0F9A-E7FA06677FFC', + 'pageurl' : 'https://mysite.com/page/with/funcaptcha', + 'surl' : 'https://client-api.arkoselabs.com', + 'userAgent' : 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.61 Safari/537.36', + 'data' : {'anyKey' : 'anyStringValue'}, + } + + return self.send_return(sends, self.solver.funcaptcha, **params) + + + + + +if __name__ == '__main__': + + unittest.main() + diff --git a/tests/test_geetest.py b/tests/test_geetest.py new file mode 100755 index 0000000..e62f807 --- /dev/null +++ b/tests/test_geetest.py @@ -0,0 +1,41 @@ +#!/usr/bin/env python3 + +import unittest + +try: + from .abstract import AbstractTest +except ImportError: + from abstract import AbstractTest + + + +class GeeTest(AbstractTest): + + + def test_all_params(self): + + + params = { + 'gt' : 'f2ae6cadcf7886856696502e1d55e00c', + 'apiServer' : 'api-na.geetest.com', + 'challenge' : '69A21A01-CC7B-B9C6-0F9A-E7FA06677FFC', + 'url' : 'https://launches.endclothing.com/distil_r_captcha.html', } + + sends = { + 'method' : 'geetest', + 'gt' : 'f2ae6cadcf7886856696502e1d55e00c', + 'api_server' : 'api-na.geetest.com', + 'challenge' : '69A21A01-CC7B-B9C6-0F9A-E7FA06677FFC', + 'pageurl' : 'https://launches.endclothing.com/distil_r_captcha.html', + } + + return self.send_return(sends, self.solver.geetest, **params) + + + + + +if __name__ == '__main__': + + unittest.main() + diff --git a/tests/test_geetest_v4.py b/tests/test_geetest_v4.py new file mode 100755 index 0000000..70c2df2 --- /dev/null +++ b/tests/test_geetest_v4.py @@ -0,0 +1,34 @@ +#!/usr/bin/env python3 + +import unittest + +try: + from .abstract import AbstractTest +except ImportError: + from abstract import AbstractTest + + + +class GeeTest_V4(AbstractTest): + + + def test_all_params(self): + + + params = { + 'captcha_id': 'e392e1d7fd421dc63325744d5a2b9c73', + 'url' : 'https://mysite.com/page/with/geetest-v4', } + + sends = { + 'method' : 'geetest_v4', + 'captcha_id' : 'e392e1d7fd421dc63325744d5a2b9c73', + 'pageurl' : 'https://mysite.com/page/with/geetest-v4', + } + + return self.send_return(sends, self.solver.geetest_v4, **params) + + +if __name__ == '__main__': + + unittest.main() + diff --git a/tests/test_grid.py b/tests/test_grid.py new file mode 100755 index 0000000..1c7d80f --- /dev/null +++ b/tests/test_grid.py @@ -0,0 +1,91 @@ +#!/usr/bin/env python3 + +import unittest + + +file = '../examples/images/grid.jpg' +hint_img = '../examples/images/grid_hint.jpg' +hint_text = 'Select all images with an Orange' + + +try: + from .abstract import AbstractTest + + file = file[3:] + hint_img = hint_img[3:] + +except ImportError: + from abstract import AbstractTest + + + + + + +class GridTest(AbstractTest): + + def test_file_param(self): + + sends = {'method': 'post', 'file': file, 'recaptcha': 1} + return self.send_return(sends, self.solver.grid, file=file) + + + + def test_base64_param(self): + + b64 = 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA' + sends = { + 'method' : 'base64', + 'body' : b64, + 'recaptcha' : 1 + } + + return self.send_return(sends, self.solver.grid, file=b64) + + + + def test_all_params(self): + + params = { + 'rows' : 3, + 'cols' : 3, + 'previousId' : 0, + 'canSkip' : 0, + 'lang' : 'en', + 'hintImg' : hint_img, + 'hintText' : hint_text + } + + + sends = { + 'method' : 'post', + 'recaptcha' : 1, + 'recaptcharows' : 3, + 'recaptchacols' : 3, + 'previousID' : 0, + 'can_no_answer' : 0, + 'lang' : 'en', + 'files' : {'file': file,'imginstructions': hint_img}, + 'textinstructions' : hint_text, + } + + return self.send_return(sends, self.solver.grid, file=file, **params) + + + + def test_not_found(self): + + return self.invalid_file(self.solver.grid) + + + + + + + + + +if __name__ == '__main__': + + unittest.main() + diff --git a/tests/test_hcaptcha.py b/tests/test_hcaptcha.py new file mode 100755 index 0000000..84f765e --- /dev/null +++ b/tests/test_hcaptcha.py @@ -0,0 +1,38 @@ +#!/usr/bin/env python3 + +import unittest + +try: + from .abstract import AbstractTest +except ImportError: + from abstract import AbstractTest + + + +class HcaptchaTest(AbstractTest): + + + def test_all_params(self): + + + params = { + 'sitekey' : 'f1ab2cdefa3456789012345b6c78d90e', + 'url' : 'https://www.site.com/page/', + } + + sends = { + 'method' : 'hcaptcha', + 'sitekey' : 'f1ab2cdefa3456789012345b6c78d90e', + 'pageurl' : 'https://www.site.com/page/', + } + + return self.send_return(sends, self.solver.hcaptcha, **params) + + + + + +if __name__ == '__main__': + + unittest.main() + diff --git a/tests/test_keycaptcha.py b/tests/test_keycaptcha.py new file mode 100755 index 0000000..a31c88c --- /dev/null +++ b/tests/test_keycaptcha.py @@ -0,0 +1,44 @@ +#!/usr/bin/env python3 + +import unittest + +try: + from .abstract import AbstractTest +except ImportError: + from abstract import AbstractTest + + + +class KeyCaptchaTest(AbstractTest): + + + def test_all_params(self): + + + params = { + 's_s_c_user_id' : 10, + 's_s_c_session_id' : '493e52c37c10c2bcdf4a00cbc9ccd1e8', + 's_s_c_web_server_sign' : '9006dc725760858e4c0715b835472f22-pz-', + 's_s_c_web_server_sign2' : '2ca3abe86d90c6142d5571db98af6714', + 'url' : 'https://www.keycaptcha.ru/demo-magnetic/', + } + + sends = { + 'method' : 'keycaptcha', + 's_s_c_user_id' : 10, + 's_s_c_session_id' : '493e52c37c10c2bcdf4a00cbc9ccd1e8', + 's_s_c_web_server_sign' : '9006dc725760858e4c0715b835472f22-pz-', + 's_s_c_web_server_sign2' : '2ca3abe86d90c6142d5571db98af6714', + 'pageurl' : 'https://www.keycaptcha.ru/demo-magnetic/', + } + + return self.send_return(sends, self.solver.keycaptcha, **params) + + + + + +if __name__ == '__main__': + + unittest.main() + diff --git a/tests/test_normal.py b/tests/test_normal.py new file mode 100644 index 0000000..22f3688 --- /dev/null +++ b/tests/test_normal.py @@ -0,0 +1,102 @@ +#!/usr/bin/env python3 + +import unittest + +file = '../examples/images/normal.jpg' +hint_img = '../examples/images/grid_hint.jpg' + + +try: + from .abstract import AbstractTest + + file = file[3:] + hint_img = hint_img[3:] + +except ImportError: + from abstract import AbstractTest + + + + +class NormalTest(AbstractTest): + + def test_file(self): + + sends = {'method': 'post', 'file': file} + return self.send_return(sends, self.solver.normal, file=file) + + + + # def test_file_params(self): + + # return self.test_send_return(self.method, self.file, method='post') + + + + def test_base64(self): + + b64 = 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA' + sends = { + 'method': 'base64', + 'body' : b64, + } + + return self.send_return(sends, self.solver.normal, file=b64) + + + + def test_all_params(self): + + + params = { + 'numeric' : 4, + 'minLen' : 4, + 'maxLen' : 20, + 'phrase' : 1, + 'caseSensitive' : 1, + 'calc' : 0, + 'lang' : 'en', + 'hintImg' : hint_img, + 'hintText' : 'Type red symbols only', + } + + + sends = { + 'files' : {'file': file,'imginstructions': hint_img}, + 'method' : 'post', + 'numeric' : 4, + 'min_len' : 4, + 'max_len' : 20, + 'phrase' : 1, + 'regsense' : 1, + 'calc' : 0, + 'lang' : 'en', + 'textinstructions' : 'Type red symbols only', + } + + # files = { + # 'file' : file, + # 'imginstructions' : hint, + # } + + return self.send_return(sends, self.solver.normal, file=file, **params) + + + + def test_not_found(self): + + return self.invalid_file(self.solver.normal) + + + + + + + + + + +if __name__ == '__main__': + + unittest.main() + diff --git a/tests/test_recaptcha.py b/tests/test_recaptcha.py new file mode 100755 index 0000000..47a9bc1 --- /dev/null +++ b/tests/test_recaptcha.py @@ -0,0 +1,64 @@ +#!/usr/bin/env python3 + +import unittest + +try: + from .abstract import AbstractTest +except ImportError: + from abstract import AbstractTest + + + +class RecaptchaTest(AbstractTest): + + + def test_v2(self): + + params = { + 'sitekey' : '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-', + 'url' : 'https://mysite.com/page/with/recaptcha', + 'invisible' : 1, + 'action' : 'verify', + } + + sends = { + 'method' : 'userrecaptcha', + 'googlekey' : '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-', + 'pageurl' : 'https://mysite.com/page/with/recaptcha', + 'invisible': 1, + 'enterprise': 0, + 'action' : 'verify', + 'version' : 'v2', + } + + return self.send_return(sends, self.solver.recaptcha, **params) + + + def test_v3(self): + + params = { + 'sitekey' : '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-', + 'url' : 'https://mysite.com/page/with/recaptcha', + 'invisible' : 1, + 'action' : 'verify', + 'version' : 'v3', + } + + sends = { + 'method' : 'userrecaptcha', + 'googlekey' : '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-', + 'pageurl' : 'https://mysite.com/page/with/recaptcha', + 'invisible' : 1, + 'enterprise': 0, + 'action' : 'verify', + 'version' : 'v3', + } + + return self.send_return(sends, self.solver.recaptcha, **params) + + + +if __name__ == '__main__': + + unittest.main() + diff --git a/tests/test_text.py b/tests/test_text.py new file mode 100755 index 0000000..f1540ee --- /dev/null +++ b/tests/test_text.py @@ -0,0 +1,40 @@ +#!/usr/bin/env python3 +import unittest + +try: + from .abstract import AbstractTest +except ImportError: + from abstract import AbstractTest + + +class TextTest(AbstractTest): + def test_only_text(self): + + sends = { + 'method': 'post', + 'textcaptcha': 'Today is monday?', + } + + return self.send_return(sends, + self.solver.text, + text='Today is monday?') + + def test_all_params(self): + + params = { + 'text': 'Today is monday?', + 'lang': 'en', + } + + sends = { + 'method': 'post', + 'textcaptcha': 'Today is monday?', + 'lang': 'en', + } + + return self.send_return(sends, self.solver.text, **params) + + +if __name__ == '__main__': + + unittest.main() diff --git a/tests/test_turnstile.py b/tests/test_turnstile.py new file mode 100755 index 0000000..983a268 --- /dev/null +++ b/tests/test_turnstile.py @@ -0,0 +1,36 @@ +#!/usr/bin/env python3 + +import unittest + +try: + from .abstract import AbstractTest +except ImportError: + from abstract import AbstractTest + +class TurnstileTest(AbstractTest): + + + def test_all_params(self): + + + params = { + 'sitekey' : '0x4AAAAAAAC3DHQFLr1GavRN', + 'url' : 'https://www.site.com/page/', + 'action' : 'foo', + 'data' : 'bar' + } + + sends = { + 'method' : 'turnstile', + 'sitekey' : '0x4AAAAAAAC3DHQFLr1GavRN', + 'action' : 'foo', + 'data' : 'bar', + 'pageurl' : 'https://www.site.com/page/', + } + + return self.send_return(sends, self.solver.turnstile, **params) + + +if __name__ == '__main__': + + unittest.main()