Skip to content

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.

Claim €5

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.

bash
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 session
This tab runs on your machine.
  • fingerprint picks the device: the same seed gives the same device every time. country picks 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=1 does the same as cloud=True without 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

Updated Nov 22, 2026 · SDK 0.70.4 · browser r63

Was this page helpful?