🤖 Social Media Ad Skipper

Automasi scrolling media sosial dengan deteksi & skip iklan otomatis menggunakan AI Vision (Claude).

Cara Kerja

Program START
     │
     ▼
📸 Ambil Screenshot
     │
     ▼
🔍 Analisis AI (Claude Vision)
     │
     ├─── BUKAN IKLAN ──► ⏱ Tunggu 40 detik ──► ↑ Scroll ──► (ulang)
     │
     └─── IKLAN TERDETEKSI
               │
               ├─── Tombol X tersedia ──► Langsung tap tutup
               │
               ├─── Countdown timer ──► Tunggu N detik ──► Tap tutup
               │
               └─── Skip button ──► Tunggu muncul ──► Tap Skip

Prasyarat

1. Python 3.10+
2. Android Debug Bridge (ADB)
   Download: https://developer.android.com/tools/releases/platform-tools
3. HP Android dengan USB Debugging aktif
   • Pengaturan → Tentang Ponsel → ketuk "Nomor Build" 7x
   • Pengaturan → Opsi Developer → aktifkan "USB Debugging"
4. API Key Anthropic
   Daftar di: https://console.anthropic.com/

Setup

1. Clone / Download program

# Letakkan semua file di satu folder
ls social_auto/
# main.py  config.py  device_controller.py  ad_detector.py  screenshot_manager.py

2. Buat file .env

cp .env.example .env
# Edit .env dengan text editor, isi ANTHROPIC_API_KEY

3. Hubungkan HP

# Colok HP via USB, lalu:
adb devices
# Harus muncul: "XXXXXXXX    device"

4. Jalankan

python main.py

Konfigurasi

Edit .env atau config.py:

Parameter	Default	Keterangan
TARGET_APP	TikTok	Package name aplikasi
SCROLL_INTERVAL	40	Jeda antar scroll (detik)
ADB_DEVICE	auto	Serial device jika ada >1 HP
KEEP_SCREENSHOTS	false	Simpan semua screenshot

Menambah Aplikasi Baru

Edit config.py, tambahkan posisi fallback tombol tutup:

CLOSE_BUTTON_FALLBACK = {
    "namaapp": (0.93, 0.08),  # x_ratio, y_ratio (0.0 - 1.0)
}

Wireless ADB (tanpa kabel)

# 1. Hubungkan via USB sekali dulu
adb tcpip 5555
# 2. Cari IP HP: Pengaturan → WiFi → IP Address
adb connect 192.168.1.xxx:5555
# 3. Cabut kabel, program tetap jalan

Troubleshooting

"ADB tidak ditemukan" → Install Android Platform Tools, tambahkan ke PATH

"Device tidak terdeteksi" → Aktifkan USB Debugging, coba adb devices, izinkan debugging di HP

"API key tidak valid" → Cek .env, pastikan ANTHROPIC_API_KEY benar

Iklan tidak terdeteksi → Periksa automation.log, screenshot tersimpan di folder screenshots/

Log

Program menulis log ke automation.log dan console. Screenshot iklan tersimpan di screenshots/ad_TIMESTAMP.png (jika KEEP_SCREENSHOTS=true).

AI-ad-detector