bycf-lite

SDK Node.js berkinerja tinggi untuk menangani tantangan keamanan Cloudflare (Turnstile & WAF). Dirancang untuk integrasi yang mudah, cepat, dan andal.

✨ Fitur Utama

• 🤖 Auto Mode: Ekstraksi Sitekey & Solusi Turnstile dalam satu pemanggilan.
• ⚡ High Performance: Respon cepat dengan sistem antrian cerdas.
• ️ WAF Bypass: Melewati halaman "Checking your browser" secara otomatis.
• 🔍 Smart Extractor: Memindai HTML dan file JS eksternal untuk menemukan Sitekey tersembunyi.
• 📊 Real-time Stats: Monitoring status server secara langsung.

📦 Instalasi

npm install bycf-lite

Cara Penggunaan

1. Mode Otomatis (Direkomendasikan)

Cukup berikan URL target, sistem akan mencari Sitekey dan menyelesaikan CAPTCHA secara otomatis.

const { shz: bycf } = require('bycf-lite');

(async () => {
  try {
    const result = await bycf.turnstileAuto('https://target-website.com/login');
    console.log('Token:', result.token);
    console.log('Sitekey yang digunakan:', result.siteKey);
  } catch (err) {
    console.error(`Error [${err.code}]:`, err.message);
  }
})();

2. Mode Manual (Jika Sitekey Diketahui)

const token = await bycf.turnstileMin(
  'https://target-website.com/login', 
  '0x4AAAAAA...sitekey_anda'
);

3. Bypass WAF & Scraping

// Mendapatkan cookie sesi
const session = await bycf.wafSession('https://target-website.com');

// Mengambil source code HTML setelah bypass
const html = await bycf.source('https://target-website.com/data');

📚 Referensi Metode

| Metode | Deskripsi | Return | |--------|-----------|--------| | turnstileAuto(url) | Ekstrak sitekey & solve otomatis | { token, siteKey, method } | | turnstileMin(url, siteKey) | Solve cepat via injeksi | string (Token) | | turnstileMax(url) | Solve via full rendering | string (Token) | | wafSession(url) | Bypass WAF & ambil cookie | { cookies, headers } | | source(url) | Scraping HTML utuh | string (HTML) | | extractSitekey(url) | Cari sitekey di halaman | { method, keys[] } | | stats() | Cek status server | object |

⚠️ Penanganan Error

Semua metode akan melempar BycfError jika terjadi kegagalan.

try {
  await bycf.turnstileAuto('https://target.com');
} catch (err) {
  if (err.code === 'FORBIDDEN') {
    console.log('URL ini diblokir oleh sistem.');
  } else if (err.code === 'RATE_LIMIT') {
    console.log('Terlalu banyak request, coba lagi nanti.');
  }
}

Lisensi

MIT License. Bebas digunakan untuk proyek pribadi maupun komersial.