omnify-bypass

Universal Cloudflare & Web Scraping Automation SDK untuk Node.js. Dilengkapi sistem Zero-Config Smart Auto-Bypass (Dual-Tier) yang otomatis memilih jalur tercepat (Probe Instan <1s vs Headless Browser Solver), rotasi proxy cerdas, emulasi sidik jari perangkat, dan pemecah Cloudflare Turnstile native.

⚡ Kenapa omnify-bypass?

• 🚀 Zero-Config Smart Auto-Engine: Tidak perlu bingung setting ini-itu! Cukup panggil fetch(url) atau jalankan CLI, engine otomatis memilih metode tercepat:
  1. Tier 1 (Instant HTTP Probe - <1s): Otomatis mendeteksi celah whitelist crawler sosial (WhatsApp, FB, Twitter, Telegram, Googlebot) tanpa perlu membuka browser Chromium.
  2. Tier 2 (Chromium WAF & Turnstile Solver): Fallback otomatis jika website memicu challenge proteksi interaktif (IUAM / Turnstile widget).
• 🛡️ Bypass Cloudflare Turnstile & WAF: Mengambil cf_clearance dan token Turnstile secara otomatis.
• 🌐 Full Support Android / Termux / Linux VPS / Windows / macOS.
• 🔄 Smart Proxy Pool: Auto-failover, round-robin, dan auto-quarantine saat terkena HTTP 429.
• 📦 Zero External Telemetry: Bersih, cepat, dan aman tanpa pengiriman data ke server pihak ketiga.

📦 Instalasi

Sebagai Node.js SDK

npm install omnify-bypass

Sebagai Global CLI Tool

npm install -g omnify-bypass

Atau jalankan langsung tanpa instalasi:

npx omnify-bypass https://example.com

🚀 Penggunaan Cepat (Quick Start)

1. Simple Drop-in fetch (Otomatis & Cepat)

Anda cukup menggunakan fetch seperti biasa. Jika target bisa ditembus via probe instan, request selesai dalam <1 detik. Jika ada Turnstile/WAF, browser otomatis menyelesaikannya di latar belakang:

const { fetch, omnify } = require('omnify-bypass');

async function main() {
  // Langsung panggil URL target (Zero-Configuration)
  const res = await fetch('https://panel.arqonara.com/auth/login');

  console.log('Status Code:', res.status);        // 200
  console.log('Bypass Method:', res.deviceUsed);  // WhatsApp Crawler Bot (Sub-1s!)
  
  // Dapatkan Text atau JSON
  const html = await res.text();
  console.log('HTML Length:', html.length);
}

main();

🛠️ Fitur Utama

1. Drop-in HTTP Client (fetch / omnify.fetch)

Mendukung semua method HTTP (GET, POST, PUT, DELETE, PATCH), parsing otomatis, dan retry exponential backoff:

const { fetch } = require('omnify-bypass');

const res = await fetch('https://example.com/api/submit', {
  method: 'POST',
  body: { query: 'test data' },
  headers: { 'Content-Type': 'application/json' },
  retries: 3,       // Maksimal percobaan ulang jika limit
  retryDelay: 3000,  // Jeda retry
});

// Helper response yang tersedia:
const text = await res.text();         // String response
const json = await res.json();         // Parsed JSON
const buffer = await res.buffer();     // Buffer biner (download gambar/file)

2. Selesaikan Cloudflare Turnstile (turnstileMax / turnstileMin)

Mengekstrak Turnstile Token valid dari halaman yang memiliki widget Cloudflare Turnstile:

const { omnify } = require('omnify-bypass');

async function getTurnstile() {
  // Selesaikan Turnstile langsung dari halaman target
  const token = await omnify.turnstileMax('https://amprem.omnifylabs.sbs/');
  console.log('Valid Turnstile Token:', token);

  // Atau mode cepat menggunakan SiteKey
  // const token = await omnify.turnstileMin('https://example.com', '0x4AAAAAA...');
}

getTurnstile();

3. Fetch dengan Bot Crawler Tertentu (fetchWithBot)

Jika Anda ingin memaksa User-Agent bot sosial tertentu:

const { fetchWithBot, BOT_PROFILES } = require('omnify-bypass');

// Pilihan bot: 'whatsapp', 'facebook', 'telegram', 'twitter', 'google', 'discord'
const res = await fetchWithBot('https://example.com', 'whatsapp');
console.log(await res.text());

4. Smart Proxy Pool (ProxyPool)

Mendukung proxy HTTP, HTTPS, SOCKS4, dan SOCKS5 dengan auto-failover dan karantina otomatis saat rate-limited (HTTP 429 / Error 1015):

const { fetch, ProxyPool } = require('omnify-bypass');

// Cara 1: Load file proxies.txt
const pool = ProxyPool.fromFile('./proxies.txt', { mode: 'round-robin' });

// Cara 2: Kirim langsung array / string proxy
const res = await fetch('https://example.com', {
  proxy: './proxies.txt', // atau pool / ['http://ip:port', 'socks5://ip:port']
  proxyMode: 'rotate-on-fail',
  autoRotateDevice: true,
});

5. Ekspor Cookie Netscape & Generator cURL

const { omnify } = require('omnify-bypass');

const session = await omnify.wafSession('https://example.com');

// 1. Ekspor cookies format Netscape (untuk yt-dlp, wget, curl)
omnify.exportCookies(session, { domain: 'example.com', file: 'cookies.txt' });

// 2. Generate perintah cURL siap pakai
const curlCmd = omnify.toCurl('https://example.com', session);
console.log(curlCmd);

💻 Panduan Penggunaan CLI

Jalankan langsung melalui terminal menggunakan npx omnify-bypass:

# 1. Otomatis bypass & tampilkan ringkasan
npx omnify-bypass "https://panel.arqonara.com/auth/login"

# 2. Selesaikan Turnstile & dapatkan token
npx omnify-bypass "https://amprem.omnifylabs.sbs/" --max

# 3. Mode cepat dengan bot crawler tertentu
npx omnify-bypass "https://example.com" --bot whatsapp

# 4. Ambil HTML bersih dan simpan ke file
npx omnify-bypass "https://example.com" --source -o page.html

# 5. Hasilkan perintah cURL
npx omnify-bypass "https://example.com" --curl

# 6. Jalankan Reconnaissance Scanner (Subdomain, Port, Endpoint)
npx omnify-bypass "https://example.com" --scan

Tabel Opsi CLI

| Opsi | Keterangan | |---|---| | --bot <name> | Spoof crawler sosial (whatsapp, facebook, telegram, twitter, google, discord) | | --fast | Probe instan cepat tanpa menjalankan browser Chromium | | --max | Mode Turnstile native dengan render halaman penuh | | --min <sitekey> | Mode Turnstile cepat dengan sitekey | | --source, -s | Mengambil dan mencetak HTML halaman bersih | | --output <file>, -o | Menyimpan output (HTML atau JSON) ke file | | --curl | Menghasilkan executable perintah cURL | | --cookie-file <file> | Mengekspor cookies ke format Netscape | | --screenshot <file> | Menyimpan tangkapan layar halaman | | --proxy <url\|file>, -p | Menentukan single proxy atau file proxy list | | --device <type> | Mengatur tipe profil perangkat (desktop, mobile, all, bot) | | --scan, --recon | Menjalankan pemindaian intelijen (Subdomain, Port, Endpoint & WAF) | | --doctor, --check | Menjalankan diagnosa lingkungan & browser | | --install-browser | Mengunduh dan memasang Chromium otomatis | | --json, -j | Format output sebagai JSON | | --stats | Menampilkan statistik antrean dan engine |

🔧 Auto-Installer Chromium

Jika Chromium belum terpasang di VPS / Termux / Server Anda, omnify-bypass menyediakan auto-installer interaktif:

• Termux (Android): pkg install -y chromium x11-repo
• Linux (Ubuntu/Debian): sudo apt-get install -y chromium-browser xvfb
• macOS / Windows: Unduhan otomatis Puppeteer Chrome binaries.

Cek kesiapan browser di sistem Anda:

npx omnify-bypass --doctor

📄 Lisensi

Didistribusikan di bawah lisensi MIT.