Outils pour utilisateurs

Outils du site


geo-bot-monitor

Différences

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

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
geo-bot-monitor [26/01/2026 21:02] erwangeo-bot-monitor [23/02/2026 12:08] (Version actuelle) – [GEO Bot Monitor] erwan
Ligne 1: Ligne 1:
 ====== GEO Bot Monitor ====== ====== 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/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 ===== ===== 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 ==== 
 + 
 +  * **CSV** : Export complet ou par période 
 +  * **PDF** : Rapport formaté 
 +  * **Markdown** : Format texte structuré 
 +  * **API REST** : Accès programmatique aux données 
 + 
 +--- 
 + 
 +===== Installation ===== 
 + 
 +  - Téléchargez le plugin 
 +  - Uploadez dans ''/wp-content/plugins/geo-bot-monitor/'' 
 +  - Activez depuis **Extensions > Extensions installées** 
 +  - Accédez au menu **Bot Monitor** dans l'administration 
 + 
 +--- 
 + 
 +===== Pages d'administration ===== 
 + 
 +^ 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 | 
 + 
 +--- 
 + 
 +===== Blocage des bots ===== 
 + 
 +==== Interface de blocage ==== 
 + 
 +La page **Bot Monitor > Blocage** permet de : 
 + 
 +  * Voir la liste de tous les bots détectés 
 +  * Identifier leur statut actuel (Autorisé / Bloqué) 
 +  * Bloquer ou autoriser individuellement chaque bot 
 +  * Générer les codes de blocage 
 + 
 +==== Méthodes de blocage ==== 
 + 
 +=== robots.txt === 
 + 
 +Le fichier ''robots.txt'' indique aux robots respectueux les pages à ne pas crawler.
  
-===== Fonctionnalités =====+<code> 
 +# Règles de blocage générées par GEO Bot Monitor 
 +# Date: 2026-02-23 10:00:00
  
-* **Détection automatique** de 50+ robots (Googlebot, Bingbot, GPTBot, Claude-Web, PerplexityBot...) +# Bloquer MJ12bot 
-* **Catégorisation** SEO, GEO/IA, Réseaux sociaux, Autres +User-agent: MJ12bot 
-* **Tableau de bord** avec statistiques en temps réel et graphiques +Disallow: /
-* **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 ====+# Bloquer AhrefsBot 
 +User-agent: AhrefsBot 
 +Disallow: / 
 +</code>
  
-1Télécharger le dossier `geo-bot-monitor` +**Avantages** : Simple, standard, respecté par les bots légitimes
-2. Le copier dans `wp-content/plugins/+**Limites** : Les bots malveillants peuvent ignorer ces directives.
-3. Activer le plugin dans l'admin WordPress +
-4. Accéder au menu **Bot Monitor**+
  
-==== Configuration ====+=== .htaccess (Apache) ===
  
-===== Configuration API =====+Blocage au niveau serveur, plus strict.
  
-Pour connecter une application externe (comme GEO Bot Dashboard) :+<code apache> 
 +# Règles de blocage générées par GEO Bot Monitor 
 +<IfModule mod_rewrite.c> 
 +RewriteEngine On
  
-1. Aller dans **Bot Monitor > API** +# Bloquer MJ12bot 
-2Cliquer sur **Générer une nouvelle clé*+RewriteCond %{HTTP_USER_AGENT} MJ12bot [NC] 
-3. Enregistrer +RewriteRule .* - [F,L] 
-4. Utiliser cette clé dans votre application+</IfModule> 
 +</code>
  
-==== Utilisation ====+**Avantages** : Blocage effectif, le bot reçoit une erreur 403. 
 +**Limites** : Nécessite Apache avec mod_rewrite.
  
-===== Tableau de bord =====+=== llms.txt ===
  
-Le tableau de bord affiche :+Format spécifique pour les crawlers IA (standard llmstxt.org).
  
-* Nombre total de visites sur la période sélectionnée +<code> 
-* Répartition par catégorie de robots +# Bots IA bloqués 
-* Graphique d'évolution journalière +User-agent: GPTBot 
-* Top 20 des robots les plus actifs +User-agent: CCBot
-* Top 10 des pages les plus visitées par les robots+
  
-===== Comparaison de périodes =====+# Règles 
 +Disallow: / 
 +</code>
  
-Cette fonctionnalité permet de comparer deux périodes pour mesurer l'impact d'une action SEO ou GEO :+==== Détection automatique ====
  
-1Sélectionner la période 1 (référence) +Le plugin détecte les bots déjà bloqués dans votre ''robots.txt'' existant :
-2. Sélectionner la période 2 (à comparer) +
-3. Cliquer sur **Comparer**+
  
-Le résultat affiche la variation en nombre absolu et en pourcentage, détaillée par catégorie et par robot.+  * Lecture du fichier robots.txt actuel 
 +  * Analyse des directives User-agent / Disallow 
 +  * Affichage du statut "Bloqué" ou "Autorisé" pour chaque bot
  
-===== Exports =====+---
  
-Trois formats d'export sont disponibles :+===== Intégration GEO Authority Suite =====
  
-* **CSV** : Compatible Excel, séparateur point-virgule, encodage UTF-8 BOM +Si **GEO Authority Suite** est installé sur le même site :
-* **PDF** : Rapport HTML stylisé avec résumé et tableaux +
-* **Markdown** : Format texte pour documentation+
  
-===== Maintenance =====+==== Synchronisation llms.txt ====
  
-La page de maintenance permet de :+Quand vous bloquez un bot IA via GEO Bot Monitor :
  
-* Voir la taille de la base de données +  - Le plugin détecte GEO Authority Suite 
-* Sélectionner et supprimer des mois de données pour libérer de l'espace+  - Propose d'ajouter le blocage dans le ''llms.txt'' généré 
 +  - Les directives sont ajoutées dans la section "Crawlers IA bloqués"
  
-==== API REST ====+==== Exemple de sortie llms.txt ====
  
-===== Endpoints =====+<code> 
 +## Crawlers IA bloques
  
-{| class="wikitable" +Les crawlers IA suivants ne sont pas autorises a indexer ce site :
-! 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 =====+- **GPTBot** (User-Agent: `GPTBot`) 
 +- **CCBot** (User-Agent: `CCBot`)
  
-====== Option 1 : Header HTTP (recommandé) ======+### Directives de blocage
  
-<pre> +User-agentGPTBot 
-X-GEO-Bot-API-Keyvotre_cle_api +Disallow: /
-</pre>+
  
-====== Option 2 Paramètre URL ======+User-agentCCBot 
 +Disallow: /
  
-<pre> +Ces directives sont egalement presentes dans le fichier robots.txt. 
-?api_key=votre_cle_api +Gere par : GEO Bot Monitor v1.1.0 
-</pre>+</code>
  
-===== Exemples de requêtes =====+---
  
-====== Statistiques des 30 derniers jours ======+===== API REST =====
  
-<pre> +==== Endpoints disponibles ====
-curl -H "X-GEO-Bot-API-Key: gbm_xxx"+
-  "https://example.com/wp-json/geo-bot-monitor/v1/stats" +
-</pre>+
  
-====== Statistiques personnalisées ======+<code> 
 +GET /wp-json/geo-bot-monitor/v1/stats 
 +GET /wp-json/geo-bot-monitor/v1/bots 
 +GET /wp-json/geo-bot-monitor/v1/visits 
 +</code>
  
-<pre> +==== Exemple de réponse ====
-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 ======+<code javascript> 
 +
 +  "total_visits": 12474, 
 +  "categories":
 +    "seo": 6500, 
 +    "geo_ai": 1, 
 +    "social": 2, 
 +    "other": 5971 
 +  }, 
 +  "top_bots":
 +    {"name": "Moz", "visits": 6179}, 
 +    {"name": "Unknown Bot", "visits": 5960} 
 +  ] 
 +
 +</code>
  
-<pre> +---
-curl -H "X-GEO-Bot-API-Key: gbm_xxx"+
-  "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" +
-</pre>+
  
-===== Paramètres des endpoints =====+===== Signatures de bots =====
  
-====== /stats ======+Le plugin inclut des signatures pour 80+ robots :
  
-{| class="wikitable" +==== Moteurs de recherche (SEO====
-! 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 ======+  * Googlebot, Googlebot-Image, Googlebot-Video, Googlebot-News 
 +  * Bingbot, BingPreview 
 +  * YandexBot, YandexImages 
 +  * Baiduspider 
 +  * DuckDuckBot 
 +  * Applebot
  
-{| class="wikitable" +==== Bots IA (GEO====
-! 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 ======+  * GPTBot, ChatGPT-User (OpenAI) 
 +  * Claude-Web, ClaudeBot (Anthropic) 
 +  * PerplexityBot 
 +  * Google-Extended 
 +  * CCBot (Common Crawl) 
 +  * Bytespider (ByteDance) 
 +  * Meta-ExternalAgent 
 +  * Amazonbot
  
-{| class="wikitable" +==== Outils SEO ====
-! Paramètre !! Type !! Requis !! Description +
-|- +
-| 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 ====+  * MozBot, rogerbot 
 +  * AhrefsBot 
 +  * SemrushBot 
 +  * MJ12bot (Majestic) 
 +  * DotBot 
 +  * Screaming Frog 
 +  * SEOkicks, Seobility, Sistrix
  
-===== SEO =====+==== Réseaux sociaux ====
  
-Googlebot, Googlebot-Image, Googlebot-News, Googlebot-Video +  Twitterbot 
-Googlebot-Mobile, Google-InspectionTool +  LinkedInBot 
-* Bingbot, BingPreview +  * facebot, FacebookBot 
-* YandexBot, YandexImages, YandexMobileBot +  WhatsApp 
-* Baiduspider, Baiduspider-image +  Discordbot 
-* DuckDuckBot, DuckDuckGo-Favicons-Bot +  TelegramBot 
-* Applebot +  Slackbot 
-* Sogou web spider +  Pinterest
-* Exabot +
-* facebot, facebookexternalhit +
-ia_archiver +
-MJ12bot +
-AhrefsBot +
-SemrushBot +
-DotBot +
-* Screaming Frog +
-* SEOkicks +
-* Seobility +
-* SISTRIX +
-* rogerbot, Moz+
  
-===== GEO / IA =====+==== Podcast ====
  
-GPTBot (OpenAI) +  Podchaser 
-ChatGPT-User +  Spotify 
-Claude-WebClaudeBot (Anthropic+  Apple-Podcasts (AppleCoreMediaiTunes
-* anthropic-ai +  * Google-Podcasts 
-* PerplexityBot +  Overcast 
-* Google-Extended +  Pocket Casts 
-Cohere-ai +  Castro 
-CCBot (Common Crawl) +  Deezer
-Bytespider (ByteDance/TikTok) +
-* PetalBot +
-* YouBot +
-* Diffbot +
-* OAI-SearchBot +
-* Meta-ExternalAgent +
-* Meta-ExternalFetcher +
-* Amazonbot +
-* ImagesiftBot +
-* omgili, omgilibot +
-webzio+
  
-===== Réseaux sociaux =====+==== Internes ====
  
-Twitterbot +  WordPress-Cron 
-LinkedInBot +  GEO-Audit-Bot 
-Pinterest, Pinterestbot +  Jetpack
-* Slackbot +
-* TelegramBot +
-* WhatsApp +
-* Discordbot +
-* Snapchat+
  
-===== Autres =====+---
  
-* UptimeRobot +===== Cas d'utilisation =====
-* Pingdom +
-* StatusCake +
-* Netcraft +
-* W3C_Validator +
-* Validator.nu +
-* GTmetrix +
-* WebPageTest +
-* Chrome-Lighthouse +
-* archive.org_bot +
-* Feedfetcher+
  
-==== Structure des fichiers ====+==== Surveiller l'activité IA ====
  
-<pre> +Identifiez quels crawlers IA visitent votre site et à quelle fréquence.
-geo-bot-monitor/ +
-├── geo-bot-monitor.php         # Fichier principal +
-├── 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 ====+==== Bloquer les bots indésirables ====
  
-===== Table {prefix}_geo_bot_visits =====+Bloquez les bots SEO tiers (Moz, Ahrefs, MJ12bot) qui consomment de la bande passante sans apporter de valeur directe.
  
-{| class="wikitable" +==== Optimiser pour le GEO ====
-! 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 =====+Vérifiez que les bots IA (GPTBot, Claude-Web) accèdent correctement à vos contenus optimisés.
  
-* <code>idx_date</code> : sur visit_date +==== Mesurer l'impact ====
-* <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 ====+Comparez l'activité des bots avant/après modifications pour valider l'effet de vos optimisations GEO.
  
-La désinstallation du plugin supprime automatiquement :+---
  
-* La table <code>{prefix}_geo_bot_visits</code> +===== Changelog =====
-* L'option <code>geo_bot_monitor_db_version</code> +
-* L'option <code>geo_bot_monitor_api_key</code>+
  
-==== Changelog ====+==== Version 1.1.0 (Février 2026) ====
  
-===== 1.0.1 =====+  * **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.+  [[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]]+
  
geo-bot-monitor.1769457721.txt.gz · Dernière modification : de erwan