🤖 Social Media Report Bot

Bot automat pentru raportarea conturilor pe multiple platforme sociale cu interfață web de control.

📋 Caracteristici

Platforme Suportate

• Instagram - Raportare automată prin Selenium
• Facebook - Raportare automată prin Selenium
• Twitter/X - Raportare automată prin Selenium
• TikTok - Raportare automată prin Selenium
• Telegram - Raportare prin API oficial
• WhatsApp - Raportare prin WhatsApp Web

Funcționalități

• ✅ Interfață Web - Control complet prin browser
• ✅ Campanii Multiple - Raportare în masă pe mai multe platforme
• ✅ Anti-Detecție - User agents aleatori, timpi de așteptare umani
• ✅ Statistici Detaliate - Monitorizare progres și rezultate
• ✅ Logging Complet - Înregistrare toate acțiunile
• ✅ Configurare Flexibilă - Setări personalizabile
• ✅ Rate Limiting - Protecție împotriva blocării

🚀 Instalare

1. Cerințe de Sistem

• Python 3.8+
• Chrome/Chromium browser
• Conexiune internet stabilă

2. Clonare Proiect

git clone <repository-url>
cd report-bot

3. Instalare Dependențe

pip install -r requirements.txt

4. Configurare

A. Copiază fișierul de configurare

cp .env.example .env

B. Editează .env cu datele tale:

# Telegram API (obligatoriu pentru Telegram)
TELEGRAM_API_ID=your_api_id
TELEGRAM_API_HASH=your_api_hash
TELEGRAM_PHONE=+40123456789

# WhatsApp (obligatoriu pentru WhatsApp)
WHATSAPP_PHONE=+40123456789

# Conturi demo pentru platforme (opțional)
INSTAGRAM_USERNAME=demo_username
INSTAGRAM_PASSWORD=demo_password

FACEBOOK_USERNAME=demo_username
FACEBOOK_PASSWORD=demo_password

TWITTER_USERNAME=demo_username
TWITTER_PASSWORD=demo_password

TIKTOK_USERNAME=demo_username
TIKTOK_PASSWORD=demo_password

C. Obținere API Telegram

1. Mergi la https://my.telegram.org/
2. Loghează-te cu numărul de telefon
3. Creează o aplicație nouă
4. Copiază API ID și API Hash în .env

🎯 Utilizare

1. Pornire Bot

python run.py

2. Acces Interfață Web

Deschide browserul la: http://localhost:5000

Date de login:

• Username: admin
• Password: admin123

3. Configurare Platforme

1. Mergi la Settings în interfața web
2. Completează credențialele pentru platformele dorite
3. Testează conexiunile cu butonul Test Connection

4. Pornire Campanie

1. Mergi la pagina principală
2. Introdu țintele (username-uri sau URL-uri), câte una pe linie:

   @username1
   @username2
   https://instagram.com/username3
   

3. Selectează platformele dorite
4. Alege motivul raportării
5. Apasă Start Campaign

📊 Interfața Web

Dashboard

• Statistici generale - Rapoarte reușite/eșuate, rata de succes
• Status platforme - Conexiuni active, ultimele erori
• Activitate recentă - Istoricul raportărilor
• Grafice performanță - Vizualizare date

Setări

• Configurare conturi - Credențiale pentru fiecare platformă
• Setări avansate - Timeouts, proxy, user agents
• Test conexiuni - Verificare status platforme

⚙️ Configurare Avansată

Fișierul config.py

# Setări generale
DEBUG = True
HEADLESS_BROWSER = True
MAX_RETRY_ATTEMPTS = 3
REPORT_DELAY = 5  # secunde între rapoarte

# Timeouts
PAGE_LOAD_TIMEOUT = 30
ELEMENT_TIMEOUT = 10

# Motivele de raportare pentru fiecare platformă
REPORT_REASONS = {
    'instagram': ['Spam', 'Harassment', 'Violence', 'Inappropriate'],
    'facebook': ['Spam', 'Harassment', 'Violence', 'Fake Account'],
    # ...
}

Logging

Logurile se salvează în directorul logs/:

• bot.log - Log general
• reports.log - Rapoarte specifice
• errors.log - Doar erorile

🔧 Depanare

Probleme Comune

1. Eroare "ChromeDriver not found"

# Reinstalează webdriver-manager
pip uninstall webdriver-manager
pip install webdriver-manager

2. Telegram API Error

• Verifică API_ID și API_HASH în .env
• Asigură-te că numărul de telefon este corect
• Prima conectare necesită cod de verificare

3. WhatsApp QR Code

• WhatsApp necesită scanarea codului QR
• Setează HEADLESS_BROWSER = False în config.py
• Scanează codul QR când apare

4. Rate Limiting

• Mărește REPORT_DELAY în config.py
• Folosește mai puține ținte per campanie
• Așteaptă între campanii

Verificare Status

# Verifică logurile
tail -f logs/bot.log

# Testează conexiunile
python -c "from main import get_bot_coordinator; print(get_bot_coordinator().test_all_connections())"

📁 Structura Proiectului

report-bot/
├── platforms/              # Module pentru fiecare platformă
│   ├── instagram_reporter.py
│   ├── facebook_reporter.py
│   ├── twitter_reporter.py
│   ├── tiktok_reporter.py
│   ├── telegram_reporter.py
│   └── whatsapp_reporter.py
├── utils/                  # Utilitare
│   ├── logger.py
│   └── browser_manager.py
├── templates/              # Template-uri HTML
│   ├── base.html
│   ├── index.html
│   ├── dashboard.html
│   ├── settings.html
│   └── login.html
├── static/                 # Fișiere statice
│   ├── css/style.css
│   └── js/app.js
├── logs/                   # Fișiere de log
├── main.py                 # Coordinator principal
├── web_interface.py        # Interfața web Flask
├── run.py                  # Script de pornire
├── config.py               # Configurări
├── requirements.txt        # Dependențe
├── .env.example           # Template variabile mediu
└── README.md              # Documentație

⚠️ Avertismente Importante

Utilizare Responsabilă

• Respectă termenii platformelor sociale
• Nu abuzează de funcționalitatea de raportare
• Folosește doar pentru conturi cu adevărat problematice
• Verifică că țintele încalcă cu adevărat regulile

Limitări Legale

• Botul este pentru uz educațional și de cercetare
• Nu ne asumăm responsabilitatea pentru utilizarea abuzivă
• Utilizatorul este responsabil pentru acțiunile sale
• Respectă legile locale și internaționale

Securitate

• Nu partaja credențialele în fișiere publice
• Folosește conturi demo pentru testare
• Activează 2FA pe conturile principale
• Monitorizează activitatea conturilor

🆘 Suport

Probleme și Bug-uri

1. Verifică secțiunea Depanare
2. Consultă logurile din logs/
3. Testează cu un singur target mai întâi

Contribuții

• Fork repository-ul
• Creează branch pentru feature
• Testează modificările
• Trimite pull request

📄 Licență

Acest proiect este pentru uz educațional. Utilizarea în scopuri comerciale sau abuzive este interzisă.

---

⚡ Dezvoltat pentru automatizarea responsabilă a raportărilor pe rețelele sociale