Cloud Proxy Browser

Cloud Proxy Browser is an auto-scalable solution designed for web scraping and automation. It allows you to run automation and scraping code seamlessly on our fully hosted cloud browser instances, leveraging multiple proxy networks (including residential and mobile IPs), and managing advanced unblocking features of antidetect browsers, such as real-user fingerprints, JavaScript rendering, and more.

Scraping browser or cloud proxy browser is included with your NodeMaven proxy plan, meaning you only pay for the proxy traffic you use through our browser instances

Key Features:

1. Seamless Integration
   Natively supports Playwright, Puppeteer, Selenium, and other CDP-based automation frameworks for effortless script execution.
2. Auto-Scaling Infrastructure
   Dynamically scales browser instances based on demand, enabling unlimited concurrent sessions without manual resource allocation.
3. Premium Proxy Management
   Access high-quality residential and mobile proxies with:
   1. Deep targeting (country, region, city, ISP)
   2. Sticky and rotating sessions for stable connections or frequent IP changes
   3. IP quality filtering to ensure high-trust, low-risk IPs
4. Real User Fingerprints
   Smart fingerprint rotation maintains realistic, consistent configurations, including:
   1. Hardware specs, OS, timezone, language, screen resolution, fonts, canvas, WebGL, WebRTC, and more.
   2. Customizable spoofing to mimic real user behavior and bypass detection systems.
5. JavaScript Rendering
   Ensure accurate rendering of dynamic content with full JavaScript execution support.
6. Real-Time Debugging
   Inspect and control live browser sessions using the Chrome DevTools Protocol (CDP) for troubleshooting, logging, and script optimization.

Quick Start Guide

1. Getting Started

• Register at NodeMaven Dashboard and purchase proxy traffic such as residential proxies.
• Generate Cloud Proxy Browser CDP URLs based on your proxy and browser profile requirements. These URLs you will use with your web automation tool.
  • CDP URL Building Parameters

A connection string is structured as follows:

wss://username_country-{country}-region-{region}-city-{city}-isp-{isp}-type-{type}-sid-{sid}-pid-{pid}:[email protected]:8080

Parameters:

username: Your NodeMaven username (the same as username in proxy)

password: Your NodeMaven username (the same as proxyusername)

country, region, city, isp: Targeting options

country – required parameter

region, city, isp – optional parameters

type-mobile: add such flag if you want get only mobile IPs

sid: Proxy Session ID for sticky sessions. Remove this parameter if you want to get rotating proxies, meaning that you will get new IP on each request

pid: Profile ID with specific settings of browser profile

bsid: Browser session ID used to maintain session persistence across requests.

2. Making first connection

• Run these basic code examples to check that your Cloud Proxy Browser is working (remember to swap in your credentials and target URL):

Puppeteer

const puppeteer = require('puppeteer'); (async () => { const browser = await puppeteer.connect({ browserWSEndpoint: 'wss://your_connection_string_here' }); const page = await browser.newPage(); await page.goto('https://example.com'); console.log(await page.title()); await browser.close(); })();

Playwright

const { chromium } = require('playwright'); (async () => { const browser = await chromium.connectOverCDP('wss://your_connection_string_here'); const page = await browser.newPage(); await page.goto('https://example.com'); console.log(await page.title()); await browser.close(); })();

Selenium

from selenium import webdriver options = webdriver.ChromeOptions() options.debugger_address = 'wss://your_connection_string_here' driver = webdriver.Chrome(options=options) driver.get('https://example.com') print(driver.title) driver.quit()

3. View Live Browser Session using Chrome DevTools

Enable Chrome DevTools debugger to monitor script execution and debug issues in real time, improving control, visibility, and efficiency. Use the following code snippet to automatically launch DevTools for every session:

await page.evaluate(() => { debugger; });

Important Notes: Limits Explanation

• Idle Session Timeout: 5 minutes
  • If a browser session remains idle for 5 minutes or more with no activity, Cloud Proxy Browser will automatically terminate the session.
• Concurrent Sessions per User: Unlimited
• Max Persistent Profiles: According to your plan

API Documentation

Profile Management

• Create One-Time Profile (POST /profiles/one-time/{id}/start)
• Get Profile Info (GET /profiles/{id})
• Create Persistent Profile (POST /profiles/persistent/{id}/start)
• Update Persistent Profile (PATCH /profiles/persistent/{id})
• Delete Persistent Profile (DELETE /profiles/persitent/{id})
• Batch Delete Persistent Profile (DELETE /profiles/persitent/{id})

Cookie Management

• Export Cookies (GET /profiles/{id}/cookies?format=json)
• Import Cookies (POST /profiles/{id}/cookies)

Fingerprint Options

• Get GPU Renderers (GET /fingerprint/gpu?os=linux&arch=x86_64)
• Get Screen Resolutions (GET /fingerprint/resolutions?os=windows)

Common Error Responses

• 400 Bad Request: Invalid parameters
• 401 Unauthorized: Invalid credentials
• 429 Too Many Requests: Rate limit exceeded