Différences

Ci-dessous, les différences entre deux révisions de la page.

--- geo-bot-monitor [26/01/2026 21:12] – erwan
+++ geo-bot-monitor [23/02/2026 12:08] (Version actuelle) – [GEO Bot Monitor] erwan
@@ Ligne 1: / Ligne 1: @@
 ====== GEO Bot Monitor ======
-Plugin WordPress pour surveiller les visites des robots SEO et GEO/AI sur votre site.
+> Plugin WordPress de surveillance et gestion des robots visitant votre site, avec outils de blocage et intégration GEO.
   * [[https://dl.ticoet.me/downloads/1-SEO-GEO/2-entity-authority-signals-v1/geo-bot-monitor.zip|Télécharger le plugin WordPress]]
-  * [[https://dl.ticoet.me/downloads/1-SEO-GEO/2-entity-authority-signals-v1/dmg.zip|Application GEO Bot Dashboard pour Mac]]
+  * [[https://dl.ticoet.me/downloads/1-SEO-GEO/2-entity-authority-signals-v1/dmg.zip|Application GEO Bot Dashboard pour Mac]] ou directment le [[https://dl.ticoet.me/downloads/1-SEO-GEO/2-entity-authority-signals-v1/GEO%20Bot%20Dashboard_1.0.0.dmg|dmg]]
+  * **Version** : 1.1.0
+  * **Licence** : GPL2+
+  * **Compatibilité** : WordPress 5.8+, PHP 7.4+
 ===== Description =====
-GEO Bot Monitor détecte et enregistre automatiquement les visites des robots sur votre site WordPress. Il catégorise les robots en quatre groupes : SEO, GEO/IA, Réseaux sociaux et Autres.
+**GEO Bot Monitor** surveille, catégorise et permet de bloquer les robots qui visitent votre site WordPress : moteurs de recherche (SEO), IA génératives (GEO), réseaux sociaux, outils SEO et podcasts.
+===== Fonctionnalités principales =====
+==== Surveillance des bots ====
+  * **Détection automatique** de 80+ robots avec signatures actualisées
+  * **Catégorisation** : SEO, GEO/IA, Réseaux sociaux, Outils SEO, Podcast, Interne, Autres
+  * **Tableau de bord** avec statistiques en temps réel
+  * **Graphiques d'évolution** par période
+  * **Historique** des visites par bot et par page
+==== Catégories de bots détectés ====
+^ Catégorie ^ Exemples ^
+| **SEO** | Googlebot, Bingbot, Applebot, YandexBot, DuckDuckBot |
+| **GEO / IA** | GPTBot, Claude-Web, PerplexityBot, Google-Extended, CCBot |
+| **Outils SEO** | MozBot, AhrefsBot, SemrushBot, MJ12bot, Screaming Frog |
+| **Réseaux sociaux** | Twitterbot, LinkedInBot, WhatsApp, Discordbot |
+| **Podcast** | Podchaser, Spotify, Apple-Podcasts, Overcast |
+| **Interne** | WordPress-Cron, GEO-Audit-Bot, Jetpack |
+==== Blocage des bots ====
+  * **Interface de gestion** pour bloquer/autoriser chaque bot
+  * **Génération automatique** des règles de blocage :
+    * ''robots.txt'' : Directives Disallow
+    * ''.htaccess'' : Règles RewriteCond (blocage serveur)
+    * ''llms.txt'' : Format spécifique IA
+  * **Application directe** au fichier robots.txt du site
+  * **Détection** des bots déjà bloqués dans robots.txt existant
+==== Intégration GEO Authority Suite ====
+Si le plugin **GEO Authority Suite** est installé :
+  * Synchronisation automatique avec le fichier ''llms.txt''
+  * Ajout des directives de blocage IA dans la section dédiée
+  * Cohérence entre robots.txt et llms.txt
+==== Export des données ====
-==== Fonctionnalités ====
+  * **CSV** : Export complet ou par période
+  * **PDF** : Rapport formaté
+  * **Markdown** : Format texte structuré
+  * **API REST** : Accès programmatique aux données
-* **Détection automatique** de 50+ robots (Googlebot, Bingbot, GPTBot, Claude-Web, PerplexityBot...)
+---
-* **Catégorisation** : SEO, GEO/IA, Réseaux sociaux, Autres
-* **Tableau de bord** avec statistiques en temps réel et graphiques
-* **Comparaison de périodes** pour mesurer l'impact d'une action
-* **Exports** : CSV (Excel), PDF, Markdown
-* **API REST** pour connexion avec applications externes
-* **Maintenance** : purge des données anciennes
 ===== Installation =====
-. Télécharger le dossier `geo-bot-monitor`
+  - Téléchargez le plugin
-. Le copier dans `wp-content/plugins/`
+  - Uploadez dans ''/wp-content/plugins/geo-bot-monitor/''
-. Activer le plugin dans l'admin WordPress
+  - Activez depuis **Extensions > Extensions installées**
-. Accéder au menu **Bot Monitor**
+  - Accédez au menu **Bot Monitor** dans l'administration
-===== Configuration =====
+---
-==== Configuration API ====
+===== Pages d'administration =====
-Pour connecter une application externe (comme GEO Bot Dashboard) :
+^ Page ^ Description ^
+| **Tableau de bord** | Vue d'ensemble et statistiques |
+| **Liste des bots** | Historique détaillé par robot |
+| **Blocage** | Gestion des autorisations et génération de règles |
+| **Export** | Export des données (CSV, PDF, Markdown) |
+| **Réglages** | Configuration du plugin |
-. Aller dans **Bot Monitor > API**
+---
-. Cliquer sur **Générer une nouvelle clé**
-. Enregistrer
-. Utiliser cette clé dans votre application
-===== Utilisation =====
+===== Blocage des bots =====
-==== Tableau de bord ====
+==== Interface de blocage ====
-Le tableau de bord affiche :
+La page **Bot Monitor > Blocage** permet de :
-* Nombre total de visites sur la période sélectionnée
+  * Voir la liste de tous les bots détectés
-* Répartition par catégorie de robots
+  * Identifier leur statut actuel (Autorisé / Bloqué)
-* Graphique d'évolution journalière
+  * Bloquer ou autoriser individuellement chaque bot
-* Top 20 des robots les plus actifs
+  * Générer les codes de blocage
-* Top 10 des pages les plus visitées par les robots
-==== Comparaison de périodes ====
+==== Méthodes de blocage ====
-Cette fonctionnalité permet de comparer deux périodes pour mesurer l'impact d'une action SEO ou GEO :
+=== robots.txt ===
-. Sélectionner la période 1 (référence)
+Le fichier ''robots.txt'' indique aux robots respectueux les pages à ne pas crawler.
-. Sélectionner la période 2 (à comparer)
-. Cliquer sur **Comparer**
-Le résultat affiche la variation en nombre absolu et en pourcentage, détaillée par catégorie et par robot.
+<code>
+# Règles de blocage générées par GEO Bot Monitor
+# Date: 2026-02-23 10:00:00
-==== Exports ====
+# Bloquer MJ12bot
+User-agent: MJ12bot
+Disallow: /
-Trois formats d'export sont disponibles :
+# Bloquer AhrefsBot
+User-agent: AhrefsBot
+Disallow: /
+</code>
-* **CSV** : Compatible Excel, séparateur point-virgule, encodage UTF-8 BOM
+**Avantages** : Simple, standard, respecté par les bots légitimes.
-* **PDF** : Rapport HTML stylisé avec résumé et tableaux
+**Limites** : Les bots malveillants peuvent ignorer ces directives.
-* **Markdown** : Format texte pour documentation
-==== Maintenance ====
+=== .htaccess (Apache) ===
-La page de maintenance permet de :
+Blocage au niveau serveur, plus strict.
-* Voir la taille de la base de données
+<code apache>
-* Sélectionner et supprimer des mois de données pour libérer de l'espace
+# Règles de blocage générées par GEO Bot Monitor
+<IfModule mod_rewrite.c>
+RewriteEngine On
-===== API REST =====
+# Bloquer MJ12bot
+RewriteCond %{HTTP_USER_AGENT} MJ12bot [NC]
+RewriteRule .* - [F,L]
+</IfModule>
+</code>
-==== Endpoints ====
+**Avantages** : Blocage effectif, le bot reçoit une erreur 403.
+**Limites** : Nécessite Apache avec mod_rewrite.
-{| class="wikitable"
+=== llms.txt ===
-! Endpoint !! Méthode !! Description
-|-
-| <code>/wp-json/geo-bot-monitor/v1/ping</code> || GET || Test de connexion (sans authentification)
-|-
-| <code>/wp-json/geo-bot-monitor/v1/auth</code> || POST || Vérifier la validité de la clé API
-|-
-| <code>/wp-json/geo-bot-monitor/v1/stats</code> || GET || Statistiques globales (total, par catégorie, par jour)
-|-
-| <code>/wp-json/geo-bot-monitor/v1/visits</code> || GET || Liste paginée des visites
-|-
-| <code>/wp-json/geo-bot-monitor/v1/compare</code> || GET || Comparer deux périodes
-|-
-| <code>/wp-json/geo-bot-monitor/v1/bots</code> || GET || Liste des robots détectables
-|-
-| <code>/wp-json/geo-bot-monitor/v1/categories</code> || GET || Liste des catégories
-|-
-| <code>/wp-json/geo-bot-monitor/v1/database</code> || GET || Informations sur la base de données
-|-
-| <code>/wp-json/geo-bot-monitor/v1/months</code> || GET || Mois disponibles avec le nombre de visites
-|-
-| <code>/wp-json/geo-bot-monitor/v1/export</code> || GET || Exporter les données (JSON ou CSV)
-|}
-==== Authentification ====
+Format spécifique pour les crawlers IA (standard llmstxt.org).
-=== Option 1 : Header HTTP (recommandé) ===
+<code>
+# Bots IA bloqués
+User-agent: GPTBot
+User-agent: CCBot
-<pre>
+# Règles
-X-GEO-Bot-API-Key: votre_cle_api
+Disallow: /
-</pre>
+</code>
-=== Option 2 : Paramètre URL ===
+==== Détection automatique ====
-<pre>
+Le plugin détecte les bots déjà bloqués dans votre ''robots.txt'' existant :
-?api_key=votre_cle_api
-</pre>
-==== Exemples de requêtes ====
+  * Lecture du fichier robots.txt actuel
+  * Analyse des directives User-agent / Disallow
+  * Affichage du statut "Bloqué" ou "Autorisé" pour chaque bot
-=== Statistiques des 30 derniers jours ===
+---
-<pre>
+===== Intégration GEO Authority Suite =====
-curl -H "X-GEO-Bot-API-Key: gbm_xxx" \
-  "https://example.com/wp-json/geo-bot-monitor/v1/stats"
-</pre>
-=== Statistiques personnalisées ===
+Si **GEO Authority Suite** est installé sur le même site :
-<pre>
+==== Synchronisation llms.txt ====
-curl -H "X-GEO-Bot-API-Key: gbm_xxx" \
-  "https://example.com/wp-json/geo-bot-monitor/v1/stats?start_date=2025-01-01&end_date=2025-01-31"
-</pre>
-=== Comparer deux périodes ===
+Quand vous bloquez un bot IA via GEO Bot Monitor :
-<pre>
+  - Le plugin détecte GEO Authority Suite
-curl -H "X-GEO-Bot-API-Key: gbm_xxx" \
+  - Propose d'ajouter le blocage dans le ''llms.txt'' généré
-  "https://example.com/wp-json/geo-bot-monitor/v1/compare?period1_start=2025-01-01&period1_end=2025-01-15&period2_start=2025-01-16&period2_end=2025-01-31"
+  - Les directives sont ajoutées dans la section "Crawlers IA bloqués"
-</pre>
-==== Paramètres des endpoints ====
+==== Exemple de sortie llms.txt ====
-=== /stats ===
+<code>
+## Crawlers IA bloques
-{| class="wikitable"
+Les crawlers IA suivants ne sont pas autorises a indexer ce site :
-! Paramètre !! Type !! Défaut !! Description
-|-
-| start_date || string || -30 jours || Date de début (YYYY-MM-DD)
-|-
-| end_date || string || aujourd'hui || Date de fin (YYYY-MM-DD)
-|}
-=== /visits ===
+- **GPTBot** (User-Agent: `GPTBot`)
+- **CCBot** (User-Agent: `CCBot`)
-{| class="wikitable"
+### Directives de blocage
-! Paramètre !! Type !! Défaut !! Description
-|-
-| start_date || string || -30 jours || Date de début (YYYY-MM-DD)
-|-
-| end_date || string || aujourd'hui || Date de fin (YYYY-MM-DD)
-|-
-| bot_name || string || (vide) || Filtrer par nom de robot
-|-
-| bot_category || string || (vide) || Filtrer par catégorie (seo, geo_ai, social, other)
-|-
-| page || integer || 1 || Numéro de page
-|-
-| per_page || integer || 100 || Résultats par page (max: 1000)
-|}
-=== /compare ===
+User-agent: GPTBot
+Disallow: /
-{| class="wikitable"
+User-agent: CCBot
-! Paramètre !! Type !! Requis !! Description
+Disallow: /
-|-
-| period1_start || string || Oui || Début période 1 (YYYY-MM-DD)
-|-
-| period1_end || string || Oui || Fin période 1 (YYYY-MM-DD)
-|-
-| period2_start || string || Oui || Début période 2 (YYYY-MM-DD)
-|-
-| period2_end || string || Oui || Fin période 2 (YYYY-MM-DD)
-|}
-===== Robots détectés =====
+Ces directives sont egalement presentes dans le fichier robots.txt.
+Gere par : GEO Bot Monitor v1.1.0
+</code>
-==== SEO ====
+---
-* Googlebot, Googlebot-Image, Googlebot-News, Googlebot-Video
+===== API REST =====
-* Googlebot-Mobile, Google-InspectionTool
-* Bingbot, BingPreview
-* YandexBot, YandexImages, YandexMobileBot
-* Baiduspider, Baiduspider-image
-* DuckDuckBot, DuckDuckGo-Favicons-Bot
-* Applebot
-* Sogou web spider
-* Exabot
-* facebot, facebookexternalhit
-* ia_archiver
-* MJ12bot
-* AhrefsBot
-* SemrushBot
-* DotBot
-* Screaming Frog
-* SEOkicks
-* Seobility
-* SISTRIX
-* rogerbot, Moz
-==== GEO / IA ====
+==== Endpoints disponibles ====
-* GPTBot (OpenAI)
+<code>
-* ChatGPT-User
+GET /wp-json/geo-bot-monitor/v1/stats
-* Claude-Web, ClaudeBot (Anthropic)
+GET /wp-json/geo-bot-monitor/v1/bots
-* anthropic-ai
+GET /wp-json/geo-bot-monitor/v1/visits
-* PerplexityBot
+</code>
-* Google-Extended
-* Cohere-ai
+==== Exemple de réponse ====
-* CCBot (Common Crawl)
-* Bytespider (ByteDance/TikTok)
+<code javascript>
-* PetalBot
+{
-* YouBot
+  "total_visits": 12474,
-* Diffbot
+  "categories": {
-* OAI-SearchBot
+    "seo": 6500,
-* Meta-ExternalAgent
+    "geo_ai": 1,
-* Meta-ExternalFetcher
+    "social": 2,
-* Amazonbot
+    "other": 5971
-* ImagesiftBot
+  },
-* omgili, omgilibot
+  "top_bots": [
-* webzio
+    {"name": "Moz", "visits": 6179},
+    {"name": "Unknown Bot", "visits": 5960}
+  ]
+}
+</code>
+---
+===== Signatures de bots =====
+Le plugin inclut des signatures pour 80+ robots :
+==== Moteurs de recherche (SEO) ====
+  * Googlebot, Googlebot-Image, Googlebot-Video, Googlebot-News
+  * Bingbot, BingPreview
+  * YandexBot, YandexImages
+  * Baiduspider
+  * DuckDuckBot
+  * Applebot
+==== Bots IA (GEO) ====
+  * GPTBot, ChatGPT-User (OpenAI)
+  * Claude-Web, ClaudeBot (Anthropic)
+  * PerplexityBot
+  * Google-Extended
+  * CCBot (Common Crawl)
+  * Bytespider (ByteDance)
+  * Meta-ExternalAgent
+  * Amazonbot
+==== Outils SEO ====
+  * MozBot, rogerbot
+  * AhrefsBot
+  * SemrushBot
+  * MJ12bot (Majestic)
+  * DotBot
+  * Screaming Frog
+  * SEOkicks, Seobility, Sistrix
 ==== Réseaux sociaux ====
-* Twitterbot
+  * Twitterbot
-* LinkedInBot
+  * LinkedInBot
-* Pinterest, Pinterestbot
+  * facebot, FacebookBot
-* Slackbot
+  * WhatsApp
-* TelegramBot
+  * Discordbot
-* WhatsApp
+  * TelegramBot
-* Discordbot
+  * Slackbot
-* Snapchat
+  * Pinterest
-==== Autres ====
+==== Podcast ====
-* UptimeRobot
+  * Podchaser
-* Pingdom
+  * Spotify
-* StatusCake
+  * Apple-Podcasts (AppleCoreMedia, iTunes)
-* Netcraft
+  * Google-Podcasts
-* W3C_Validator
+  * Overcast
-* Validator.nu
+  * Pocket Casts
-* GTmetrix
+  * Castro
-* WebPageTest
+  * Deezer
-* Chrome-Lighthouse
-* archive.org_bot
-* Feedfetcher
-===== Structure des fichiers =====
+==== Internes ====
-<pre>
+  * WordPress-Cron
-geo-bot-monitor/
+  * GEO-Audit-Bot
-├── geo-bot-monitor.php         # Fichier principal
+  * Jetpack
-├── includes/
-│   ├── bot-signatures.php      # Signatures des robots
-│   ├── class-bot-api.php       # API REST
-│   ├── class-bot-dashboard.php # Pages admin
-│   ├── class-bot-detector.php  # Détection des robots
-│   ├── class-bot-exporter.php  # Exports CSV/PDF/MD
-│   ├── class-bot-logger.php    # Logging en BDD
-│   └── class-bot-settings.php  # Page paramètres API
-├── assets/
-│   ├── css/admin.css           # Styles admin
-│   └── js/admin.js             # Scripts admin
-└── readme.md
-</pre>
-===== Base de données =====
+---
-==== Table {prefix}_geo_bot_visits ====
+===== Cas d'utilisation =====
-{| class="wikitable"
+==== Surveiller l'activité IA ====
-! Colonne !! Type !! Description
-|-
-| id || BIGINT || ID unique auto-incrémenté
-|-
-| visit_date || DATETIME || Date et heure de la visite
-|-
-| bot_name || VARCHAR(100) || Nom du robot détecté
-|-
-| bot_category || VARCHAR(20) || Catégorie (seo, geo_ai, social, other)
-|-
-| user_agent || TEXT || User-Agent complet
-|-
-| ip_address || VARCHAR(45) || Adresse IP du robot
-|-
-| url_visited || TEXT || URL visitée
-|-
-| http_status || SMALLINT || Code de statut HTTP
-|-
-| response_time || FLOAT || Temps de réponse en secondes
-|}
-==== Index ====
+Identifiez quels crawlers IA visitent votre site et à quelle fréquence.
-* <code>idx_date</code> : sur visit_date
+==== Bloquer les bots indésirables ====
-* <code>idx_bot</code> : sur bot_name
-* <code>idx_category</code> : sur bot_category
-* <code>idx_date_category</code> : composite sur visit_date et bot_category
-===== Désinstallation =====
+Bloquez les bots SEO tiers (Moz, Ahrefs, MJ12bot) qui consomment de la bande passante sans apporter de valeur directe.
-La désinstallation du plugin supprime automatiquement :
+==== Optimiser pour le GEO ====
-* La table <code>{prefix}_geo_bot_visits</code>
+Vérifiez que les bots IA (GPTBot, Claude-Web) accèdent correctement à vos contenus optimisés.
-* L'option <code>geo_bot_monitor_db_version</code>
-* L'option <code>geo_bot_monitor_api_key</code>
+==== Mesurer l'impact ====
+Comparez l'activité des bots avant/après modifications pour valider l'effet de vos optimisations GEO.
+---
 ===== Changelog =====
-==== 1.0.1 ====
+==== Version 1.1.0 (Février 2026) ====
+  * **Nouveau** : Système de blocage des bots
+  * **Nouveau** : Génération de règles robots.txt, .htaccess, llms.txt
+  * **Nouveau** : Application directe au robots.txt du site
+  * **Nouveau** : Détection des bots déjà bloqués
+  * **Nouveau** : Intégration avec GEO Authority Suite (llms.txt)
+  * **Nouveau** : Catégorie Podcast (Podchaser, Spotify, Apple Podcasts...)
+  * **Nouveau** : Signatures MozBot et MJ12bot améliorées
+  * **Amélioration** : Détection Unknown Bot (distinction WP-Cron, internes)
+  * **Amélioration** : Interface de blocage avec statut en temps réel
-* Corrections de sécurité (sanitization, escaping)
+==== Version 1.0.0 (Janvier 2026) ====
-* Génération de clé API côté serveur
-* Ajout index composite pour performance
-* Nettoyage automatique à la désinstallation
-==== 1.0.0 ====
+  * Version initiale
+  * Détection et catégorisation des bots
+  * Tableau de bord et statistiques
+  * Export CSV, PDF, Markdown
+  * API REST
-* Version initiale
+---
-===== Informations techniques =====
+===== Ressources =====
-* **Requires at least:** WordPress 6.0
+  * [[https://schema.org/|Documentation Schema.org]]
-* **Tested up to:** WordPress 6.7
+  * [[https://developers.google.com/search/docs/crawling-indexing/robots/intro|Spécification robots.txt]]
-* **Requires PHP:** 7.4
+  * [[https://llmstxt.org/|llms.txt Standard]]
-* **License:** GPLv2 or later
-===== Auteur =====
+---
-Erwan Tanguy
+===== Support =====
-[[Category:Plugins WordPress]]
+**Auteur** : Erwan Tanguy - Ticoët\\
-[[Category:SEO]]
+**Site** : [[https://www.ticoet.fr/|ticoet.fr]]\\
-[[Category:GEO]]
+**Wiki** : [[https://wiki.ticoet.me/doku.php?id=geo-bot-monitor|wiki.ticoet.me]]
-[[Category:Monitoring]]

Detach Close

Tous les plugins