Skip to content

Node.js SDK for the antidetect browser

The Node library ships the browser engine and the fingerprint library and runs without the desktop app. Use it inside a scraper, a CI job or a server-side worker.

Package: npm · @proxyshard/shardx (opens in a new tab)

Install

bash
npm install @proxyshard/shardx

Quick start

Node
// npm i @proxyshard/shardx  (illustrative; see the SDK readme)
import { ShardX } from "@proxyshard/shardx";

const sdk = new ShardX();
const profile = await sdk.createProfile("win-rtx4060");
const { browser, close } = await sdk.session(profile, {
  proxy: "socks5://user:pass@host:1080",
});
try {
  const page = await browser.contexts()[0].newPage();
  await page.goto("https://browserleaks.com/quic");
  console.log(await page.title());
} finally {
  await close();
}

What the SDK does for you

  • Downloads the engine and the 220-profile library on first use and caches them by ETag.
  • Probes the proxy for UDP support and turns QUIC on or off accordingly.
  • Resolves timezone, locale and geolocation from the proxy exit country before launch.
  • Randomizes CPU, RAM and platform version once per saved profile so hardware stays coherent.

The Node SDK is a TypeScript library that does not depend on the desktop app. On first use it downloads the patched Chromium 152 engine, the Widevine CDM and the 220-profile fingerprint library into a local cache, then launches isolated browser sessions on demand.

Sessions are driven by patchright, a stealth-patched Playwright, so sdk.session() returns a ready Browser plus a close() that tears down both the client and the engine. Node 18 or later; supported hosts are macOS arm64, Windows x64 and Linux x64.

Read the Node readme (opens in a new tab)

Download ShardBrowser

Native apps for macOS (Apple Silicon), Windows, and Linux.

Standalone SDKs

Python, Node and Rust libraries that ship the browser engine and run without the desktop app.

pip install shardx
Learn how to launch (opens in a new tab)