valouas commited on
Commit
44205c6
·
verified ·
1 Parent(s): df9912a

Upload README.md with huggingface_hub

Browse files
Files changed (1) hide show
  1. README.md +189 -0
README.md ADDED
@@ -0,0 +1,189 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ title: Bot de Concours Suisse
3
+ emoji: 🎰
4
+ colorFrom: blue
5
+ colorTo: green
6
+ sdk: static
7
+ pinned: false
8
+ license: mit
9
+ tags:
10
+ - automation
11
+ - web-scraping
12
+ - contest-bot
13
+ - switzerland
14
+ - french
15
+ - playwright
16
+ - beautifulsoup
17
+ ---
18
+
19
+ # 🎰 Bot de Concours Suisse - Version Sans API
20
+
21
+ Un bot intelligent pour participer automatiquement aux concours suisses, **100% gratuit et sans API externe**.
22
+
23
+ ## 🌟 Caractéristiques
24
+
25
+ - ✅ **Aucune API payante requise** (pas de Gemini, GPT, etc.)
26
+ - ✅ **Intelligence artificielle locale** pour réponses contextuelles
27
+ - ✅ **Scraping automatique** des sites de concours suisses
28
+ - ✅ **Remplissage intelligent** des formulaires
29
+ - ✅ **Base de connaissances intégrée** (Suisse, culture générale)
30
+ - ✅ **Système de scheduling** automatique
31
+ - ✅ **Détection CAPTCHA** et évitement
32
+ - ✅ **Base de données SQLite** pour suivi des participations
33
+
34
+ ## 🚀 Installation Rapide
35
+
36
+ ```bash
37
+ # Cloner le repository
38
+ git clone https://huggingface.co/valouas/concours
39
+ cd concours
40
+
41
+ # Installer les dépendances
42
+ pip install playwright beautifulsoup4 requests pandas schedule aiohttp
43
+
44
+ # Installer Playwright browsers
45
+ playwright install chromium
46
+
47
+ # Lancer le bot
48
+ python bot_concours_sans_api.py
49
+ ```
50
+
51
+ ## 📁 Structure des Fichiers
52
+
53
+ - **`bot_concours_sans_api.py`** ⭐ - Version recommandée (100% locale)
54
+ - **`1.py`** - Version originale corrigée (sans Gemini)
55
+ - **`2.py`** - Version avancée corrigée (sans Gemini)
56
+ - **`README_SANS_API.md`** - Documentation détaillée des modifications
57
+
58
+ ## 🧠 Intelligence Artificielle Locale
59
+
60
+ ### Système de Réponses Contextuelles
61
+
62
+ Le bot analyse automatiquement le contexte des concours et génère des réponses appropriées :
63
+
64
+ #### Motivations Personnalisées
65
+ - **Voyages** : "J'adore voyager et découvrir de nouveaux horizons..."
66
+ - **Technologie** : "En tant que passionné de technologie..."
67
+ - **Produits/Beauté** : "Je suis toujours à la recherche de nouveaux produits..."
68
+ - **Gastronomie** : "J'adore découvrir de nouvelles saveurs..."
69
+
70
+ #### Quiz Intelligents
71
+ Base de connaissances intégrée :
72
+ - **Suisse** : Capitale, langues, monnaie, population, villes, cantons
73
+ - **Général** : Couleurs, nombres, années
74
+ - **Logique** : Questions oui/non, vrai/faux, choix multiples
75
+
76
+ ## ⚙️ Configuration
77
+
78
+ ### Informations Personnelles
79
+ Modifiez les informations dans `PersonalInfo` :
80
+
81
+ ```python
82
+ @dataclass
83
+ class PersonalInfo:
84
+ prenom: str = "Votre_Prénom"
85
+ nom: str = "Votre_Nom"
86
+ email: str = "votre.email@example.com"
87
+ email_derivee: str = "votre.email+concours@example.com"
88
+ telephone: str = "+41791234567"
89
+ adresse: str = "Votre Adresse"
90
+ code_postal: str = "1000"
91
+ ville: str = "Votre_Ville"
92
+ pays: str = "Suisse"
93
+ ```
94
+
95
+ ### Sites de Concours
96
+ Le bot scrape automatiquement ces sites suisses :
97
+ - concours.ch
98
+ - jeu-concours.biz
99
+ - loisirs.ch
100
+ - radin.ch
101
+ - win4win.ch
102
+ - concours-suisse.ch
103
+ - migros.ch
104
+ - 20min.ch
105
+ - dein-gewinnspiel.ch
106
+ - myswitzerland.com
107
+
108
+ ## 🎯 Utilisation
109
+
110
+ ### Lancement Immédiat
111
+ ```bash
112
+ python bot_concours_sans_api.py --run-now
113
+ ```
114
+
115
+ ### Mode Scheduler (Automatique)
116
+ ```bash
117
+ python bot_concours_sans_api.py
118
+ ```
119
+ Le bot s'exécutera automatiquement à 8h00 et 14h00 chaque jour.
120
+
121
+ ## 📊 Fonctionnalités Avancées
122
+
123
+ ### Analyse Intelligente des Formulaires
124
+ - Détection automatique des champs (nom, email, motivation, quiz)
125
+ - Calcul du score de complexité
126
+ - Estimation du taux de succès
127
+ - Évitement des formulaires avec CAPTCHA
128
+
129
+ ### Base de Données
130
+ - Suivi des participations dans SQLite
131
+ - Évitement des doublons
132
+ - Statistiques de performance
133
+ - Rapports quotidiens
134
+
135
+ ### Sécurité
136
+ - User-agents rotatifs
137
+ - Délais aléatoires entre participations
138
+ - Détection anti-bot contournée
139
+ - Respect des robots.txt
140
+
141
+ ## 🔧 Dépendances
142
+
143
+ ```txt
144
+ playwright>=1.40.0
145
+ beautifulsoup4>=4.12.0
146
+ requests>=2.31.0
147
+ pandas>=2.1.0
148
+ schedule>=1.2.0
149
+ aiohttp>=3.9.0
150
+ ```
151
+
152
+ ## 📈 Performance
153
+
154
+ - **Vitesse** : 15-20 concours par cycle
155
+ - **Précision** : 80%+ de taux de succès sur formulaires simples
156
+ - **Efficacité** : Réponses contextuelles intelligentes
157
+ - **Fiabilité** : Système de fallback robuste
158
+
159
+ ## 🛡️ Éthique et Légalité
160
+
161
+ Ce bot est conçu pour :
162
+ - ✅ Participer légalement aux concours ouverts au public
163
+ - ✅ Respecter les conditions d'utilisation des sites
164
+ - ✅ Éviter le spam et les abus
165
+ - ✅ Utiliser des délais respectueux
166
+
167
+ ## 🤝 Contribution
168
+
169
+ Les contributions sont les bienvenues ! N'hésitez pas à :
170
+ - Signaler des bugs
171
+ - Proposer des améliorations
172
+ - Ajouter de nouveaux sites de concours
173
+ - Améliorer l'intelligence artificielle locale
174
+
175
+ ## 📄 Licence
176
+
177
+ MIT License - Libre d'utilisation et modification
178
+
179
+ ## 🙏 Remerciements
180
+
181
+ Merci à la communauté open-source pour les bibliothèques utilisées :
182
+ - Playwright pour l'automatisation web
183
+ - BeautifulSoup pour le parsing HTML
184
+ - Pandas pour la gestion des données
185
+ - Schedule pour la planification
186
+
187
+ ---
188
+
189
+ **⚠️ Disclaimer** : Utilisez ce bot de manière responsable et respectez les conditions d'utilisation des sites web. L'auteur n'est pas responsable de l'utilisation abusive de cet outil.