cloud_browser: add solve_captcha kwarg to BrowserConfig + cloud_browser_unblock

Arms Scrapium's built-in captcha detector and solver on the first page
attach. Turnstile, DataDome slider, reCAPTCHA, GeeTest, PerimeterX
hold, and puzzle captchas are handled automatically — no extra CDP
calls from the client. Billed per solve; failures cost nothing.

BrowserConfig wires it through __init__, websocket_url (appends
solve_captcha=true to the query string), to_dict, and from_dict.
cloud_browser_unblock sends solve_captcha at the top level of the
JSON body so the post-unblock session arms Antibot on connect.

Author: jjsaunier

scrapfly/browser_config.py

@@ -44,6 +44,7 @@ def __init__(
         browser_brand: Optional[str] = None,
         byop_proxy: Optional[str] = None,
         enable_mcp: Optional[bool] = None,
+        solve_captcha: Optional[bool] = None,
     ):
         if timeout is not None and timeout > 1800:
             raise ValueError('timeout cannot exceed 1800 seconds (30 minutes)')
@@ -83,6 +84,12 @@ def __init__(
         # https://scrapfly.io/docs/cloud-browser-api/byop
         self.byop_proxy = byop_proxy
         self.enable_mcp = enable_mcp
+        # SolveCaptcha: arm Scrapium's built-in captcha detector + solver on
+        # the first page attach. Turnstile, DataDome slider, reCAPTCHA,
+        # GeeTest, PerimeterX hold, and puzzle captchas are handled
+        # automatically. Billed per solve; failures cost nothing.
+        # https://scrapfly.io/docs/cloud-browser-api/captcha-solver
+        self.solve_captcha = solve_captcha
 
     def websocket_url(self, api_key: str, host: Optional[str] = None) -> str:
         params = {'api_key': api_key}
@@ -153,6 +160,9 @@ def websocket_url(self, api_key: str, host: Optional[str] = None) -> str:
         if self.enable_mcp is not None:
             params['enable_mcp'] = self._bool_to_http(self.enable_mcp)
 
+        if self.solve_captcha is not None:
+            params['solve_captcha'] = self._bool_to_http(self.solve_captcha)
+
         base_host = host or self.CLOUD_BROWSER_HOST
         return base_host + '?' + urlencode(params)
 
@@ -180,6 +190,7 @@ def to_dict(self) -> Dict:
             'browser_brand': self.browser_brand,
             'byop_proxy': self.byop_proxy,
             'enable_mcp': self.enable_mcp,
+            'solve_captcha': self.solve_captcha,
         }
 
     @staticmethod
@@ -215,4 +226,5 @@ def from_dict(browser_config_dict: Dict) -> 'BrowserConfig':
             browser_brand=browser_config_dict.get('browser_brand', None),
             byop_proxy=browser_config_dict.get('byop_proxy', None),
             enable_mcp=browser_config_dict.get('enable_mcp', None),
+            solve_captcha=browser_config_dict.get('solve_captcha', None),
         )

scrapfly/client.py

@@ -1631,6 +1631,7 @@ def cloud_browser_unblock(
         body: Optional[str] = None,
         method: Optional[str] = None,
         enable_mcp: Optional[bool] = None,
+        solve_captcha: Optional[bool] = None,
     ) -> Dict:
         """
         Bypass anti-bot protection and get a ready-to-use browser session.
@@ -1679,6 +1680,9 @@ def cloud_browser_unblock(
         if enable_mcp is not None:
             json_body['enable_mcp'] = enable_mcp
 
+        if solve_captcha is not None:
+            json_body['solve_captcha'] = solve_captcha
+
         response = self._http_handler(
             method='POST',
             url=self.cloud_browser_api_host + '/unblock',