Get started
Quickstart
Run your first stealth browser session in under five minutes. Connect with Playwright, Puppeteer, or any CDP client — the browser is the product, your stack stays yours.
1. Install the SDK
Pick the SDK for your runtime. The REST API is also available if you'd rather wire it up yourself.
npm install @supernatural/sdk
# or
pip install supernatural2. Get an API key
Create one in the dashboard under Settings → API keys. Keys are scoped to your workspace.
Store keys as environment variables. Never commit them to source.
3. Run your first session
A session is a real Chromium browser running on our cloud, with stealth applied by default. Drive it with Playwright over CDP.
import { chromium } from 'playwright';
import { createSession } from '@supernatural/sdk';
const session = await createSession({
apiKey: process.env.SUPERNATURAL_KEY,
stealth: true,
});
const browser = await chromium.connectOverCDP(session.cdpUrl);
const [context] = browser.contexts();
const page = await context.newPage();
await page.goto('https://example.com');
console.log(await page.title());
await browser.close();
await session.release();from playwright.sync_api import sync_playwright
from supernatural import create_session
session = create_session(stealth=True)
with sync_playwright() as p:
browser = p.chromium.connect_over_cdp(session.cdp_url)
page = browser.contexts[0].new_page()
page.goto("https://example.com")
print(page.title())
browser.close()
session.release()