Connecting

Point your automation client at a single WebSocket endpoint. Your Browser credentials are inlined into the URL as HTTP Basic auth over TLS on port 443.

The endpoint

Every session connects to the same CDP endpoint. The username and password are inlined into the URL:

wss://USERNAME:PASSWORD@browser.capzy.ai/cdp

Append query parameters to select egress or attach a profile, for example ?proxy=capzy or ?profile=my-identity. See Proxies & geo and Profiles for the full set of values.

Credentials

Your Browser username and password come from Dashboard → Browser. The username is a vanity string with a random suffix. The password can be rotated at any time from the same page, which immediately invalidates the previous one.

The password is shown once

The Browser password is displayed a single time when it is created or rotated. Copy it into your secret store then. If you lose it, rotate to generate a new one.

Client examples

The connection URL is identical across clients. Only the connect call differs. Each example below opens the default context and loads a page.

connect.py

from playwright.sync_api import sync_playwright

CDP = "wss://USER:PASS@browser.capzy.ai/cdp?proxy=capzy"

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(CDP)
    context = browser.contexts[0]        # the default context
    page = context.new_page()
    page.goto("https://example.com")
    print(page.title())

Use the default context

The remote browser already has one browser context open. Reach it with browser.contexts[0] (Playwright) or browser.browserContexts()[0] (Puppeteer) and open pages inside it, rather than creating a fresh context. When you attach a profile, that default context is where its cookies and storage live.

Next steps

Proxies & geo: choose your egress and target a country.
Profiles: attach a persistent identity that stays logged in.
Limits & billing: session duration and concurrency caps.

Overview

Proxies & geo