A Node.js API service that bypasses Cloudflare protection. It uses puppeteer-real-browser to automatically solve challenges and returns the necessary cookies and headers for you to make subsequent requests directly to the target website.
The main idea behind Unflare is that it handles the Cloudflare protection page — the one you see when visiting a site protected by Cloudflare — and returns a valid cf_clearance token. This token proves the challenge was solved and allows your own scripts or browser to access the page without going through the challenge again.
The preferred way to run it is by using Docker (scroll to the bottom of the Readme)
- Handles GET and POST (form data) requests
- Supports proxy configuration (Host/Port/Auth)
- Includes logging
- Takes automatic screenshots on errors or Cloudflare blocks
- The screenshots are saved at
/screenshotsinside the container
- The screenshots are saved at
- Node.js 14+
- Linux requires
Xvfbpackage (if not using Docker) - Docker image includes all dependencies
Send a POST request to /scrape with a JSON body:
| Field | Type | Required | Description |
|---|---|---|---|
url |
string | yes | Target URL |
timeout |
number | yes | Max time in milliseconds |
method |
string | no | HTTP method: "GET" (default) or "POST" |
data |
object | no | Form data for POST requests |
proxy |
object | no | { host, port, username, password } |
{
"url": "https://example.com",
"timeout": 60000,
"method": "GET",
"proxy": {
"host": "proxy.example.com",
"port": 8080,
"username": "user",
"password": "pass"
}
}{
"cookies": [
{
"name": "cf_clearance",
"value": "abc123...",
"domain": ".example.com",
"path": "/",
"expires": 1676142392.307484,
"httpOnly": true,
"secure": true
},
// more cookies
],
"headers": {
"user-agent": "Mozilla/5.0...",
// more headers
}
}Returns valid session cookies (e.g. cf_clearance) and browser headers.
{
"code": "error",
"message": "..."
}curl -X POST http://localhost:5002/scrape \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com", "timeout": 60000}'const res = await fetch('http://localhost:5002/scrape', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
url: 'https://example.com',
timeout: 60000,
proxy: {
host: "proxy.example.com",
port: 8080,
username: "user",
password: "pass"
}
})
});
const { cookies, headers } = await res.json();
// Use cookies/headers for next requests- Build & Run:
docker build -t unflare .
docker run -p 5002:5002 unflare- Or if you prefer Docker Compose:
services:
unflare:
image: ghcr.io/iamyegor/unflare
ports:
- "5002:5002"