🔓 Cloudflare Turnstile Solver

Solver Cloudflare Turnstile otomatis menggunakan puppeteer-real-browser. Mendukung dua mode solve, screen recording, dan proxy.

✨ Fitur

• Solve Cloudflare Turnstile secara otomatis
• Mode Sitekey — inject fake page dengan sitekey eksplisit
• Mode Page — solve langsung dari halaman target (auto-detect turnstile)
• Screen recording tiap sesi (.mp4) via puppeteer-screen-recorder
• Support proxy dengan autentikasi
• Output token dalam format JSON

📦 Instalasi

npm install turnstilesolver

🔧 Penggunaan sebagai Module

const TurnstileSolver = require('turnstilesolver');

const solver = new TurnstileSolver({
  timeout: 60000,       // ms tunggu token
  record: true,         // aktifkan screen recording
  recordDir: './recordings',
  // proxy: { host: '...', port: 8080, username: 'user', password: 'pass' },
  width: 1280,
  height: 720,
});

await solver.initialize();

// Mode 1: pakai sitekey eksplisit
const result = await solver.solve('https://example.com', '0x4AAAAAAA...');

// Mode 2: langsung dari halaman target (tanpa sitekey)
const result = await solver.solve('https://example.com');

console.log(result);
await solver.cleanup();

Options Konstruktor

| Option | Tipe | Default | Deskripsi | |--------|------|---------|-----------| | timeout | number | 60000 | Batas waktu tunggu token (ms) | | record | boolean | false | Aktifkan screen recording | | recordDir | string | ./recordings | Folder output recording | | proxy | object | null | { host, port, username, password } | | width | number | 1280 | Viewport & recording width | | height | number | 720 | Viewport & recording height |

Method

| Method | Deskripsi | |--------|-----------| | initialize() | Launch browser (opsional, auto-called saat solve) | | solve(url, siteKey?) | Solve turnstile — pakai sitekey kalau diisi, auto-detect kalau tidak | | solveWithSitekey(url, siteKey) | Inject fake page dengan sitekey eksplisit | | solveFromPage(url) | Solve langsung dari halaman target | | cleanup() | Tutup browser |

📤 Output

Berhasil:

{
  "success": true,
  "creator": "XAi Community",
  "token": "0.eyJhbGci...",
  "time": 4.231
}

Gagal:

{
  "success": false,
  "error": "Token invalid or empty",
  "time": 60.012
}

📁 Recording

Kalau record: true, setiap sesi disimpan ke recordDir dengan nama:

recordings/
├── sitekey_0x4AAAAAAA_1747123456789.mp4   ← mode sitekey
└── page_solve_1747123456789.mp4            ← mode page

⚙️ Cara Kerja

Mode Sitekey (solveWithSitekey)

1. Request interception aktif — halaman target dibalas dengan fake HTML berisi widget Turnstile
2. puppeteer-real-browser + turnstile: true handle solve otomatis
3. Token diambil dari input hidden [name="cf-response"]

Mode Page (solveFromPage)

1. Script inject via evaluateOnNewDocument untuk polling window.turnstile.getResponse()
2. Token yang ditemukan ditulis ke input hidden [name="cf-response"]
3. waitForSelector menunggu sampai token siap

📋 Requirements

• Node.js >= 18
• ffmpeg (dibutuhkan puppeteer-screen-recorder untuk encode MP4)
• Xvfb (untuk headless di Linux — dihandle otomatis oleh puppeteer-real-browser)

⚠️ Disclaimer

Tool ini dibuat untuk keperluan edukasi dan testing. Penggunaan untuk bypass proteksi tanpa izin pemilik situs adalah tanggung jawab pengguna sepenuhnya.