docs: add README.md with comprehensive instructions

2026-07-07 23:21:06 +07:00
parent aac4a943bd
commit 5af0488e66
1 changed files with 87 additions and 0 deletions
@@ -0,0 +1,87 @@
+# Evolink API Keys Auto-Generator (CloakBrowser + Playwright)
+
+Sistem perekam otomatisasi (*automation click recorder*) dan pembuat API Key otomatis untuk platform **Evolink.ai** menggunakan browser anti-deteksi **CloakBrowser** dan **Playwright** di Node.js.
+
+Proyek ini dirancang khusus untuk mengotomatisasi pendaftaran/login menggunakan akun Google, navigasi ke dashboard, pembuatan API Key baru, hingga menyalin dan menyimpannya secara otomatis ke dalam file lokal.
+
+---
+
+## 🚀 Fitur Utama
+
+1. **Perekam Aksi Interaktif (`recorder.js`)**:
+   - Merekam seluruh aksi Anda (klik, ketikan teks, navigasi) pada browser Chromium standar.
+   - Secara otomatis mendeteksi pembukaan tab baru atau jendela popup.
+   - Mengompilasi hasil rekaman menjadi script otomatisasi bersih (`automation.js`) saat browser ditutup.
+   - Mampu menangani *lookahead* untuk mencegah *race condition* pada tab baru.
+
+2. **Otomatisasi Anti-Deteksi (`automation.js`)**:
+   - Berjalan menggunakan **CloakBrowser** (Chromium kustom dengan modifikasi tingkat C++ pada WebGL, Canvas, font, WebRTC, dll. untuk melewati deteksi Cloudflare & Google).
+   - Mendukung **Multi-Account Looping** yang membaca daftar email & password dari file `akun.txt`.
+   - Menggunakan konteks browser terisolasi (`newContext`) pada tiap akun untuk mencegah kebocoran sesi/cookies.
+   - **Dual-Method API Key Extraction**: Mengambil kunci API yang dibuat dengan membaca clipboard sistem browser atau memindai DOM modal secara dinamis.
+   - Menyimpan seluruh API Key yang berhasil dibuat ke dalam file `api_keys.txt` dengan format `email|api_key`.
+   - Mendukung eksekusi tanpa tampilan (**Headless Mode**).
+
+---
+
+## 📦 Prasyarat & Instalasi
+
+Pastikan Anda telah menginstal [Node.js](https://nodejs.org/) (versi 20 atau yang lebih baru).
+
+1. Clone repositori ini dan masuk ke direktori proyek.
+2. Instal semua dependensi Node.js:
+   ```bash
+   npm install
+   ```
+3. Unduh binary browser CloakBrowser khusus (otomatis terunduh saat pertama kali Anda menjalankan script otomatisasi, atau Anda bisa membiarkannya berjalan sendiri).
+
+---
+
+## 🛠️ Panduan Penggunaan
+
+### 1. Konfigurasi Akun (`akun.txt`)
+Buat file `akun.txt` di direktori utama proyek (jika belum ada) dan isi daftar akun Google Anda dengan format:
+```text
+[email protected]|password_anda1
+[email protected]|password_anda2
+```
+*Catatan: Baris berawalan `#` akan diabaikan oleh sistem sebagai komentar.*
+
+### 2. Merekam Aksi Baru (Opsional)
+Jika Anda ingin merekam alur otomatisasi baru:
+1. Jalankan perekam:
+   ```bash
+   node recorder.js
+   ```
+2. Browser Chromium akan terbuka. Silakan lakukan navigasi, klik, isi formulir, atau buka tab baru.
+3. Tutup browser Chromium atau tekan `Ctrl+C` di terminal. Script otomatisasi `automation.js` baru akan otomatis ter-compile dan memperbarui file sebelumnya.
+
+### 3. Menjalankan Otomatisasi (CloakBrowser)
+Jalankan script otomatisasi untuk mulai membuat API Key secara massal:
+
+* **Mode Tampilan Visual (Default)**:
+  ```bash
+  node automation.js
+  ```
+* **Mode Headless (Tanpa Tampilan Browser)**:
+  ```bash
+  node automation.js --headless true
+  ```
+
+Setelah selesai, seluruh API Key yang berhasil dibuat dan disalin akan tersimpan di file **`api_keys.txt`**.
+
+---
+
+## 📂 Struktur File
+
+- **`automation.js`**: Script otomatisasi inti yang menjalankan CloakBrowser untuk looping akun dan pembuatan API Key.
+- **`recorder.js`**: Perekam klik dan ketikan interaktif berbasis Chromium.
+- **`akun.txt`**: Tempat menyimpan daftar akun Google (`email|password`).
+- **`api_keys.txt`**: Output file hasil akhir penyimpanan API Key (`email|api_key`).
+- **`session_logs.json`**: File log temporer yang menampung rekaman aksi secara real-time.
+- **`.gitignore`**: Mengamankan file kredensial (`akun.txt`) dan file hasil (`api_keys.txt`) agar tidak terunggah ke Git.
+
+---
+
+## ⚠️ Catatan Keamanan
+Selalu pastikan file **`akun.txt`** dan **`api_keys.txt`** masuk ke dalam `.gitignore` Anda sebelum melakukan push ke repositori publik untuk mencegah kebocoran informasi kredensial akun Google Anda.