raptorwayz (Node.js)

Solve Cloudflare challenges from Node. Get a valid cf_clearance cookie, the matching User-Agent, and a proxy on the same exit IP, then make your own request with fetch, axios, got, or Playwright.

Official Node client for RaptorWayz. Get an API key (5 free solves) there.

npm install raptorwayz

Usage

import { RaptorWayz } from "raptorwayz";

const rw = new RaptorWayz("bk_your_api_key");
const c = await rw.solve("example.com");

// Attach cookie + User-Agent and route through the proxy, all three together.
// (Node 18+ fetch has no proxy option; use undici's ProxyAgent, axios, or got.)
import { ProxyAgent } from "undici";
const resp = await fetch("https://example.com/", {
  headers: { "User-Agent": c.user_agent, cookie: `cf_clearance=${c.cf_clearance}` },
  dispatcher: new ProxyAgent(c.proxy),
});
console.log(resp.status); // 200

Errors

import { RaptorWayz, RaptorWayzError, NoChallengeError } from "raptorwayz";

try {
  const c = await new RaptorWayz("bk_...").solve("example.com");
} catch (e) {
  if (e instanceof NoChallengeError) { /* no challenge, use e.proxy with a normal UA */ }
  else if (e instanceof RaptorWayzError) { console.log(e.code, e.status, e.secondsUntilNext); }
}

• Zero dependencies (uses built-in fetch, Node 18+).
• Docs: https://raptorwayz.com/docs · OpenAPI: https://raptorwayz.com/openapi.json

MIT licensed. The client is open source; the hosted solving service is proprietary.