DOCS · QUICK START

Connect an agent to a real remote browser.

Remote Browser gives AI agents a hosted Chromium session with CDP access, stealth fingerprints, persistent profiles, live viewers, and proxy egress. Create a session, hand the websocket URL to your agent, and drive the web without running Chrome locally.

Create a session

Use your API key from the console. The response includes a CDP websocket URL, a live viewer URL, and the session id.

curl
curl https://api.remote-browser.dev/v1/sessions \
  -H "Authorization: Bearer $REMOTE_BROWSER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "region": "fra1",
    "profile": "agent-default",
    "stealth": true,
    "proxy": { "type": "residential", "country": "US" }
  }'

Connect over CDP

Any CDP-compatible tool can attach to the returned websocket. Keep the session open while your agent works; close it when the task is done.

response.json
{
  "id": "rb_sess_8f3a",
  "cdpUrl": "wss://cdp.remote-browser.dev/sessions/rb_sess_8f3a",
  "viewerUrl": "https://app.remote-browser.dev/sessions/rb_sess_8f3a",
  "status": "ready"
}