Cloud quickstart
Start a Clearcote browser on our servers and drive it from Playwright. You need an API key, the SDK and one extra argument.
FreeGet €5 of traffic free when you connect GitHub. No card.
One-time, one per GitHub account. The GitHub account must be at least 30 days old.
1. Get an API key
Create one on the API keys page. It starts with cc_live_. Keep it secret: anyone holding it can spend your balance. Put it in the environment:
export CLEARCOTE_API_KEY=cc_live_...Sessions are paid from a prepaid balance: €1.00 per GB of traffic, residential proxy included. Top up in the Hosted browsers tab of your dashboard. See Pricing and traffic.
2. Add the clearcote package
Cloud mode needs SDK 0.34.0 or newer.
npm i clearcote # Node 20+
pip install clearcote # Python 3.8+3. Launch in the cloud
Pass cloud=True (Python) or cloud: true (Node). You get an ordinary Playwright Browser back, connected to a browser on our servers.
from clearcote import launch
browser = launch(cloud=True, fingerprint="acct-1", country="de")
page = browser.contexts[0].new_page()
page.goto("https://example.com")
print(page.title())
browser.close() # ends the cloud sessionfingerprintpicks the device: the same seed gives the same device every time.countrypicks the exit country of the residential IP.- Open pages in
browser.contexts[0]: it carries the session's profile and cookies. browser.close()ends the session. You pay for the traffic it used, not for the time.- Setting
CLEARCOTE_CLOUD=1does the same ascloud=Truewithout touching the code.
Without the SDK
Any CDP client works: POST /api/v1/browsers returns a single-use connectUrl, and Playwright's connectOverCDP or Puppeteer's connect attaches to it. The full walkthrough, with curl, Node and Python, is on Hosted browsers.
Next
- Local or cloud: what stays the same and what differs from a local launch.
- Options & identities: one identity per account, profiles, pinned releases.
- Exit IPs: rotating, sticky and geo-targeted residential IPs.
- Live view & sessions: watch a session, take control, reconnect.
- Agent runs: send a task in plain words and get JSON back.