🤖 Telegram Username Claimer Bot

Bot untuk mengklaim username Telegram secara otomatis ke channel atau akun dengan kecepatan tinggi.

📋 Fitur

• ✅ Monitor multiple username secara bersamaan
• ⚡ Klaim otomatis dengan kecepatan tinggi
• 📢 Klaim ke channel atau akun pribadi
• 🔔 Notifikasi real-time ke channel
• 🔄 Auto-retry saat gagal
• 🛡️ Anti rate-limit
• 🌐 Support proxy SOCKS5
• 📊 Statistik monitoring
• 🤖 Bot Manager - Kelola semua konfigurasi via Telegram Bot
• 💾 Database SQLite - Simpan konfigurasi dan riwayat
• 🎯 Pattern Generator - Generate username dengan pola (vip, bot, trx, dll)
• 🔍 NFT Checker - Filter username NFT vs non-NFT

📁 Struktur Proyek

telegram_username_claimer/
├── telegram_username_claimer/
│   ├── __init__.py          # Package initialization
│   ├── bot.py               # Bot utama
│   ├── claimer.py           # Logika klaim username
│   ├── config.py            # Konfigurasi
│   └── utils.py             # Utilitas
├── config/                   # Folder konfigurasi (opsional)
├── logs/                     # Folder log
├── main.py                   # Entry point
├── interactive.py            # Mode interaktif
├── requirements.txt          # Dependencies
├── .env.example              # Contoh konfigurasi
└── README.md                 # Dokumentasi

🚀 Instalasi

1. Clone Repository

git clone <repository-url>
cd telegram_username_claimer

2. Install Dependencies

pip install -r requirements.txt

3. Konfigurasi

Dapatkan API Credentials

1. Buka https://my.telegram.org
2. Login dengan nomor telepon Anda
3. Pilih "API development tools"
4. Buat aplikasi baru dan catat API_ID dan API_HASH

Setup Environment

# Salin file konfigurasi
cp .env.example .env

# Edit file .env dengan kredensial Anda
nano .env

Konfigurasi Wajib

API_ID=12345678
API_HASH=your_api_hash_here
PHONE_NUMBER=+6281234567890
TARGET_USERNAMES=targetusername

📖 Cara Penggunaan

Mode Bot Manager (Recommended) 🆕

Kelola semua konfigurasi melalui Telegram Bot - tidak perlu edit file .env!

# Jalankan Bot Manager
python run_bot_manager.py

Fitur Bot Manager:

• 📝 Input API ID & Hash via chat
• 📱 Login dengan verifikasi kode + 2FA
• 🎯 Tambah/hapus username target via chat
• 📊 Lihat statistik dan riwayat klaim
• ▶️ Mulai/stop monitoring

Cara menggunakan:

1. Buat bot baru di @BotFather
2. Set BOT_TOKEN di .env
3. Jalankan python run_bot_manager.py
4. Buka bot Anda di Telegram
5. Kirim /start dan ikuti petunjuk

Mode Command Line

# Cek ketersediaan username
python main.py --check username1,username2

# Klaim langsung untuk akun pribadi
python main.py --claim targetusername

# Monitor dan auto-claim untuk akun
python main.py --monitor username1,user2

# Klaim untuk channel
python main.py --monitor username1 --channel -1001234567890

# Mode agresif (lebih cepat, risiko rate limit)
python main.py --monitor username1 --aggressive

# Set interval custom
python main.py --monitor username1 --interval 0.3

Mode Interaktif

python interactive.py

Monitoring dari .env

# Jalankan langsung (username dari TARGET_USERNAMES di .env)
python main.py

⚙️ Konfigurasi Lengkap

Parameter	Deskripsi	Default
API_ID	API ID dari my.telegram.org	-
API_HASH	API Hash dari my.telegram.org	-
PHONE_NUMBER	Nomor telepon dengan kode negara	-
TARGET_USERNAMES	Username yang akan diklaim (koma)	-
NOTIFICATION_CHANNEL	Channel untuk notifikasi	-
CHECK_INTERVAL	Interval cek dalam detik	0.5
MAX_RETRIES	Maksimal retry saat gagal	10
AGGRESSIVE_MODE	Mode cepat (risiko rate limit)	false
LOG_LEVEL	Level logging	INFO

Proxy Settings

PROXY_HOST=127.0.0.1
PROXY_PORT=1080
PROXY_USERNAME=user
PROXY_PASSWORD=pass

🎯 Tips Penggunaan

1. Persiapan Sebelum Username Available

• Siapkan bot dan jalankan monitoring SEBELUM waktu username akan available
• Gunakan mode agresif untuk respons tercepat
• Pastikan koneksi internet stabil

2. Multiple Username

# Monitor beberapa username sekaligus
python main.py --monitor user1,user2,user3

3. Notifikasi

Set NOTIFICATION_CHANNEL untuk mendapat notifikasi saat:

• Monitoring dimulai
• Username tersedia
• Berhasil/gagal klaim

4. Rate Limit

Jika terkena rate limit:

• Tunggu beberapa menit
• Kurangi CHECK_INTERVAL
• Matikan AGGRESSIVE_MODE

📊 Contoh Output

╔══════════════════════════════════════════════════════════╗
║     🤖 TELEGRAM USERNAME CLAIMER BOT                     ║
╚══════════════════════════════════════════════════════════╝

📋 Validasi username:
  ✅ @targetuser

🔌 Menghubungkan ke Telegram...
✅ Berhasil login sebagai: John (@johndoe)

🚀 Mulai monitoring 1 username...
📋 Target: @targetuser
⏱️ Interval: 0.5 detik

🎯 Username @targetuser TERSEDIA!
✅ Berhasil klaim @targetuser untuk akun Anda!

==================================================
📊 SUMMARY
==================================================
⏱️ Durasi: 125.3 detik
🔄 Total pengecekan: 250
✅ Berhasil diklaim: 1
   @targetuser
==================================================

⚠️ Peringatan

1. Gunakan dengan bijak - Jangan spam atau menyalahgunakan
2. Rate Limit - Telegram memiliki batasan request, hindari terlalu agresif
3. Akun Banned - Penggunaan berlebihan bisa menyebabkan akun dibatasi
4. Legal - Pastikan penggunaan sesuai dengan ToS Telegram

🤝 Kontribusi

Kontribusi sangat diterima! Silakan buat Pull Request atau Issue.

📄 Lisensi

MIT License - Silakan gunakan dan modifikasi sesuai kebutuhan.

---

Catatan: Bot ini menggunakan Telethon (Telegram Client) karena Bot API tidak memiliki kemampuan untuk mengubah username channel. Anda perlu login dengan akun Telegram biasa.

📚 Dokumentasi Tambahan

• 📖 Setup VPS Guide (Debian 13) - Panduan lengkap menjalankan di VPS
• 🏗️ Bot Structure - Struktur kerja dan fitur bot
• 🌍 Rekomendasi Negara: Kazakhstan (+7), Uzbekistan (+998), Russia (+7), Ukraine (+380), India (+91)