🎯 FindYourTrends - Détection Automatique de Niches

Système intelligent de découverte de tendances avec IA, analyse multi-sources et protection anti-blocage.

Version 2.0 - Architecture optimisée | Documentation complète | Découverte automatique par IA

---

🚀 Démarrage Ultra-Rapide

cd src
python trends_safe.py

Choisir Option 1 (Scan LITE) pour un scan quotidien rapide et sécurisé (3-5 min).

---

📚 Documentation Complète

⭐ TOUTE LA DOCUMENTATION EST DANS LE DOSSIER docs/

Pour Débutants

1. docs/RESUME_AUDIT.md - Résumé exécutif (10 min)
2. docs/SYSTEM_AUDIT_ET_MAP.md - Documentation complète (30 min)
3. docs/SETUP_APIS.md - Configuration API keys (15 min)

Index Documentation

Consultez docs/README.md pour l'index complet de la documentation.

---

⚡ Ce qui a changé (v2.0)

✨ Nouvelles Fonctionnalités

• 🤖 Discovery AUTO avec IA - Découvre automatiquement les meilleurs keywords via NLP
• 🛡️ Protection anti-blocage optimisée - Plus d'erreurs 400/429
• 📊 31 keywords auto-découverts - Issus de 1451 discussions Reddit réelles
• 🌟 Scan ENRICHI - Fusion 5 sources (YouTube, Twitter, Product Hunt)
• 📁 Architecture simplifiée - De 24 à 12 fichiers core
• 📖 Documentation complète - 3 guides détaillés dans docs/

🧹 Nettoyage Système

Un script de nettoyage automatique est disponible :

cd src
python cleanup_system.py

Ce qu'il fait :

• ✅ Supprime 8 fichiers doublons
• ✅ Archive les vieux CSV
• ✅ Crée les dossiers results/ et docs/
• ✅ Met à jour les imports automatiquement

⚠️ Lisez d'abord docs/RESUME_AUDIT.md !

---

📁 Structure du Projet (v2.0)

findyourtrends/
├── README.md                           ← Vous êtes ici
│
├── docs/                               📚 DOCUMENTATION COMPLÈTE
│   ├── README.md                       → Index documentation
│   ├── RESUME_AUDIT.md                ⭐ Résumé exécutif
│   ├── SYSTEM_AUDIT_ET_MAP.md         ⭐ Documentation technique
│   ├── SETUP_APIS.md                  ✅ Configuration APIs
│   └── QUERY_OPTIMIZATION.md          ⚠️ Obsolète
│
└── src/
    ├── trends_safe.py                 ⭐ POINT D'ENTRÉE PRINCIPAL
    ├── anti_block_system.py           🛡️ Protection anti-blocage
    ├── keyword_auto_discovery.py      🤖 Découverte IA (NOUVEAU)
    ├── test_api_keys.py              🧪 Test API keys
    ├── cleanup_system.py             🧹 Nettoyage (NOUVEAU)
    │
    ├── config/
    │   └── config.py                  📝 API keys (À configurer)
    │
    ├── data/
    │   ├── geo_config.py              📍 Zones géographiques
    │   ├── keywords_lite.py           ⚡ 11 keywords (scan rapide)
    │   ├── keywords_reddit_auto.py    ⭐ 31 keywords IA (NOUVEAU)
    │   └── keywords_discovered.py     🔄 Généré automatiquement
    │
    ├── enrichment/
    │   ├── youtube_scout.py           🎥 Scraping YouTube
    │   ├── twitter_scout.py           🐦 Scraping Twitter
    │   ├── producthunt_scout.py       🏆 Scraping Product Hunt
    │   └── fusion_engine.py           🔀 Fusion 5 sources
    │
    └── results/                       📁 Résultats (créé auto)
        ├── reddit_data_*.csv
        ├── trend_radar_*.csv
        └── archives/

---

🎯 Fichiers Principaux

🛡️ trends_safe.py

Script principal à utiliser

• Mode LITE : 13 mots-clés, 3-5 min, aucun risque
• Mode COMPLET : 52 mots-clés, 15-20 min, risque modéré
• Protection anti-blocage intégrée

📦 data/geo_config.py

Configuration géographique centralisée

• Zones FR + DOM-TOM (GP, MQ, GF, RE, YT)
• Évite duplication dans keywords.py et keywords_lite.py
• Fonctions utilitaires : get_zone_name(), is_valid_zone()

📊 data/keywords.py

Configuration COMPLÈTE (52 mots-clés)

• 6 catégories : Digital Products, Online Business, Tech & Tools, etc.
• Usage : 1 fois par semaine maximum
• Durée : ~15-20 minutes

⚡ data/keywords_lite.py

Configuration LÉGÈRE (13 mots-clés)

• Mots-clés essentiels à fort ROI
• Usage : quotidien
• Durée : ~3-5 minutes
• AUCUN risque de blocage

🚧 anti_block_system.py

Protection anti-blocage Google Trends

• Limite : 10 requêtes/heure max
• Pauses intelligentes (12-60 secondes)
• Tracking automatique des requêtes
• Détection et arrêt en cas de blocage 429

🧪 test_system.py

Tests avant scan

python test_system.py

Vérifie :

• Limites de requêtes Google Trends
• Fichiers de configuration
• Connexions APIs (Reddit + Google Trends)

---

🎮 Utilisation

Mode LITE (Recommandé quotidien)

python trends_safe.py
# Choix 1: Scan LITE

Avantages :

• ✅ 3-5 minutes seulement
• ✅ Aucun risque de blocage
• ✅ 13 mots-clés essentiels
• ✅ Idéal pour suivi quotidien

Mode COMPLET (Hebdomadaire)

python trends_safe.py
# Choix 2: Scan COMPLET

Avantages :

• 📊 Analyse approfondie (52 mots-clés)
• 🔍 Détection niches émergentes
• ⚠️ À utiliser 1 fois/semaine MAX

---

⚙️ Configuration

Zones géographiques

Modifier src/data/geo_config.py :

# Ajouter une nouvelle zone
ZONES = {
    'FR': 'France métropolitaine',
    'NC': 'Nouvelle-Calédonie',  # Nouvelle zone
    # ...
}

Mots-clés

Pour scan LITE (src/data/keywords_lite.py) :

KEYWORD_CATEGORIES = {
    'Ta Catégorie': [
        'mot-clé 1',
        'mot-clé 2'
    ]
}

⚠️ Limite : 12-15 mots-clés MAX

Pour scan COMPLET (src/data/keywords.py) :

# Pas de limite stricte, mais 50-70 mots-clés recommandé

Reddit API

Modifier src/config/config.py :

REDDIT_CLIENT_ID = "ton_client_id"
REDDIT_CLIENT_SECRET = "ton_secret"
REDDIT_USER_AGENT = "Ton User Agent"

---

🛡️ Système Anti-Blocage

Comment ça marche ?

1. Tracking des requêtes

   • Max 10 requêtes/heure
   • Sauvegarde dans trends_request_cache.json

2. Pauses intelligentes

   • Requêtes 1-5 : 12-20 secondes
   • Requêtes 6-10 : 30 secondes
   • Après 10 : 60 secondes

3. Détection automatique

   • Si erreur 429 → Arrêt immédiat
   • Recommandation : attendre 30-60 min

4. Reset manuel

# Supprimer le cache pour reset le compteur
rm trends_request_cache.json

Conseils pour éviter tout blocage

✅ À FAIRE :

• Mode LITE quotidien
• Mode COMPLET 1 fois/semaine
• Attendre 24h entre scans
• Vérifier cache avant scan

❌ À NE PAS FAIRE :

• Scanner plusieurs fois par jour
• Utiliser mode COMPLET quotidiennement
• Ignorer les warnings 429

---

🧪 Tests

# Test complet du système
python test_system.py

# Test module geo_config
cd data
python geo_config.py

# Test configuration keywords
cd data
python keywords_lite.py
python keywords.py

---

📊 Résultats

Fichiers générés

trend_radar_lite_20251021_1430.csv   # Résultat scan LITE
trend_radar_full_20251021_1600.csv   # Résultat scan COMPLET

Format CSV

Colonne	Description
keyword	Mot-clé analysé
score	Note /10 (potentiel)
volume	Popularité Google (0-100)
velocity	Tendance croissance (%)
reddit_mentions	Nombre discussions
reddit_engagement	Engagement total
potential	HIGH / MEDIUM / LOW

---

🗑️ Nettoyage (Fichiers à supprimer)

Ces fichiers sont obsolètes et peuvent être supprimés :

# Anciens scripts (remplacés par trends_safe.py)
rm src/trends.py
rm src/config_switcher.py

# Outils annexes non essentiels
rm src/keywords_discovery.py
rm src/keywords-validator.py

# Doublons dans config/
rm src/config/keywords.py
rm src/config/keywords_lite.py
rm src/config/keywords.json

# Anciens résultats
rm src/trend_radar_20251017_2251.csv

---

📚 Documentation

📖 Toute la documentation est dans docs/

• Index complet : docs/README.md
• Résumé audit : docs/RESUME_AUDIT.md
• Documentation technique : docs/SYSTEM_AUDIT_ET_MAP.md
• Setup APIs : docs/SETUP_APIS.md
• Code source : Tous les fichiers Python sont documentés

---

🆘 Résolution de Problèmes

Erreur 429 (Google Trends bloqué)

# Attendre 30-60 minutes
# OU supprimer le cache
rm trends_request_cache.json
# Puis réessayer avec mode LITE

ImportError

# Vérifier que tu es dans le bon dossier
cd src
python trends_safe.py

Reddit API erreur

Vérifier src/config/config.py :

• Client ID non vide
• Client Secret non vide
• User Agent valide

Aucune donnée Google Trends

• Vérifier connexion internet
• Attendre 2-3 minutes
• Réessayer avec mode LITE
• Si persiste : utiliser Reddit uniquement

---

📈 Stratégie Recommandée

Semaine type

Jour	Action
Lundi-Vendredi	Scan LITE (1x/jour)
Samedi OU Dimanche	Scan COMPLET (1x/semaine)

Workflow optimal

1. Matin : Scan LITE (5 min)
2. Analyser résultats CSV
3. Valider niches score > 7
4. Créer produit digital
5. Samedi : Scan COMPLET approfondi

---

🔧 Développement Futur

Améliorations possibles :

• Scan multi-zones automatique (FR + DOM-TOM)
• Export vers Google Sheets
• Notifications email si niche > 8/10
• Mode "ultra-safe" (5 mots-clés max)
• Dashboard web pour visualisation

---

📝 Version

v2.0 - Système anti-blocage complet

• ✅ Protection Google Trends
• ✅ Configuration géographique centralisée
• ✅ Modes LITE et COMPLET
• ✅ Tests automatisés

---

👤 Auteur

Trend Radar Team

---

📄 Licence

Usage personnel uniquement