2captcha-python 2.0.0__tar.gz → 2.0.1__tar.gz

{2captcha_python-2.0.0 → 2captcha_python-2.0.1/2captcha_python.egg-info}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: 2captcha-python
-Version: 2.0.0
+Version: 2.0.1
 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,FunCaptcha,Geetest,image captcha,Coordinates,Click Captcha,Geetest V4,Lemin captcha,Amazon WAF,Cloudflare Turnstile,Capy Puzzle,MTCaptcha,Friendly Captcha,Tencent,Cutcaptcha,DataDome,cybersiara
+Keywords: 2captcha,captcha,api,captcha solver,reCAPTCHA,FunCaptcha,Geetest,image captcha,Coordinates,Click Captcha,Geetest V4,Lemin captcha,Amazon WAF,Cloudflare Turnstile,Capy Puzzle,MTCaptcha,Friendly Captcha,Tencent,Cutcaptcha,DataDome,VK Captcha,CaptchaFox,Prosopo,cybersiara
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
@@ -13,7 +13,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Scientific/Engineering :: Image Recognition
 Classifier: Topic :: Utilities
 Classifier: Intended Audience :: Developers
-Requires-Python: >=3.6
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests
@@ -75,6 +75,10 @@ Examples of API requests for different captcha types are available on the [Pytho
     - [Cutcaptcha](#cutcaptcha)
     - [Tencent](#tencent)
     - [DataDome](#datadome)
+    - [VKImage](#vkimage)
+    - [VKCaptcha](#vkcaptcha)
+    - [CaptchaFox](#captchafox)
+    - [Prosopo](#prosopo)
     - [CyberSiARA](#cybersiara)
   - [Other methods](#other-methods)
     - [send / get\_result](#send--get_result)
@@ -473,6 +477,60 @@ result = solver.datadome(captcha_url="https://geo.captcha-delivery.com/captcha/?
                          param1=..., ...)
 ```
 
+### VKImage
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#vkcaptcha)</sup>
+
+This method can be used to solve VK captcha using graphical captcha. Returns the number of steps and solution value in the target site's API format.
+
+```python
+result = solver.vkimage('path/to/captcha.jpg', steps='[5,4,7,7,14,22,8,...]', ...)
+```
+
+### VKCaptcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#vkcaptcha)</sup>
+
+This method can be used to solve VK Captcha using a token. Returns a token.
+
+> [!IMPORTANT]
+> To solve the VK Captcha, you must use a proxy. It is recommended to use [residential proxies].
+
+```python
+result = solver.vkcaptcha(redirect_uri='https://id.vk.ru/...',
+                          userAgent='Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36..',
+                          proxy={
+                            'type': 'HTTP',
+                            'uri': 'login:password@IP_address:PORT'}
+                          )
+```
+
+### CaptchaFox
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#captchafox)</sup>
+
+This method can be used to solve CaptchaFox using a token. Returns a token.
+
+```python
+result = solver.captchafox(sitekey='sk_ILKWNruBBVKDOM7dZs59KHnDLEWiH',
+                           pageurl='https://mysite.com/page/with/captchafox',
+                           userAgent='Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36',
+                           proxy={'type': 'HTTPS',
+                                  'uri': 'login:password@IP_address:PORT'})
+```
+
+### Prosopo
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#prosopo-procaptcha)</sup>
+
+This method can be used to solve Prosopo captcha using a token. Returns a token.
+
+```python
+result = solver.prosopo(sitekey='5EZVvsHMrKCFKp5NYNoTyDjTjetoVo1Z4UNNb1DkVLS0JbqR',
+                        pageurl='https://mysite.com/page/with/prosopo'
+                        )
+```
+
 ### CyberSiARA
 
 <sup>[API method description.](https://2captcha.com/2captcha-api#cybersiara)</sup>

2captcha_python-2.0.0/README.md → 2captcha_python-2.0.1/PKG-INFO

@@ -1,3 +1,36 @@
+Metadata-Version: 2.4
+Name: 2captcha-python
+Version: 2.0.1
+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,FunCaptcha,Geetest,image captcha,Coordinates,Click Captcha,Geetest V4,Lemin captcha,Amazon WAF,Cloudflare Turnstile,Capy Puzzle,MTCaptcha,Friendly Captcha,Tencent,Cutcaptcha,DataDome,VK Captcha,CaptchaFox,Prosopo,cybersiara
+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.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: httpx
+Requires-Dist: aiofiles
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
 <a href="https://github.com/2captcha/2captcha-python"><img src="https://github.com/user-attachments/assets/a737d428-5233-4605-9d09-211fa213d069" width="82" height="30"></a>
 <a href="https://github.com/2captcha/2captcha-javascript"><img src="https://github.com/user-attachments/assets/4d3b4541-34b2-4ed2-a687-d694ce67e5a6" width="36" height="30"></a>
 <a href="https://github.com/2captcha/2captcha-go"><img src="https://github.com/user-attachments/assets/ab22182e-6cb2-41fa-91f4-d5e89c6d7c6f" width="63" height="30"></a>
@@ -42,6 +75,10 @@ Examples of API requests for different captcha types are available on the [Pytho
     - [Cutcaptcha](#cutcaptcha)
     - [Tencent](#tencent)
     - [DataDome](#datadome)
+    - [VKImage](#vkimage)
+    - [VKCaptcha](#vkcaptcha)
+    - [CaptchaFox](#captchafox)
+    - [Prosopo](#prosopo)
     - [CyberSiARA](#cybersiara)
   - [Other methods](#other-methods)
     - [send / get\_result](#send--get_result)
@@ -440,6 +477,60 @@ result = solver.datadome(captcha_url="https://geo.captcha-delivery.com/captcha/?
                          param1=..., ...)
 ```
 
+### VKImage
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#vkcaptcha)</sup>
+
+This method can be used to solve VK captcha using graphical captcha. Returns the number of steps and solution value in the target site's API format.
+
+```python
+result = solver.vkimage('path/to/captcha.jpg', steps='[5,4,7,7,14,22,8,...]', ...)
+```
+
+### VKCaptcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#vkcaptcha)</sup>
+
+This method can be used to solve VK Captcha using a token. Returns a token.
+
+> [!IMPORTANT]
+> To solve the VK Captcha, you must use a proxy. It is recommended to use [residential proxies].
+
+```python
+result = solver.vkcaptcha(redirect_uri='https://id.vk.ru/...',
+                          userAgent='Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36..',
+                          proxy={
+                            'type': 'HTTP',
+                            'uri': 'login:password@IP_address:PORT'}
+                          )
+```
+
+### CaptchaFox
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#captchafox)</sup>
+
+This method can be used to solve CaptchaFox using a token. Returns a token.
+
+```python
+result = solver.captchafox(sitekey='sk_ILKWNruBBVKDOM7dZs59KHnDLEWiH',
+                           pageurl='https://mysite.com/page/with/captchafox',
+                           userAgent='Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36',
+                           proxy={'type': 'HTTPS',
+                                  'uri': 'login:password@IP_address:PORT'})
+```
+
+### Prosopo
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#prosopo-procaptcha)</sup>
+
+This method can be used to solve Prosopo captcha using a token. Returns a token.
+
+```python
+result = solver.prosopo(sitekey='5EZVvsHMrKCFKp5NYNoTyDjTjetoVo1Z4UNNb1DkVLS0JbqR',
+                        pageurl='https://mysite.com/page/with/prosopo'
+                        )
+```
+
 ### CyberSiARA
 
 <sup>[API method description.](https://2captcha.com/2captcha-api#cybersiara)</sup>

2captcha_python-2.0.0/2captcha_python.egg-info/PKG-INFO → 2captcha_python-2.0.1/README.md

@@ -1,36 +1,3 @@
-Metadata-Version: 2.4
-Name: 2captcha-python
-Version: 2.0.0
-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,FunCaptcha,Geetest,image captcha,Coordinates,Click Captcha,Geetest V4,Lemin captcha,Amazon WAF,Cloudflare Turnstile,Capy Puzzle,MTCaptcha,Friendly Captcha,Tencent,Cutcaptcha,DataDome,cybersiara
-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
-Requires-Dist: httpx
-Requires-Dist: aiofiles
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license-file
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
 <a href="https://github.com/2captcha/2captcha-python"><img src="https://github.com/user-attachments/assets/a737d428-5233-4605-9d09-211fa213d069" width="82" height="30"></a>
 <a href="https://github.com/2captcha/2captcha-javascript"><img src="https://github.com/user-attachments/assets/4d3b4541-34b2-4ed2-a687-d694ce67e5a6" width="36" height="30"></a>
 <a href="https://github.com/2captcha/2captcha-go"><img src="https://github.com/user-attachments/assets/ab22182e-6cb2-41fa-91f4-d5e89c6d7c6f" width="63" height="30"></a>
@@ -75,6 +42,10 @@ Examples of API requests for different captcha types are available on the [Pytho
     - [Cutcaptcha](#cutcaptcha)
     - [Tencent](#tencent)
     - [DataDome](#datadome)
+    - [VKImage](#vkimage)
+    - [VKCaptcha](#vkcaptcha)
+    - [CaptchaFox](#captchafox)
+    - [Prosopo](#prosopo)
     - [CyberSiARA](#cybersiara)
   - [Other methods](#other-methods)
     - [send / get\_result](#send--get_result)
@@ -473,6 +444,60 @@ result = solver.datadome(captcha_url="https://geo.captcha-delivery.com/captcha/?
                          param1=..., ...)
 ```
 
+### VKImage
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#vkcaptcha)</sup>
+
+This method can be used to solve VK captcha using graphical captcha. Returns the number of steps and solution value in the target site's API format.
+
+```python
+result = solver.vkimage('path/to/captcha.jpg', steps='[5,4,7,7,14,22,8,...]', ...)
+```
+
+### VKCaptcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#vkcaptcha)</sup>
+
+This method can be used to solve VK Captcha using a token. Returns a token.
+
+> [!IMPORTANT]
+> To solve the VK Captcha, you must use a proxy. It is recommended to use [residential proxies].
+
+```python
+result = solver.vkcaptcha(redirect_uri='https://id.vk.ru/...',
+                          userAgent='Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36..',
+                          proxy={
+                            'type': 'HTTP',
+                            'uri': 'login:password@IP_address:PORT'}
+                          )
+```
+
+### CaptchaFox
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#captchafox)</sup>
+
+This method can be used to solve CaptchaFox using a token. Returns a token.
+
+```python
+result = solver.captchafox(sitekey='sk_ILKWNruBBVKDOM7dZs59KHnDLEWiH',
+                           pageurl='https://mysite.com/page/with/captchafox',
+                           userAgent='Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36',
+                           proxy={'type': 'HTTPS',
+                                  'uri': 'login:password@IP_address:PORT'})
+```
+
+### Prosopo
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#prosopo-procaptcha)</sup>
+
+This method can be used to solve Prosopo captcha using a token. Returns a token.
+
+```python
+result = solver.prosopo(sitekey='5EZVvsHMrKCFKp5NYNoTyDjTjetoVo1Z4UNNb1DkVLS0JbqR',
+                        pageurl='https://mysite.com/page/with/prosopo'
+                        )
+```
+
 ### CyberSiARA
 
 <sup>[API method description.](https://2captcha.com/2captcha-api#cybersiara)</sup>

{2captcha_python-2.0.0 → 2captcha_python-2.0.1}/setup.py

@@ -36,6 +36,6 @@ setup(name='2captcha-python',
           '2captcha', 'captcha', 'api', 'captcha solver', 'reCAPTCHA',
           'FunCaptcha', 'Geetest', 'image captcha', 'Coordinates', 'Click Captcha',
           'Geetest V4', 'Lemin captcha', 'Amazon WAF', 'Cloudflare Turnstile',
-          'Capy Puzzle', 'MTCaptcha', 'Friendly Captcha', 'Tencent', 'Cutcaptcha', 'DataDome', 'cybersiara'],
-      python_requires='>=3.6',
+          'Capy Puzzle', 'MTCaptcha', 'Friendly Captcha', 'Tencent', 'Cutcaptcha', 'DataDome', 'VK Captcha', 'CaptchaFox', 'Prosopo', 'cybersiara'],
+      python_requires='>=3.8',
       test_suite='tests')

{2captcha_python-2.0.0 → 2captcha_python-2.0.1}/twocaptcha/__init__.py

@@ -17,4 +17,4 @@ support@2captcha.com
 """
 
 __author__ = '2captcha'
-__version__ = '2.0.0'
+__version__ = '2.0.1'

{2captcha_python-2.0.0 → 2captcha_python-2.0.1}/twocaptcha/async_solver.py

@@ -800,6 +800,103 @@ class AsyncTwoCaptcha():
                                   **kwargs)
         return result
 
+    async def vkimage(self, files, steps, **kwargs):
+        '''Wrapper for solving vkimage captcha.
+
+        Parameters
+        __________
+        file : str
+            Captcha image as a file or base64.
+        steps: str
+            Array of steps.
+        proxy : dict, optional
+            {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}.
+        '''
+
+        if isinstance(files, str):
+
+            payload = await self.get_method(files)
+            payload.pop('method', None)
+
+            result = await self.solve(method='vkimage', steps=steps, **payload, **kwargs)
+            return result
+
+        elif isinstance(files, dict):
+            files = list(files.values())
+
+        files = self.extract_files(files)
+
+        result = await self.solve(method='vkimage',
+                            files=files,
+                            steps=steps,
+                            **kwargs)
+        return result
+
+    async def vkcaptcha(self, redirect_uri, userAgent, proxy, **kwargs):
+        '''Wrapper for solving VK captcha using tokens.
+
+        Parameters
+        __________
+        redirect_uri : str
+            The URL that is returned for requests to the captchas API.
+        userAgent : str
+            User-Agent of the browser that will be used by the employee when loading the captcha.
+        proxy : dict
+            {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}.
+        '''
+
+
+        result = await self.solve(method='vkcaptcha',
+                            redirect_uri=redirect_uri,
+                            useragent=userAgent,
+                            proxy=proxy,
+                            **kwargs)
+        return result
+
+    async def captchafox(self, sitekey, pageurl, userAgent, proxy, **kwargs):
+        '''Wrapper for solving CaptchaFox using tokens.
+
+        Parameters
+        __________
+        sitekey : str
+            The sitekey parameter value found on the page or in network requests.
+        pageurl : str
+            Full URL of the page with captcha.
+        userAgent : str
+            User-Agent of the browser that will be used by the employee when loading the captcha.
+        proxy : dict
+            {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}.
+        '''
+
+
+        result = await self.solve(method='captchafox',
+                            sitekey=sitekey,
+                            pageurl=pageurl,
+                            useragent=userAgent,
+                            proxy=proxy,
+                            **kwargs)
+        return result
+
+    async def prosopo(self, sitekey, pageurl, **kwargs):
+        '''Wrapper for solving Prosopo captcha using tokens.
+
+        Parameters
+        __________
+        sitekey : str
+            The sitekey parameter value found on the page or in network requests.
+        pageurl : str
+            Full URL of the page with captcha.
+        proxy : dict, optional
+            {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}.
+        '''
+
+
+        result = await self.solve(method='prosopo',
+                            sitekey=sitekey,
+                            pageurl=pageurl,
+                            **kwargs)
+        return result
+
     async def datadome(self, captcha_url, pageurl, userAgent, proxy, **kwargs):
         """Wrapper for solving DataDome Captcha.
 

{2captcha_python-2.0.0 → 2captcha_python-2.0.1}/twocaptcha/solver.py

@@ -930,6 +930,103 @@ class TwoCaptcha():
                             **kwargs)
         return result
 
+    def vkimage(self, files, steps, **kwargs):
+        '''Wrapper for solving vkimage captcha.
+
+        Parameters
+        __________
+        file : str
+            Captcha image as a file or base64.
+        steps: str
+            Array of steps.
+        proxy : dict, optional
+            {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}.
+        '''
+
+        if isinstance(files, str):
+
+            payload = self.get_method(files)
+            payload.pop('method', None)
+
+            result = self.solve(method='vkimage', steps=steps, **payload, **kwargs)
+            return result
+
+        elif isinstance(files, dict):
+            files = list(files.values())
+
+        files = self.extract_files(files)
+
+        result = self.solve(method='vkimage',
+                            files=files,
+                            steps=steps,
+                            **kwargs)
+        return result
+
+    def vkcaptcha(self, redirect_uri, userAgent, proxy, **kwargs):
+        '''Wrapper for solving VK captcha using tokens.
+
+        Parameters
+        __________
+        redirect_uri : str
+            The URL that is returned for requests to the captchas API.
+        userAgent : str
+            User-Agent of the browser that will be used by the employee when loading the captcha.
+        proxy : dict
+            {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}.
+        '''
+
+
+        result = self.solve(method='vkcaptcha',
+                            redirect_uri=redirect_uri,
+                            useragent=userAgent,
+                            proxy=proxy,
+                            **kwargs)
+        return result
+
+    def captchafox(self, sitekey, pageurl, userAgent, proxy, **kwargs):
+        '''Wrapper for solving CaptchaFox using tokens.
+
+        Parameters
+        __________
+        sitekey : str
+            The sitekey parameter value found on the page or in network requests.
+        pageurl : str
+            Full URL of the page with captcha.
+        userAgent : str
+            User-Agent of the browser that will be used by the employee when loading the captcha.
+        proxy : dict
+            {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}.
+        '''
+
+
+        result = self.solve(method='captchafox',
+                            sitekey=sitekey,
+                            pageurl=pageurl,
+                            useragent=userAgent,
+                            proxy=proxy,
+                            **kwargs)
+        return result
+
+    def prosopo(self, sitekey, pageurl, **kwargs):
+        '''Wrapper for solving Prosopo captcha using tokens.
+
+        Parameters
+        __________
+        sitekey : str
+            The sitekey parameter value found on the page or in network requests.
+        pageurl : str
+            Full URL of the page with captcha.
+        proxy : dict, optional
+            {'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'}.
+        '''
+
+
+        result = self.solve(method='prosopo',
+                            sitekey=sitekey,
+                            pageurl=pageurl,
+                            **kwargs)
+        return result
+
     def datadome(self, captcha_url, pageurl, userAgent, proxy, **kwargs):
         """Wrapper for solving DataDome Captcha.