Patchright

Patchright is a patched Playwright that closes the automation leaks anti-bot scripts look for. The API is the same; only the package and the import change. It connects to a Surfsky browser over the session’s CDP WebSocket URL, like Playwright. rebrowser-playwright 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 Patchright 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 patchright

Save as surfsky_patchright.py:

import asyncio
from patchright.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_patchright.py

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

npm install surfsky patchright-core

Save as surfsky-patchright.mts:

import { chromium } from "patchright-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-patchright.mts

Expected output:

Example Domain

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

Get started

Connect your tools

Browser sessions

Browser actions

CAPTCHA guides

Debugging

Performance and limits

About Surfsky

Prerequisites

Run an example