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
Table of Contents
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.
Links