Botlist - Bot Knowledge Base #

Base de connaissances des bots connus.

Namespace: `Beamreactor\Plugins\Botlist`

Version: 2.2.0

Niveau requis: Public (lecture seule)

Vue d'ensemble #

Module d'affichage de la base de données des bots connus par le système. Permet de consulter les crawlers, scrapers et agents automatisés identifiés, classés par catégorie et niveau de risque.

Fonctionnalités #

• Liste des bots avec trigger de détection
• Classification par catégorie
• Indicateur de niveau de risque (0-9)
• Filtrage par catégorie
• Liens vers documentation externe

Catégories #

| Clé | Description |

|-----|-------------|

| `search_engine` | Moteurs de recherche (Googlebot, Bingbot, etc.) |

| `ai_crawler` | Crawlers IA (GPTBot, ClaudeBot, etc.) |

| `social_media` | Réseaux sociaux (FacebookBot, TwitterBot, etc.) |

| `monitoring` | Services de monitoring (UptimeRobot, Pingdom, etc.) |

| `archiver` | Archiveurs (Internet Archive, etc.) |

| `feed_reader` | Lecteurs RSS/Atom |

| `seo_tool` | Outils SEO (Ahrefs, SEMrush, etc.) |

| `malicious` | Bots malveillants identifiés |

| `unknown` | Non catégorisé |

Niveau de risque #

| Niveau | Signification |

|--------|---------------|

| 0 | Aucun risque, bot légitime |

| 1-2 | Faible, crawlers standards |

| 3-4 | Modéré, surveillance recommandée |

| 5-6 | Élevé, potentiellement agressif |

| 7-8 | Très élevé, comportement suspect |

| 9 | Critique, bot malveillant confirmé |

Structure des tables #

botdb #

CREATE TABLE botdb (
	id INT AUTO_INCREMENT PRIMARY KEY,
	trigger VARCHAR(100) NOT NULL,
	botname VARCHAR(100),
	category ENUM('search_engine', 'ai_crawler', 'social_media',
				  'monitoring', 'archiver', 'feed_reader',
				  'seo_tool', 'malicious', 'unknown'),
	url VARCHAR(255),
	risk TINYINT DEFAULT 0,
	INDEX (category),
	INDEX (trigger)
);

botsniffer #

Table complémentaire utilisée pour la détection en temps réel (voir module `botsniffer`).

Paramètres GET #

| Paramètre | Type | Description |

|-----------|------|-------------|

| `cat` | string | Filtre par catégorie |

Locale #

Clés utilisées dans `$dialbotl`:

| Clé | Description |

|-----|-------------|

| 0 | Texte "Nombre de bots connus : " |

| `cat_search` | Label catégorie moteurs de recherche |

| `cat_ai` | Label catégorie crawlers IA |

| `cat_social` | Label catégorie réseaux sociaux |

| `cat_monitoring` | Label catégorie monitoring |

| `cat_archiver` | Label catégorie archiveurs |

| `cat_feed` | Label catégorie lecteurs flux |

| `cat_seo` | Label catégorie outils SEO |

| `cat_malicious` | Label catégorie malveillants |

| `cat_unknown` | Label catégorie inconnus |

| `showall` | Lien "Afficher tout" |

| `th_trigger` | En-tête colonne trigger |

| `th_name` | En-tête colonne nom |

| `th_category` | En-tête colonne catégorie |

| `th_risk` | En-tête colonne risque |

| `link` | Texte du lien externe |

CSS #

Le module charge `plugins/botlist/css/botlist.css` contenant :

• `.botlist-table` — Style tableau principal
• `.botlist-row` — Ligne de bot
• `.botlist-cat-header` — Séparateur de catégorie
• `.botlist-trigger` — Cellule trigger (monospace)
• `.botlist-risk-bar` — Barre de niveau de risque
• `.botlist-risk-fill` — Remplissage barre de risque
• `.botlist-cat-badge` — Badge catégorie
• `.cat-{category}` — Couleur par catégorie

Exemples d'URL #

# Liste complète
?obj=botlist.php

# Filtrer par catégorie
?obj=botlist.php&cat=ai_crawler
?obj=botlist.php&cat=malicious

Intégration #

Ce module est en lecture seule. L'alimentation de la table `botdb` se fait :

• Manuellement via SQL
• Automatiquement par le module `botsniffer` lors de la détection de nouveaux bots
• Par import de listes externes

Notes #

• Le trigger correspond au pattern détecté dans le User-Agent
• Les liens externes passent par `redirect.php` avec `rel="noopener"`
• La barre de risque utilise un calcul `risk * 11.11%` pour l'affichage visuel
• Les bots sont triés par catégorie puis par nom