Skip to main content
Docs API Ref
wss://browser.spider.cloud/v1/browser · CDP

Browser

Spider Browser is a custom browser engine built from the ground up. Connect over WebSocket with Playwright's connectOverCDP(), Puppeteer's connect(), or the spider-browser TypeScript library which adds AI extraction and natural language actions on top.

Connection

browser.spider.cloudCDP
wss://browser.spider.cloud/v1/browser
?token=YOUR-API-KEY
Stealth
Params rewrite the socket URL. Everything else is handled for you.
import { SpiderBrowser } from "spider-browser"

const browser = new SpiderBrowser({ apiKey: process.env.SPIDER_API_KEY! })
await browser.init() // sessions, stealth and geo-routing handled for you

What you get

  • Stealth engine

    Passes major bot-detection suites out of the box.

  • AI native

    Extraction and actions via natural language.

  • Open protocols

    CDP over WebSocket. Any client that speaks it works.

  • Concurrency 100 sessions

    Concurrent sessions per user, on all plans.

  • Residential proxies 199+ countries

    Geo-route any session with the country param.

  • Session recording

    Screencast and interaction capture, replay from the dashboard.

Session parameters

token string query required

Your API key, starting with sk-. A signed-in dashboard session token also works.

s integer 1-3 query default: automatic

Proxy quality tier. 1 is standard, 2 is residential, 3 is mobile. Higher tiers are harder to block. Omit it and Spider Cloud raises the tier itself after a failure.

country string query optional

Two-letter country code for proxy geo-routing.

Tip

Append these as query params to the WebSocket URL. Everything else, TLS fingerprints, headers, proxy rotation, is handled for you.

Examples

import { SpiderBrowser } from "spider-browser"

const browser = new SpiderBrowser({
  apiKey: process.env.SPIDER_API_KEY!,
})
await browser.init()
await browser.page.goto("https://example.com")

// extract structured data with AI
const prices = await browser.extract("Get all product prices")

// perform actions with natural language
await browser.act("Add the cheapest item to the cart")

// take a screenshot
const screenshot = await browser.page.screenshot()

await browser.close()

spider-browser on npm · GitHub · Benchmarks · Session recordings