2captcha-python 2.0.0__py3-none-any.whl → 2.0.1__py3-none-any.whl

{2captcha_python-2.0.0.dist-info → 2captcha_python-2.0.1.dist-info}/METADATA

@@ -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.1.dist-info/RECORD

@@ -0,0 +1,13 @@
+2captcha_python-2.0.1.dist-info/licenses/LICENSE,sha256=sbILKjQcxUC6dAvBbivnRX9YCshBI9XRvvk1LGkpMEo,1065
+twocaptcha/__init__.py,sha256=Vs7bsefnJtoVLkRkrTp_NkUW1Dl8wQ4VzB5J7Cp1sMk,542
+twocaptcha/api.py,sha256=vlYOhc3rGIHOVGq4hZjJ54tUxBpBzI2FgWPctllb7D0,2826
+twocaptcha/async_api.py,sha256=L467rsgdVVrgWaLkvengoTE8GvCgQAfM2PmVO2kfad4,3534
+twocaptcha/async_solver.py,sha256=khdxsgvlOHxkyEtX8ogc7IcHyRRVxm_T2HhbwdVp7ks,49270
+twocaptcha/solver.py,sha256=3j1xWFwi2MOvQI9UoF-M-XX97Mjs68UDTnZZC0Ol9fU,55732
+twocaptcha/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+twocaptcha/exceptions/api.py,sha256=N810fZxcNE2AwCM9EyFrXpDpzAKsKi_tHCnRJn4CH7s,86
+twocaptcha/exceptions/solver.py,sha256=hvKUebPMvC51ve6MSmv_3q1J9vkhS90XO2ivoVToyoU,255
+2captcha_python-2.0.1.dist-info/METADATA,sha256=38qYapqMFD2t9AwyxnEQsj2TJifnopV9AduYmnpEkFA,30517
+2captcha_python-2.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+2captcha_python-2.0.1.dist-info/top_level.txt,sha256=AvFZdM89oM6Vo97ZTxT9AxHWpwoO3_Qf5ORMV3NClFE,11
+2captcha_python-2.0.1.dist-info/RECORD,,

twocaptcha/__init__.py

@@ -17,4 +17,4 @@ support@2captcha.com
 """
 
 __author__ = '2captcha'
-__version__ = '2.0.0'
+__version__ = '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.
 

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.
 

2captcha_python-2.0.0.dist-info/RECORD

@@ -1,13 +0,0 @@
-2captcha_python-2.0.0.dist-info/licenses/LICENSE,sha256=sbILKjQcxUC6dAvBbivnRX9YCshBI9XRvvk1LGkpMEo,1065
-twocaptcha/__init__.py,sha256=WoyFQiLTO_ucaTRiLgq4a4QBcBAdyD-NqFLNdqTe_fA,542
-twocaptcha/api.py,sha256=vlYOhc3rGIHOVGq4hZjJ54tUxBpBzI2FgWPctllb7D0,2826
-twocaptcha/async_api.py,sha256=L467rsgdVVrgWaLkvengoTE8GvCgQAfM2PmVO2kfad4,3534
-twocaptcha/async_solver.py,sha256=9ru1pJFx_xGk-KaPGKibBe3Ky2J0ZFPjgI2J5YFxg08,46062
-twocaptcha/solver.py,sha256=R16oosWn-f-qy-ik-OzD5KvX7uPmBq5AiR2awLMZOOw,52584
-twocaptcha/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-twocaptcha/exceptions/api.py,sha256=N810fZxcNE2AwCM9EyFrXpDpzAKsKi_tHCnRJn4CH7s,86
-twocaptcha/exceptions/solver.py,sha256=hvKUebPMvC51ve6MSmv_3q1J9vkhS90XO2ivoVToyoU,255
-2captcha_python-2.0.0.dist-info/METADATA,sha256=HLdXVcfy40ep7aHOIwdOrMtMRdRFAS_LxvhaZhD5ufI,28396
-2captcha_python-2.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-2captcha_python-2.0.0.dist-info/top_level.txt,sha256=AvFZdM89oM6Vo97ZTxT9AxHWpwoO3_Qf5ORMV3NClFE,11
-2captcha_python-2.0.0.dist-info/RECORD,,