From 43db79d1df50d2b5aa08b13a45d3d585c0d91985 Mon Sep 17 00:00:00 2001 From: Karim shoair Date: Sat, 25 Oct 2025 22:29:07 +0300 Subject: [PATCH] docs: adding cloud browser segment --- docs/fetching/dynamic.md | 38 +++++++++++++++++++++++++++++++++++++- 1 file changed, 37 insertions(+), 1 deletion(-) diff --git a/docs/fetching/dynamic.md b/docs/fetching/dynamic.md index 3075fdc..18c39d7 100644 --- a/docs/fetching/dynamic.md +++ b/docs/fetching/dynamic.md @@ -300,4 +300,40 @@ Use DynamicFetcher when: - Need custom browser config - Want flexible stealth options -If you want more stealth and control without much config, check out the [StealthyFetcher](stealthy.md). \ No newline at end of file +If you want more stealth and control without much config, check out the [StealthyFetcher](stealthy.md). + +## External Cloud Browser Version + +If you have issues with the browser installation, such as resource management, we recommend you try the Cloud Browser from [Scrapeless](https://www.scrapeless.com/en/product/scraping-browser) for free! + +The usage is straightforward: create an account and [get your API key](https://docs.scrapeless.com/en/scraping-browser/quickstart/getting-started/), then pass it to the `DynamicSession` like this: + +```python +from urllib.parse import urlencode + +from scrapling.fetchers import DynamicSession + +# Configure your browser session +config = { + "token": "YOUR_API_KEY", + "sessionName": "scrapling-session", + "sessionTTL": "300", # 5 minutes + "proxyCountry": "ANY", + "sessionRecording": "false", +} + +# Build WebSocket URL +ws_endpoint = f"wss://browser.scrapeless.com/api/v2/browser?{urlencode(config)}" +print('Connecting to Scrapeless...') + +with DynamicSession(cdp_url=ws_endpoint, disable_resources=True) as s: + print("Connected!") + page = s.fetch("https://httpbin.org/headers", network_idle=True) + print(f"Page loaded, content length: {len(page.body)}") + print(page.json()) +``` +The `DynamicSession` class instance will work as usual, so no further explanation is needed. + +However, the Scrapeless Cloud Browser can be configured with proxy options, like the proxy country in the config above, [custom fingerprint](https://docs.scrapeless.com/en/scraping-browser/features/advanced-privacy-anti-detection/custom-fingerprint/) configuration, [captcha solving](https://docs.scrapeless.com/en/scraping-browser/features/advanced-privacy-anti-detection/supported-captchas/), and more. + +Check out the [Scrapeless's browser documentation](https://docs.scrapeless.com/en/scraping-browser/quickstart/introduction/) for more details. \ No newline at end of file