Package Exports

cfsolver
cfsolver/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (cfsolver) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

CFSolver Node.js SDK

Node.js HTTP client that automatically bypasses Cloudflare challenges using the CloudFlyer API.

Features

Axios-like API - Familiar HTTP client interface (get, post, put, delete, etc.)
Automatic challenge detection - Detects Cloudflare protection and solves transparently
Multiple solving modes - Auto-detect, always pre-solve, or disable
Turnstile support - Solve Cloudflare Turnstile CAPTCHA and get tokens
TypeScript support - Full type definitions included
Proxy support - HTTP/HTTPS proxies for both requests and API calls
Command-line interface - Quick operations without writing code

Installation

npm install cfsolver

Quick Start

Node.js API

Works similar to axios, but automatically handles Cloudflare challenges:

import { CloudflareSolver } from 'cfsolver';

const solver = new CloudflareSolver('your-api-key');

try {
  const response = await solver.get('https://protected-site.com');
  console.log(response.data);
} finally {
  solver.close();
}

Command Line

# Set API key
export CLOUDFLYER_API_KEY="your-api-key"

# Make a request with automatic bypass
npx cfsolver request https://protected-site.com

# Solve Cloudflare challenge
npx cfsolver solve cloudflare https://protected-site.com

Node.js API
Command Line Interface
Configuration
- Parameters
- Environment Variables
Exceptions

Node.js API

CloudflareSolver

The main client for bypassing Cloudflare challenges.

import { CloudflareSolver } from 'cfsolver';

const solver = new CloudflareSolver('your-api-key');

try {
  const response = await solver.get('https://protected-site.com');
  console.log(response.status);
  console.log(response.data);
} finally {
  solver.close();
}

Supported HTTP Methods

solver.get(url, config?)
solver.post(url, data?, config?)
solver.put(url, data?, config?)
solver.delete(url, config?)
solver.head(url, config?)
solver.options(url, config?)
solver.patch(url, data?, config?)
solver.request(config)

All methods accept the same config options as axios:

const response = await solver.post(
  'https://api.example.com/data',
  { key: 'value' },
  {
    headers: { 'Authorization': 'Bearer token' },
    timeout: 30000,
  }
);

Solving Modes

CFSolver supports three solving modes to balance speed and reliability:

Mode 1: Auto-detect (Default, Recommended)

Solves only when a Cloudflare challenge is detected. Best for most use cases.

const solver = new CloudflareSolver('your-api-key');
// or explicitly:
const solver = new CloudflareSolver('your-api-key', { solve: true, onChallenge: true });

Mode 2: Always Pre-solve

Always solves before each request. Slower but most reliable for heavily protected sites.

const solver = new CloudflareSolver('your-api-key', { solve: true, onChallenge: false });

Mode 3: Disabled

Direct requests only, no challenge solving. Useful for testing or unprotected endpoints.

const solver = new CloudflareSolver('your-api-key', { solve: false });

Turnstile Support

Solve Cloudflare Turnstile CAPTCHA and get the token for form submission:

import { CloudflareSolver } from 'cfsolver';

const solver = new CloudflareSolver('your-api-key');

try {
  // Get the Turnstile token
  const token = await solver.solveTurnstile(
    'https://example.com/login',
    '0x4AAAAAAA...'  // sitekey from cf-turnstile element
  );

  // Use the token in your form submission
  const response = await solver.post('https://example.com/login', {
    username: 'user',
    password: 'pass',
    'cf-turnstile-response': token,
  });
} finally {
  solver.close();
}

Finding the Sitekey

The sitekey is found in the page's HTML within the cf-turnstile element:

<div class="cf-turnstile" data-sitekey="0x4AAAAAAA..."></div>

Proxy Configuration

Single Proxy for All Requests

const solver = new CloudflareSolver('your-api-key', {
  proxy: 'http://proxy.example.com:8080',
});

Separate Proxies for HTTP and API

Use different proxies for your HTTP requests and CloudFlyer API calls:

const solver = new CloudflareSolver('your-api-key', {
  proxy: 'http://fast-proxy:8080',      // For your HTTP requests
  apiProxy: 'http://stable-proxy:8081', // For CloudFlyer API calls
});

Supported Proxy Formats

// HTTP proxy
proxy: 'http://host:port'
proxy: 'http://user:pass@host:port'

// HTTPS proxy
proxy: 'https://host:port'

Command Line Interface

solve cloudflare

Solve a Cloudflare challenge and get cookies:

cfsolver solve cloudflare https://protected-site.com

# With proxy
cfsolver solve cloudflare https://protected-site.com -X http://proxy:8080

# Output as JSON
cfsolver solve cloudflare https://protected-site.com --json

solve turnstile

Solve a Turnstile challenge and get the token:

cfsolver solve turnstile https://example.com 0x4AAAAAAA...

# Output as JSON
cfsolver solve turnstile https://example.com 0x4AAAAAAA... --json

request

Make an HTTP request with automatic challenge bypass:

# GET request
cfsolver request https://protected-site.com

# POST request with data
cfsolver request -m POST -d '{"key":"value"}' https://api.example.com

# With custom headers
cfsolver request -H "Authorization: Bearer token" https://api.example.com

# Save response to file
cfsolver request -o output.html https://protected-site.com

balance

Check your CloudFlyer account balance:

cfsolver balance

CLI Options

Global Options:
  -K, --api-key <key>     API key (or set CLOUDFLYER_API_KEY env var)
  -B, --api-base <url>    API base URL (default: https://solver.zetx.site)
  -v, --verbose           Enable verbose output

Solve Options:
  -X, --proxy <url>       Proxy for requests (scheme://host:port)
  --api-proxy <url>       Proxy for API calls
  -T, --timeout <sec>     Timeout in seconds (default: 120)
  --json                  Output result as JSON

Request Options:
  -m, --method <method>   HTTP method (default: GET)
  -d, --data <data>       Request body (JSON)
  -H, --header <header>   Request header (repeatable)
  -o, --output <file>     Save response to file

Configuration

Parameters

Parameter	Type	Default	Description
`apiBase`	`string`	`https://solver.zetx.site`	CloudFlyer service URL
`solve`	`boolean`	`true`	Enable automatic challenge solving
`onChallenge`	`boolean`	`true`	Solve only when challenge detected
`proxy`	`string`	-	Proxy for HTTP requests
`apiProxy`	`string`	-	Proxy for CloudFlyer API calls
`usePolling`	`boolean`	`false`	Use interval polling instead of long-polling
`timeout`	`number`	`30000`	Request timeout in milliseconds
`verbose`	`boolean`	`false`	Enable verbose logging

Environment Variables

Variable	Description
`CLOUDFLYER_API_KEY`	Your CloudFlyer API key
`CLOUDFLYER_API_BASE`	CloudFlyer service URL

export CLOUDFLYER_API_KEY="your-api-key"

const solver = new CloudflareSolver(process.env.CLOUDFLYER_API_KEY!);

Exceptions

import {
  CloudflareSolver,
  CFSolverError,
  CFSolverAPIError,
  CFSolverChallengeError,
  CFSolverTimeoutError,
  CFSolverConnectionError,
} from 'cfsolver';

const solver = new CloudflareSolver('your-api-key');

try {
  const response = await solver.get('https://protected-site.com');
} catch (error) {
  if (error instanceof CFSolverTimeoutError) {
    console.error('Challenge solving timed out');
  } else if (error instanceof CFSolverChallengeError) {
    console.error('Failed to solve challenge:', error.message);
  } else if (error instanceof CFSolverConnectionError) {
    console.error('Connection failed:', error.message);
  } else if (error instanceof CFSolverAPIError) {
    console.error('API error:', error.message);
  } else if (error instanceof CFSolverError) {
    console.error('CFSolver error:', error.message);
  } else {
    throw error;
  }
} finally {
  solver.close();
}

Exception	Description
`CFSolverError`	Base exception for all CFSolver errors
`CFSolverAPIError`	API request failed
`CFSolverChallengeError`	Challenge solving failed
`CFSolverTimeoutError`	Operation timed out
`CFSolverConnectionError`	Connection to service failed

License

MIT License - see LICENSE for details.

JSPM

cfsolver

Package Exports

Readme

CFSolver Node.js SDK

Features

Installation

Quick Start

Node.js API

Command Line

Table of Contents

Node.js API

CloudflareSolver

Supported HTTP Methods

Solving Modes

Mode 1: Auto-detect (Default, Recommended)

Mode 2: Always Pre-solve

Mode 3: Disabled

Turnstile Support

Finding the Sitekey

Proxy Configuration

Single Proxy for All Requests

Separate Proxies for HTTP and API

Supported Proxy Formats

Command Line Interface

solve cloudflare

solve turnstile

request

balance

CLI Options

Configuration

Parameters

Environment Variables

Exceptions

License

Links