rebrowser

rebrowser-playwright and rebrowser-puppeteer are Playwright and Puppeteer with rebrowser-patches applied, which close the automation leaks anti-bot scripts look for in the plain libraries. The API is the same; only the package and the import change. Both connect to a Surfsky browser over the session’s CDP WebSocket URL, like Playwright. Patchright is the other maintained fork. To have a coding agent set this up in your project, give it the setup prompt.

Use human-emulation commands for clicks, typing, and scrolling. Keep rebrowser-playwright for navigation, selectors, waiting, and page content.

Prerequisites

Set your API token and base URL. The browser runs in Surfsky’s cloud, so skip the fork’s browser download step. Proxy, fingerprint, and other start options are in the API reference.

Run an example

The examples use a one-time profile. To reuse a saved login, pass a persistent profile UUID to the session call instead.

Python
TypeScript

Requires Python 3.12 or newer.

pip install surfsky rebrowser-playwright

Save as surfsky_rebrowser.py:

import asyncio
from rebrowser_playwright.async_api import async_playwright
from surfsky import AsyncSurfsky


async def main():
    async with (
        AsyncSurfsky() as client,
        client.session() as session,
        async_playwright() as pw,
    ):
        browser = await pw.chromium.connect_over_cdp(session.connect_url)
        context = browser.contexts[0]
        page = context.pages[0] if context.pages else await context.new_page()
        await page.goto("https://example.com")
        print(await page.title())


asyncio.run(main())

Run it:

python surfsky_rebrowser.py

Requires Node.js 24 or newer, or Bun: both run TypeScript directly and support await using.

npm install surfsky rebrowser-playwright-core

Save as surfsky-rebrowser.mts:

import { chromium } from "rebrowser-playwright-core";
import { Surfsky } from "surfsky";

const client = new Surfsky();
await using session = await client.session();
const browser = await chromium.connectOverCDP(session.ws_url);
try {
  const context = browser.contexts()[0];
  const page = context.pages()[0] ?? (await context.newPage());
  await page.goto("https://example.com");
  console.log(await page.title());
} finally {
  await browser.close();
}

Run it:

node surfsky-rebrowser.mts

Expected output:

Example Domain

The session scope stops the browser when it exits, including on errors. browser.close() over CDP only disconnects.

rebrowser-puppeteer

For Puppeteer code, the same patches ship as rebrowser-puppeteer-core:

npm install surfsky rebrowser-puppeteer-core

Save as surfsky-rebrowser-puppeteer.mts:

import puppeteer from "rebrowser-puppeteer-core";
import { Surfsky } from "surfsky";

const client = new Surfsky();
await using session = await client.session();
const browser = await puppeteer.connect({
  browserWSEndpoint: session.ws_url,
  defaultViewport: null,
});
try {
  const page = (await browser.pages())[0] ?? (await browser.newPage());
  await page.goto("https://example.com");
  console.log(await page.title());
} finally {
  await browser.disconnect();
}

Run it with node surfsky-rebrowser-puppeteer.mts. defaultViewport: null keeps the window size from the profile’s fingerprint.

Get started

Connect your tools

Browser sessions

Browser actions

CAPTCHA guides

Debugging

Performance and limits

About Surfsky

Prerequisites

Run an example

rebrowser-puppeteer