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.
Install
npm install @proxyshard/shardxQuick start
// 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.