feat: add RecaptchaClickTask, HuntTask, and missing API fields

New task types:
- RecaptchaClickTask for click-based reCAPTCHA solving
- HuntTask for Hunt captcha solving

New fields on existing tasks:
- cookies on RecaptchaV2Task
- pageAction on RecaptchaV2EnterpriseTask
- isEnterprise on RecaptchaV3Task
- nocache on all reCAPTCHA task types (v2, v2e, v3, v3e)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: alperensert

src/capmonster_python/__init__.py

@@ -22,11 +22,13 @@
     "FunCaptchaTask",
     "GeeTestV3Task",
     "GeeTestV4Task",
+    "HuntTask",
     "ImageToTextTask",
     "ImpervaTask",
     "ImpervaTaskMetadata",
     "MTCaptchaTask",
     "ProsopoTask",
+    "RecaptchaClickTask",
     "RecaptchaV2Task",
     "RecaptchaV2EnterpriseTask",
     "RecaptchaV3Task",

src/capmonster_python/tasks/__init__.py

@@ -8,10 +8,12 @@
 from .datadome import DataDomeTask, DataDomeMetadata
 from .funcaptcha import FunCaptchaTask
 from .geetest import GeeTestV4Task, GeeTestV3Task
+from .hunt import HuntTask
 from .image_to_text import ImageToTextTask
 from .imperva import ImpervaTask, ImpervaTaskMetadata
 from .mtcaptcha import MTCaptchaTask
 from .prosopo import ProsopoTask
+from .recaptcha_click import RecaptchaClickTask
 from .recaptcha_v2 import RecaptchaV2Task
 from .recaptcha_v2_enterprise import RecaptchaV2EnterpriseTask
 from .recaptcha_v3 import RecaptchaV3Task
@@ -42,11 +44,13 @@
     "FunCaptchaTask",
     "GeeTestV3Task",
     "GeeTestV4Task",
+    "HuntTask",
     "ImageToTextTask",
     "ImpervaTask",
     "ImpervaTaskMetadata",
     "MTCaptchaTask",
     "ProsopoTask",
+    "RecaptchaClickTask",
     "RecaptchaV2Task",
     "RecaptchaV2EnterpriseTask",
     "RecaptchaV3Task",

src/capmonster_python/tasks/hunt.py

@@ -0,0 +1,27 @@
+from typing import Optional, Any
+
+from pydantic import Field
+
+from .task import TaskPayload, ProxyPayload, UserAgentPayload
+
+
+class HuntTask(TaskPayload, UserAgentPayload):
+    """
+    Represents a task for solving Hunt captcha challenges.
+
+    Attributes:
+        websiteURL: The URL of the webpage containing the captcha.
+        websiteKey: The Hunt captcha site key.
+        proxy: Optional proxy settings.
+    """
+    type: str = Field(default="HuntTask", frozen=True)
+    websiteURL: str = Field(..., description='Address of a webpage with captcha.')
+    websiteKey: str = Field(..., description='Hunt captcha site key.')
+    proxy: Optional[ProxyPayload] = Field(default=None, description='Proxy settings.')
+
+    def to_request(self) -> dict[str, Any]:
+        base = self.model_dump(exclude_none=True)
+        proxy_dict = base.pop("proxy", {})
+        if proxy_dict:
+            base.update(proxy_dict)
+        return base

src/capmonster_python/tasks/recaptcha_click.py

@@ -0,0 +1,31 @@
+from typing import Optional, Any
+
+from pydantic import Field
+
+from .task import TaskPayload, ProxyPayload, UserAgentPayload
+
+
+class RecaptchaClickTask(TaskPayload, UserAgentPayload):
+    """
+    Represents a task for solving click-based reCAPTCHA challenges.
+
+    Attributes:
+        websiteURL: The URL of the webpage containing the reCAPTCHA challenge.
+        websiteKey: The site key associated with the reCAPTCHA on the webpage.
+        isInvisible: When set to True, specifies that the challenge
+            being solved is an invisible reCAPTCHA.
+        proxy: Optional proxy settings.
+    """
+    type: str = Field(default="RecaptchaClickTask", frozen=True)
+    websiteURL: str = Field(..., description='Address of a webpage with captcha.')
+    websiteKey: str = Field(..., description='reCAPTCHA website key.')
+    isInvisible: Optional[bool] = Field(default=None,
+                                        description='Set to true if you want to solve invisible reCAPTCHA.')
+    proxy: Optional[ProxyPayload] = Field(default=None, description='Proxy settings.')
+
+    def to_request(self) -> dict[str, Any]:
+        base = self.model_dump(exclude_none=True)
+        proxy_dict = base.pop("proxy", {})
+        if proxy_dict:
+            base.update(proxy_dict)
+        return base

src/capmonster_python/tasks/recaptcha_v2.py

@@ -30,6 +30,10 @@ class RecaptchaV2Task(TaskPayload, UserAgentPayload):
                                                            'and must be grabbed every time you want to solve a reCAPTCHA v2.')
     isInvisible: Optional[bool] = Field(default=None,
                                         description='Set to true if you want to solve invisible reCAPTCHA.')
+    cookies: Optional[str] = Field(default=None,
+                                   description='Additional cookies in the format: cookieName1=value1; cookieName2=value2.')
+    nocache: Optional[bool] = Field(default=None,
+                                    description='Set to true to force fresh token generation (prevents reuse of cached tokens).')
     proxy: Optional[ProxyPayload] = Field(default=None, description='Proxy settings.')
 
     def to_request(self) -> dict[str, Any]:

src/capmonster_python/tasks/recaptcha_v2_enterprise.py

@@ -22,14 +22,18 @@ class RecaptchaV2EnterpriseTask(TaskPayload, UserAgentPayload):
     type: str = Field(default="RecaptchaV2EnterpriseTask", frozen=True)
     websiteURL: str = Field(..., description='Address of a webpage with Google reCAPTCHA Enterprise.')
     websiteKey: str = Field(..., description='reCAPTCHA website key.')
+    pageAction: Optional[str] = Field(default=None,
+                                      description='Action parameter if different from default “verify”.')
     enterprisePayload: Optional[str] = Field(default=None,
                                              description='Some implementations of the reCAPTCHA Enterprise widget '
                                                          'may contain additional parameters that are passed to the '
-                                                         '“grecaptcha.enterprise.render” method along with the sitekey.')
+                                                         '”grecaptcha.enterprise.render” method along with the sitekey.')
     apiDomain: Optional[str] = Field(default=None,
                                      description='Domain address from which to load reCAPTCHA Enterprise. '
                                                  'Don\'t use a parameter if you don\'t know why it\'s needed.')
     cookies: Optional[str] = Field(default=None, description='Cookies to be sent with the request.')
+    nocache: Optional[bool] = Field(default=None,
+                                    description='Set to true to force fresh token generation (prevents reuse of cached tokens).')
     proxy: Optional[ProxyPayload] = Field(default=None, description='Proxy settings.')
 
     def to_request(self) -> dict[str, Any]:

src/capmonster_python/tasks/recaptcha_v3.py

@@ -25,6 +25,10 @@ class RecaptchaV3Task(TaskPayload):
     pageAction: Optional[str] = Field(default=None,
                                       description='Widget action value. Website owner defines what user is doing on '
                                                   'the page through this parameter. Default value: verify')
+    isEnterprise: Optional[bool] = Field(default=None,
+                                         description='Set to true to solve as Enterprise (equivalent to RecaptchaV3EnterpriseTask).')
+    nocache: Optional[bool] = Field(default=None,
+                                    description='Set to true to force fresh token generation (prevents reuse of cached tokens).')
 
     def to_request(self) -> dict[str, Any]:
         return self.model_dump(exclude_none=True)

src/capmonster_python/tasks/recaptcha_v3_enterprise.py

@@ -23,6 +23,8 @@ class RecaptchaV3EnterpriseTask(TaskPayload):
     pageAction: Optional[str] = Field(default=None,
                                       description='Widget action value. Website owner defines what user is doing on '
                                                   'the page through this parameter. Default value: verify')
+    nocache: Optional[bool] = Field(default=None,
+                                    description='Set to true to force fresh token generation (prevents reuse of cached tokens).')
 
     def to_request(self) -> dict[str, Any]:
         return self.model_dump(exclude_none=True)