2captcha-python 1.2.7__py3-none-any.whl → 1.2.8__py3-none-any.whl

{2captcha_python-1.2.7.dist-info → 2captcha_python-1.2.8.dist-info}/METADATA

@@ -1,20 +1,25 @@
 Metadata-Version: 2.1
 Name: 2captcha-python
-Version: 1.2.7
+Version: 1.2.8
 Summary: Python module for easy integration with 2Captcha API
 Home-page: https://github.com/2captcha/2captcha-python/
 Author: 2Captcha
 Author-email: info@2captcha.com
+Keywords: 2captcha,captcha,api,captcha solver,reCAPTCHA,hCaptcha,FunCaptcha,Geetest,image captcha,Coordinates,Click Captcha,Geetest V4,Lemin captcha,Amazon WAF,Cloudflare Turnstile,Capy Puzzle,MTCaptcha,Friendly Captcha,Tencent
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Image Recognition
+Classifier: Topic :: Utilities
+Classifier: Intended Audience :: Developers
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests
 
 # Python Module for 2Captcha API
-The easiest way to quickly integrate the 2Captcha captcha-solving service into your code and automate the solving of any type of captcha.
+The easiest way to quickly integrate the [2Captcha] captcha-solving service into your code and automate the solving of any type of captcha.
 
 - [Python Module for 2Captcha API](#python-module-for-2captcha-api)
   - [Installation](#installation)
@@ -29,8 +34,8 @@ The easiest way to quickly integrate the 2Captcha captcha-solving service into y
     - [reCAPTCHA v3](#recaptcha-v3)
     - [FunCaptcha](#funcaptcha)
     - [GeeTest](#geetest)
-    - [hCaptcha](#hcaptcha)
     - [GeeTest v4](#geetest-v4)
+    - [hCaptcha](#hcaptcha)
     - [Lemin Cropped Captcha](#lemin-cropped-captcha)
     - [Cloudflare Turnstile](#cloudflare-turnstile)
     - [Amazon WAF](#amazon-waf)
@@ -49,10 +54,11 @@ The easiest way to quickly integrate the 2Captcha captcha-solving service into y
     - [send / get_result](#send--get_result)
     - [balance](#balance)
     - [report](#report)
-    - [Error handling](#error-handling)
-    - [Proxies](#proxies)
-    - [Async calls](#async-calls)
+  - [Error handling](#error-handling)
+  - [Proxies](#proxies)
+  - [Async calls](#async-calls)
   - [Examples](#examples)
+  - [Useful articles](#useful-articles)
 
 ## Installation
 
@@ -89,16 +95,18 @@ solver = TwoCaptcha(**config)
 
 ### TwoCaptcha instance options
 
-| Option           | Default value  | Description                                                                                                                                        |
-| ---------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
-| server           | `2captcha.com` | API server. You can set it to `rucaptcha.com` if your account is registered there                                                                  |
-| softId           | -              | your software ID obtained after publishing in [2captcha software catalog]                                                                           |
-| callback         | -              | URL of your web server that receives the captcha recognition result. The URL should be first registered in [pingback settings] of your account      |
+| Option           | Default value  | Description                                                                                                                                            |
+| ---------------- | -------------- |--------------------------------------------------------------------------------------------------------------------------------------------------------|
+| server           | `2captcha.com` | API server. You can set it to `rucaptcha.com` if your account is registered there                                                                      |
+| softId           | 4580           | your software ID obtained after publishing in [2captcha software catalog]                                                                              |
+| callback         | -              | URL of your web server that receives the captcha recognition result. The URL should be first registered in [pingback settings] of your account         |
 | defaultTimeout   | 120            | Polling timeout in seconds for all captcha types except reCAPTCHA. Defines how long the module tries to get the answer from the `res.php` API endpoint |
 | recaptchaTimeout | 600            | Polling timeout for reCAPTCHA in seconds. Defines how long the module tries to get the answer from the `res.php` API endpoint                          |
 | pollingInterval  | 10             | Interval in seconds between requests to the `res.php` API endpoint. Setting values less than 5 seconds is not recommended                              |
 
-> **IMPORTANT:** Once `callback` is defined for the `TwoCaptcha` 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.
+> [!IMPORTANT]
+> Once `callback` is defined for the `TwoCaptcha` 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 [get_result method](#send--get_result)
 
 ## Solve captcha
@@ -234,7 +242,7 @@ result = solver.hcaptcha(sitekey='10000000-ffff-ffff-ffff-000000000001',
 
 <sup>[API method description.](https://2captcha.com/2captcha-api#lemin)</sup>
 
-Use this method to solve hCaptcha challenge. Returns JSON with an answer containing the following values: answer, challenge_id.
+Use this method to solve the Lemin captcha. Returns JSON with an answer containing the following values: answer, challenge_id.
 ```python
 result = solver.lemin(captcha_id='CROPPED_1abcd2f_a1234b567c890d12ef3a456bc78d901d',
                             div_id='lemin-cropped-captcha', 
@@ -370,6 +378,10 @@ result = solver.mtcaptcha(sitekey='MTPublic-KzqLY1cKH',
 <sup>[API method description.](https://2captcha.com/2captcha-api#friendly-captcha)</sup>
 
 Friendly Captcha solving method. Returns a token.
+
+> [!IMPORTANT]
+> To successfully use the received token, the captcha widget must not be loaded on the page. To do this, you need to abort request to `/friendlycaptcha/...module.min.js` on the page. When the captcha widget is already loaded on the page, there is a high probability that the received token will not work.
+
 ```python
 result = solver.friendly_captcha(sitekey='FCMGEMUD2KTDSQ5H',
                                  url='https://friendlycaptcha.com/demo',
@@ -430,20 +442,27 @@ code = solver.get_result(id)
 ```
 
 ### balance
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#additional-methods)</sup>
+
 Use this method to get your account's balance
 ```python
 balance = solver.balance()
 ```
 
 ### report
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#complain)</sup>
+
 Use this method to report good or bad captcha answers.
 ```python
 solver.report(id, True) # captcha solved correctly
 solver.report(id, False) # captcha solved incorrectly
 ```
 
-### Error handling
-In case of an error, the captcha solver throws an exception. It's important to properly handle these cases. We recommend using `try except` to handle exceptions. 
+## Error handling
+In case of an error, the captcha solver throws an exception. It's important to properly handle these cases. We recommend using `try except` to handle exceptions.
+The list of all errors can be found in the  [API documentation](https://2captcha.com/2captcha-api#list-of-inphp-errors).
 ```python
 try:
     result = solver.text('If tomorrow is Saturday, what day is today?')
@@ -462,7 +481,7 @@ except TimeoutException as e:
 ```
 
 
-### Proxies
+## Proxies
 
 You can pass your proxy as an additional argument for the following methods: recaptcha, funcaptcha, geetest, geetest v4, hcaptcha, 
 keycaptcha, capy puzzle, lemin, atbcaptcha, turnstile, amazon waf, mtcaptcha, friendly captcha, cutcaptcha. 
@@ -478,7 +497,7 @@ proxy={
 }
 ```
 
-### Async calls
+## Async calls
 You can also make async calls with [asyncio], for example:
 
 ```python
@@ -500,9 +519,14 @@ captcha_result = asyncio.run(captchaSolver(image))
 ## Examples
 Examples of solving all supported captcha types are located in the [examples] directory.
 
-### Useful links
+## Useful articles
+
+- Amazon captcha solver: Code example for bypassing the [Amazon captcha](https://2captcha.com/blog/amazon-captcha-solving)
+- [Captcha bypass in Selenium](https://2captcha.com/blog/captcha-bypass-in-selenium)
+
+<!-- Shared links for README.md -->
 [2Captcha]: https://2captcha.com/
-[2captcha sofware catalog]: https://2captcha.com/software
+[2captcha software catalog]: https://2captcha.com/software
 [pingback settings]: https://2captcha.com/setting/pingback
 [post options]: https://2captcha.com/2captcha-api#normal_post
 [list of supported languages]: https://2captcha.com/2captcha-api#language

2captcha_python-1.2.8.dist-info/RECORD

@@ -0,0 +1,8 @@
+twocaptcha/__init__.py,sha256=-H_x8-E_gPYCaESBSUwnPugFmWl0M3QP-O9l3YWOuFY,473
+twocaptcha/api.py,sha256=qgv1y4FpajF2QZZ_Nzd4_Dcm7Dhk4I1LMAGubydg8zA,2763
+twocaptcha/solver.py,sha256=fenw4L5s-VGZMfBp5fNdv6F-mf1dEwBUfFo41SpcfUM,40918
+2captcha_python-1.2.8.dist-info/LICENSE,sha256=sbILKjQcxUC6dAvBbivnRX9YCshBI9XRvvk1LGkpMEo,1065
+2captcha_python-1.2.8.dist-info/METADATA,sha256=aU6AoBJF1Y3_KdpN5ly-8OGt9gpBbe8zj_RzWTmHMeQ,20871
+2captcha_python-1.2.8.dist-info/WHEEL,sha256=mguMlWGMX-VHnMpKOjjQidIo1ssRlCFu4a4mBpz1s2M,91
+2captcha_python-1.2.8.dist-info/top_level.txt,sha256=AvFZdM89oM6Vo97ZTxT9AxHWpwoO3_Qf5ORMV3NClFE,11
+2captcha_python-1.2.8.dist-info/RECORD,,

{2captcha_python-1.2.7.dist-info → 2captcha_python-1.2.8.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.43.0)
+Generator: setuptools (70.1.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

twocaptcha/__init__.py

@@ -12,4 +12,4 @@ support@2captcha.com
 """
 
 __author__ = '2captcha'
-__version__ = '1.2.7'
+__version__ = '1.2.8'

2captcha_python-1.2.7.dist-info/RECORD

@@ -1,8 +0,0 @@
-twocaptcha/__init__.py,sha256=J9BVnccLQS0Mq3s4Pt4fZXlT4tQhrV8BOOYTiC7Rn8k,473
-twocaptcha/api.py,sha256=qgv1y4FpajF2QZZ_Nzd4_Dcm7Dhk4I1LMAGubydg8zA,2763
-twocaptcha/solver.py,sha256=fenw4L5s-VGZMfBp5fNdv6F-mf1dEwBUfFo41SpcfUM,40918
-2captcha_python-1.2.7.dist-info/LICENSE,sha256=sbILKjQcxUC6dAvBbivnRX9YCshBI9XRvvk1LGkpMEo,1065
-2captcha_python-1.2.7.dist-info/METADATA,sha256=--t8t6fOdP-ic4btM1v7RgzcjWtbx3gMsRaoaVFXcMo,19512
-2captcha_python-1.2.7.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-2captcha_python-1.2.7.dist-info/top_level.txt,sha256=AvFZdM89oM6Vo97ZTxT9AxHWpwoO3_Qf5ORMV3NClFE,11
-2captcha_python-1.2.7.dist-info/RECORD,,