Added methods vkimage, vkcaptcha, prosopo, captchafox to solver.py and async_solver.py, added a description of new captchas to README.md, added tests for new captchas in sync and async, corrected error output in all async examples, corrected the python version and added new captchas to the description in setup.py

Signed-off-by: Maxim S <[email protected]>

Author: poplers24

README.md

@@ -44,6 +44,8 @@ Examples of API requests for different captcha types are available on the [Pytho
     - [DataDome](#datadome)
     - [VKImage](#vkimage)
     - [VKCaptcha](#vkcaptcha)
+    - [CaptchaFox](#captchafox)
+    - [Prosopo](#prosopo)
     - [CyberSiARA](#cybersiara)
   - [Other methods](#other-methods)
     - [send / get\_result](#send--get_result)
@@ -456,7 +458,7 @@ result = solver.vkimage('path/to/captcha.jpg', steps='[5,4,7,7,14,22,8,...]', ..
 
 <sup>[API method description.](https://2captcha.com/2captcha-api#vkcaptcha)</sup>
 
-This method can be used to solve VK Captcha using a token.
+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].
@@ -470,6 +472,32 @@ result = solver.vkcaptcha(redirect_uri='https://id.vk.ru/...',
                           )
 ```
 
+### 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>

examples/async/async_amazon_waf.py

@@ -31,8 +31,7 @@ async def solve_captcha():
             url='https://efw47fpad9.execute-api.us-east-1.amazonaws.com/latest',
         )
     except Exception as e:
-        print(e)
-        return e
+        sys.exit(e)
 
 
 if __name__ == '__main__':

examples/async/async_amazon_waf_options.py

@@ -48,8 +48,7 @@ async def solve_amazon_waf():
             # }
             )
     except Exception as e:
-        print(e)
-        raise e
+        sys.exit(e)
 
 
 if __name__ == '__main__':

examples/async/async_atb_captcha.py

@@ -25,8 +25,7 @@ async def solve_captcha():
             url='http://mysite.com/',
         )
     except Exception as e:
-        print(e)
-        return e
+        sys.exit(e)
 
 
 if __name__ == '__main__':

examples/async/async_atb_captcha_options.py

@@ -39,8 +39,7 @@ async def solve_captcha():
             # }
         )
     except Exception as e:
-        print(e)
-        return e
+        sys.exit(e)
 
 
 if __name__ == '__main__':

examples/async/async_audio.py

@@ -21,8 +21,7 @@ async def solve_captcha():
     try:
         return await solver.audio('../audio/example.mp3', lang='en')
     except Exception as e:
-        print(e)
-        return e
+        sys.exit(e)
 
 
 if __name__ == '__main__':

examples/async/async_canvas.py

@@ -20,8 +20,7 @@ async def solve_captcha():
     try:
         return await solver.canvas('../images/canvas.jpg', hintText='Draw around apple')
     except Exception as e:
-        print(e)
-        return e
+        sys.exit(e)
 
 
 if __name__ == '__main__':

examples/async/async_canvas_base64.py

@@ -26,8 +26,7 @@ async def solve_captcha():
     try:
         return await solver.canvas(b64, hintText='Draw around apple')
     except Exception as e:
-        print(e)
-        return e
+        sys.exit(e)
 
 
 if __name__ == '__main__':

examples/async/async_canvas_options.py

@@ -28,8 +28,7 @@ async def solve_captcha():
             hintText='Draw around apple',
         )
     except Exception as e:
-        print(e)
-        return e
+        sys.exit(e)
 
 
 if __name__ == '__main__':

examples/async/async_captchafox.py

@@ -0,0 +1,33 @@
+import asyncio
+import sys
+import os
+
+sys.path.append(os.path.dirname(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))))
+
+from twocaptcha import AsyncTwoCaptcha
+
+# in this example we store the API key inside environment variables that can be set like:
+# export APIKEY_2CAPTCHA=1abc234de56fab7c89012d34e56fa7b8 on Linux or macOS
+# set APIKEY_2CAPTCHA=1abc234de56fab7c89012d34e56fa7b8 on Windows
+# you can just set the API key directly to it's value like:
+# api_key="1abc234de56fab7c89012d34e56fa7b8"
+
+api_key = os.getenv('APIKEY_2CAPTCHA', 'YOUR_API_KEY')
+
+solver = AsyncTwoCaptcha(api_key)
+
+async def solve_captcha():
+    try:
+        return await 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'}
+        )
+    except Exception as e:
+        sys.exit(e)
+
+if __name__ == '__main__':
+    result = asyncio.run(solve_captcha())
+    sys.exit('result: ' + str(result))