Hack The SEO — la documentation technique
Hack The SEO est un plugin WordPress qui fait le SEO à votre place : il audite, corrige, rédige, maille et mesure. Cette documentation explique chaque module en détail — pour les clients qui pilotent leur site, comme pour les consultants SEO & GEO qui veulent comprendre ce qui tourne sous le capot.
Qu'est-ce que Hack The SEO ?#
Hack The SEO améliore la visibilité de votre site sur Google et sur les moteurs de recherche IA (ChatGPT, Claude, Perplexity, Gemini). Il combine deux briques complémentaires :
- Un plugin WordPress installé sur votre site : il applique les corrections, gère le maillage, les cocons, les redirections, le schema, le GEO et le Coach IA — directement dans votre admin.
- Une plateforme SaaS (
app.hacktheseo.com) : analyse de trafic, recherche de mots-clés, audits sémantiques, cartes topicales et génération d'articles, avec les modèles d'IA inclus.
Ce que vous pouvez faire
- Vérifier l'état de santé SEO du site en quelques secondes (score sur 100).
- Corriger automatiquement les erreurs : titres, meta descriptions, balises ALT, schema.
- Générer des cocons sémantiques et des articles longs optimisés par IA.
- Suivre positions, clics et trafic depuis Google Search Console, sans quitter WordPress.
- Mesurer et améliorer votre visibilité dans les IA (GEO Score, llms.txt, suivi des bots).
- Piloter tout ça en langage naturel via un agent IA connecté (MCP).
Pour qui est cette documentation ?
Propriétaires de site
PME, freelances, e-commerçants. Aucune compétence technique requise : chaque écran guide pas à pas.
Consultants SEO
Comprendre les scores, le clustering par embeddings, le budget de liens, les leviers exacts de chaque module.
Spécialistes GEO
GEO Score (12 critères pondérés), llms.txt / llms-full.txt, pages .md et suivi des crawlers IA.
Comment le plugin et la plateforme s'articulent#
Le plugin WordPress est le « bras » qui agit sur votre site. Le SaaS est le « cerveau » qui héberge l'IA, la Search Console et les traitements lourds. Les deux communiquent via une clé API unique.
Le plugin WordPress
Installé sur votre site. Il lit et écrit vos contenus, injecte le schema et les metas, sert le sitemap / robots / llms.txt, gère cocons, maillage, redirections, et affiche le Cockpit. Compatible PHP 7.4 → 8.2, hébergement mutualisé inclus.
La plateforme SaaS
Héberge les modèles d'IA (OpenAI, Anthropic), le proxy Google Search Console, les embeddings et les moteurs de décision. Toutes les IA sont incluses : aucune clé OpenAI/Claude à fournir, aucune facture cloud à gérer.
Où tourne quoi ?
| Traitement | Plugin (local) | SaaS (serveurs HTS) |
|---|---|---|
| Metas, schema, sitemap, robots, breadcrumbs | ✔ 100 % local | — |
| Score SEO, GEO Score, détection cannibalisation | ✔ local | — |
| Suivi des bots IA & du trafic (Impact Tracker) | ✔ tables hts_crawls / hts_visits | — |
| Rédaction d'articles, réécriture meta par IA | — | ✔ modèles inclus |
| Embeddings (empreintes sémantiques du contenu) | ~ cache local | ✔ calcul |
| Google Search Console (mode proxy) | — | ✔ tokens OAuth côté SaaS |
La connexion se fait via une clé API (menu Réglages → Connexions). Un vérificateur de tier signé (HMAC) valide votre offre Free / Pro / Ultra, avec un disjoncteur de sécurité si les serveurs sont indisponibles.
Installer et lancer votre premier scan#
De l'installation au premier score de santé : environ 5 minutes. Le plugin est zéro-config — il fonctionne dès l'activation, la clé API ne débloque que l'IA et l'automatisation.
Créez votre compte
Sur hacktheseo.com, créez un compte (essai possible sans carte bancaire selon le plan). Vous récupérez votre clé API dans votre espace.
Installez le plugin
Dans WordPress : Extensions → Ajouter → Téléverser, puis activez. Rendez-vous dans Hack The SEO → Cockpit.
Connectez la clé API et Google Search Console
Réglages → Connexions : collez la clé API, puis connectez votre Google Search Console (mode proxy, aucun token à gérer).
Laissez le premier scan tourner
Le score de santé et les premières recommandations apparaissent dans le Cockpit. Les données GSC remontent sous 24–48 h.
Free, Pro & Ultra : qui a accès à quoi#
Trois niveaux. La grille ci-dessous est la référence canonique, alignée sur le code du plugin (HTS_Subscription). Le socle SEO technique est gratuit ; Pro débloque l'analyse ; Ultra débloque l'exécution automatique.
Le socle SEO complet
Tous les modules SEO de base, le score global, le llms.txt, la migration, le Coach (5 questions/mois), les redirections + suggestions IA, la détection de cannibalisation, le rafraîchissement de contenu.
Analyser & planifier
Tout le Free, plus : analyse de cocon, plans de cocon, export, Coach illimité + rapports + mémoire + analytics, accès à l'Inbox, planning éditorial.
Exécuter automatiquement
Tout le Pro, plus : rédaction de cocon, application des liens (maillage IA), articles standalone, auto-write, actions de l'Inbox, mode agent autonome, rapport hebdo, PDF brandé, embeddings, fusion de cannibalisation, strategy/decision engine, audit trail.
Grille des capacités (extrait du code)
| Capacité | Free | Pro | Ultra |
|---|---|---|---|
| Modules SEO (metas, schema, sitemap, robots, redirections, breadcrumbs) | ✔ | ✔ | ✔ |
| Score global & health check · llms.txt · assistant migration | ✔ | ✔ | ✔ |
| Coach IA | 5 questions / mois | Illimité | Illimité |
| Détection de cannibalisation · suggestions IA de redirection 404 | ✔ | ✔ | ✔ |
| Analyse de cocon · plans d'articles · export | — | ✔ | ✔ |
| Voir l'Inbox · rapports Coach · planning éditorial | — | ✔ | ✔ |
| Rédaction auto d'articles · articles standalone (auto-write) | — | — | ✔ |
| Maillage IA : appliquer les liens · import cocon | — | — | ✔ |
| Appliquer les actions de l'Inbox · mode agent autonome | — | — | ✔ |
| Fusion de cannibalisation · rapport hebdo · PDF brandé · audit trail | — | — | ✔ |
| Strategy engine · decision engine · feedback loop · embeddings | — | — | ✔ |
Cockpit : le tableau de bord de santé#
Le Cockpit est la première page que vous voyez. Il affiche un score de santé sur 100, les problèmes les plus urgents, et donne accès à l'Inbox, au Coach IA et à l'Historique.
Lire le score de santé
Sous le score, des cartes d'alerte montrent ce qui ne va pas, pourquoi c'est important, et un lien pour corriger. Les alertes les plus urgentes remontent en premier. Le Cockpit s'organise en onglets : Tableau de bord (score + alertes), Inbox (recommandations des agents), Coach IA (questions/réponses sur vos données) et Historique (actions passées + impact).
Les trois scores du plugin
| Score | Portée | Ce qu'il mesure |
|---|---|---|
| Score on-page | Une page / un article | Score en temps réel dans l'éditeur : titre, description, structure Hn, mots-clés, ALT, canonical, robots… (analyse multi-critères). |
| Score global | Tout le site | Agrège la santé technique et éditoriale du site en une note sur 100 (affichée dans le Cockpit). |
| GEO Score | Article / catégorie | Note de « citabilité » par les IA — 12 critères pondérés (voir GEO Score). |
Meta Tags & aperçu SERP#
Gérez les titres et meta descriptions de toutes vos pages, avec un aperçu en temps réel du rendu dans Google.
Où configurer
- Global : Réglages → onglet Réglages SEO — titre & description de la page d'accueil, format de titre par défaut, séparateur, informations Organization (nom, logo, réseaux sociaux) pour le schema.
- Par page : dans l'éditeur WordPress, le bloc Hack The SEO sous le contenu — champs Titre SEO et Meta Description, compteur de caractères en temps réel, aperçu Google.
Suggestions automatiques en lot
Quand le système détecte des pages sans meta ou avec des metas faibles, il dépose des suggestions dans l'Inbox. Vous prévisualisez l'avant/après, appliquez en 1 clic, ou rejetez — traitement en lot possible. Via l'IA, l'outil hts_apply_meta_fix réécrit et applique la meta selon votre brand voice.
Schema JSON-LD (données structurées)#
Hack The SEO génère automatiquement les données structurées qui permettent à Google d'afficher des résultats enrichis (étoiles, FAQ dépliables, fil d'Ariane) — et aident les IA à comprendre vos pages.
Le schema est auto-détecté selon le type de contenu : Article, FAQ, HowTo, Product, Recipe, Event, etc. Vous n'avez rien à coder. La configuration (Organization, types actifs) se fait dans Réglages → Réglages SEO → section Schema, puis le JSON-LD est injecté sur chaque page.
Types de schema émis
Le module couvre plus de 45 types Schema.org (et leurs sous-objets), notamment :
search.google.com/test/rich-results. Via l'IA, hts_audit_all_schemas audite tous les schemas du site et hts_fix_missing_schema ajoute ceux qui manquent.E-E-A-T & schema Auteur
Le plugin gère le schema Person pour les auteurs (bio, liens, expertise) — un signal E-E-A-T lu par Google comme par les IA. Les outils hts_get_author_schema_audit et hts_set_author_schema auditent et corrigent l'attribution d'auteur (un auteur ≠ « admin » compte dans le GEO Score).
Sitemap XML & robots.txt#
Un sitemap dynamique qui aide Google à découvrir toutes vos pages, et un robots.txt optimisé — les deux gérés automatiquement.
Sitemap XML
- Généré à
votresite.com/sitemap.xml, mis à jour à chaque publication/modification. - Les pages en noindex sont exclues automatiquement ; le sitemap natif de WordPress est désactivé pour éviter les doublons.
- Choix des types de contenu inclus (articles, pages, produits, catégories) dans Réglages → Réglages SEO → Sitemap XML.
- Si la Search Console est connectée, le sitemap est soumis automatiquement à Google.
Robots.txt
Un robots.txt optimisé est servi par défaut, éditable dans Réglages → Réglages SEO → Robots.txt (bouton Restaurer pour revenir au défaut).
Disallow: /. Un fichier robots.txt physique sur le serveur a la priorité sur celui du plugin — supprimez-le ou renommez-le.Redirections 301 & erreurs 404#
Gérez les redirections pour éviter les 404 et préserver la valeur SEO quand vous supprimez ou déplacez une page.
- Créer : Hack The SEO → Redirections → Ajouter. URL source + destination, type 301 (permanent, recommandé dans 95 % des cas), 302, 307 ou 410. Bouton Tester.
- 404 détectées : l'onglet dédié liste les erreurs avec leur nombre de visites. Pour chaque 404, le plugin suggère la destination la plus pertinente (suggestion IA, incluse dès le tier Free).
- Import en lot : fichier CSV à deux colonnes (source, destination) via le bouton Importer.
Via l'IA : hts_audit_redirects vérifie les chaînes et boucles de redirection, hts_create_redirect en crée une, hts_fix_broken_internal_links répare les liens internes cassés.
Canonical (URL canonique)#
La balise canonical dit à Google quelle est la version officielle d'un contenu accessible via plusieurs adresses. Hack The SEO en ajoute une automatiquement sur chaque page.
- Par défaut, chaque page pointe vers elle-même (auto-canonical). Les paramètres d'URL (utm, tri, filtres) sont gérés automatiquement.
- Pour pointer une page vers une autre : champ URL Canonical dans le bloc Hack The SEO de l'éditeur.
- Cas d'usage : contenu republié (pointer vers l'original), deux pages très similaires (pointer la secondaire vers la principale).
Cocons sémantiquesPro / Ultra#
Un cocon sémantique est un groupe d'articles qui traitent du même thème et se relient entre eux. Hack The SEO analyse votre site, regroupe automatiquement vos contenus autour d'une page pilier, et vous dit ce qui manque — pour démontrer à Google et aux IA que vous êtes une référence sur le sujet.
L'anatomie d'un cocon
| Rôle | Définition |
|---|---|
| Pilier | La page principale du cocon (votre sujet central). Une seule par cocon. |
| Article fille | Un article directement relié au pilier (lien entrant ou sortant avec lui). |
| Article satellite | Un article du cocon, sur le même thème, sans lien direct au pilier. |
| Page orpheline | Une page sans aucun lien interne — à corriger en priorité. |
| Réserve « Non classé » | Pages non rattachées à un cocon (sujet trop éloigné), réutilisables plus tard. |
Créer un cocon, pas à pas
Tout se passe dans Hack The SEO → Groupes de contenus, organisé en trois onglets : Pages business (choisir les piliers), Mes groupes (voir et gérer les cocons), Rédaction (articles manquants).
Détecter les pages business
Onglet Pages business → Détecter. Le plugin scanne le site et propose vos pages importantes (celles qui doivent ranker).
Choisir les piliers
Cochez les pages qui seront piliers (une par cocon). Règle simple : N piliers cochés = N cocons.
Créer les groupes
Le plugin range chaque article autour du bon pilier par analyse sémantique. Le reste part dans la réserve « Pages à organiser ».
Compléter & mailler
Onglet Rédaction : lancez la rédaction des articles manquants (Ultra), puis créez les liens internes (Ultra).
Comment le plugin classe les articles
Le plugin compare le sens des contenus, pas juste les catégories WordPress. Chaque article est transformé en embedding (une empreinte numérique du sens du texte), puis le plugin mesure sa proximité au pilier. Au-dessus d'un seuil de 0,45, l'article rejoint le cocon ; en dessous, il part dans « Non classé ». C'est ce qui évite qu'un article hors sujet pollue un cocon, même s'il partage des tags.
Paramètres & repères par défaut
| Réglage | Valeur par défaut |
|---|---|
Mode du site (hts_seo_mode) | Auto (Éditorial / E-commerce, détecté selon WooCommerce) |
| Seuil de proximité sémantique | 0,45 |
| Objectif d'articles (pour le score) | ≈ 12 (éditorial) · 3 à 5 (e-commerce) |
| Taille idéale d'un cocon | 5 à 20 pages (au-delà de 30, diviser) |
| Plafond de pages à l'analyse | 5 000 |
Limites & prérequis
- Offre : Pro minimum pour analyser/planifier ; Ultra pour rédiger et mailler. En Free, l'écran est un aperçu verrouillé.
- Multilingue : ne mélangez jamais les langues dans un cocon. Le plugin analyse une langue à la fois — sinon, utilisez Recréer les groupes.
- wp-cron : sur hébergement mutualisé, un rattrapage se déclenche à l'ouverture de l'admin (au plus toutes les 5 min) si les tâches de fond sont en panne.
- Boutique : un produit n'est jamais pilier — le pilier est la catégorie produit (voir E-commerce).
Maillage interneUltra#
Le maillage analyse tous vos liens internes, détecte les pages orphelines, et propose des liens précis — avec la page source, la destination, le texte d'ancre, le paragraphe exact et un score de pertinence. Compatible Elementor, Divi, Gutenberg.
Pourquoi c'est crucial
Les liens internes ont trois fonctions : découverte (Google trouve les nouvelles pages en suivant les liens ; une orpheline peut ne jamais être indexée), compréhension (le texte d'ancre indique le sujet de la destination) et distribution d'autorité (chaque page transmet une part de son autorité). Concrètement : un site de 200 pages bien maillé surpasse un site de 500 pages mal maillé.
Le flux « Créer les liens »
Les propositions de liens sont créées et affichées uniquement après un clic explicite sur « Créer les liens » : rien n'apparaît tant que vous ne l'avez pas déclenché. Le bouton lance le scan, propose les liens, et affiche un résultat clair : « N liens créés », « Quota hebdomadaire atteint (X/Y) » ou « Aucune nouvelle opportunité — cocon déjà maillé ».
Suggestion
Le plugin propose les liens (pointillés sur le graphe) avec ancre et emplacement.
Validation
Dans l'Inbox : prévisualisez en contexte, puis Appliquer ou Rejeter (blackliste la paire). Traitement en lot possible.
Application (push WordPress)
Le lien est inséré dans le contenu réel, quel que soit le builder. Réversible via l'Historique.
Garde-fous & budget de liens
- Pages orphelines : objectif de 2–3 liens entrants minimum par page. Un filet « anti-orphelin » rattrape les pages sans lien, tout en respectant les exclusions.
- Budget de liens : un quota hebdomadaire par cocon évite la sur-optimisation (le bonus cocon ×3 est pris en compte dans le total).
- Exclusions respectées : une page en noindex, redirigée 301, un produit, ou une page retirée à la main ne reçoit plus de lien (cache invalidé immédiatement).
- Rattrapage des anciens contenus : sur un site pré-existant, le plugin peut marquer tout un cocon pour lui ajouter des liens par lots, sans surcharger le serveur.
Via l'IA : hts_apply_internal_link_suggestions (application), hts_verify_anchors (vérification des ancres), hts_qa_link_budget (contrôle du budget).
Cannibalisation#
La cannibalisation, c'est quand deux pages se font concurrence sur le même mot-clé dans Google — résultat, aucune ne se positionne bien. C'est l'un des problèmes SEO les plus courants et les plus invisibles.
Détecter
Dans Hack The SEO → Pages en concurrence, vous voyez les paires de pages en conflit : le mot-clé commun, les positions de chaque page, et la sévérité (rouge = urgent, orange = important, jaune = mineur). Commencez toujours par les cas rouges.
Résoudre — 4 actions proposées
Fusionner Ultra
Combine le meilleur des deux pages en une seule, puis redirige l'ancienne URL.
Différencier
Modifie titres et contenu pour cibler des intentions de recherche distinctes.
Rediriger
Si une page est clairement inférieure, la rediriger (301) vers la meilleure.
Canonicaliser
Garder les deux pages accessibles, mais une seule indexée (balise canonical).
hts_get_cannibalization.Rédaction IA & fraîcheur du contenuUltra#
Le plugin génère des articles de blog optimisés SEO à partir d'un mot-clé ou d'un sujet, en tenant compte du contexte du cocon (pilier + autres satellites). L'article arrive en brouillon dans l'Inbox — jamais publié sans votre validation.
Générer un article
- Dans Groupes de contenus, sélectionnez un cocon et un satellite manquant.
- Cliquez Générer cet article. L'IA analyse le sujet dans le contexte du cocon.
- Le brouillon arrive dans l'Inbox : relisez, enrichissez (votre expertise, exemples, liens), puis approuvez.
- À l'approbation, l'article est programmé au prochain créneau (max 1/jour par défaut pour espacer les publications).
Vous pouvez aussi générer depuis le SaaS (mot-clé ou URL de concurrent → clusters sémantiques → plan éditable → contenu section par section → envoi vers WordPress en brouillon ou publication). Compatible Gutenberg et Elementor.
Fraîcheur (freshness)
Le module de fraîcheur repère les articles qui vieillissent et propose de les rafraîchir (le contenu récent est mieux noté par Google et compte dans le GEO Score : < 90 jours = frais). Via l'IA : hts_get_freshness, hts_get_stale_articles, hts_list_worst_articles, hts_schedule_refresh.
Images & attributs ALT#
Les balises ALT décrivent vos images pour Google et l'accessibilité — et comptent dans le GEO Score (au moins 2 images avec un ALT contenant le mot-clé).
- Génération d'ALT : le plugin détecte les images sans texte alternatif et propose un ALT descriptif contenant le mot-clé de la page.
- Cascade d'images & prompt builder : pour la génération d'images IA (Ultra), un constructeur de prompt aligne le visuel sur le sujet de l'article.
- Bonne pratique : un ALT descriptif, jamais du bourrage de mots-clés. Exemple : « Cocon sémantique automatisé sur WordPress » plutôt que « seo wordpress seo plugin seo ».
width et height sur vos images in-content pour éviter le CLS (décalage de mise en page) mesuré par Google dans les Core Web Vitals.Le GEO Score#
GEO = Generative Engine Optimization : l'optimisation pour être cité par les IA (ChatGPT, Claude, Perplexity, Gemini, AI Overviews de Google). Le GEO Score est une note de 0 à 100 qui mesure à quel point un contenu est « citable » par une IA — calculée sur 12 critères pondérés (recherche Princeton + consensus GEO 2026).
Lire le score
Les 12 critères et leurs poids
Le total brut fait 113 points, ramené sur 100. Pour chaque critère faible, le plugin fournit un « fix » concret et remonte les 5 recommandations prioritaires.
| Critère | Poids | Ce qui est regardé |
|---|---|---|
| FAQ & listes structurées | 18 | FAQ, listes <ul>/<ol>, blocs <details> |
| Réponse directe en intro | 15 | 1er paragraphe de 20–80 mots + mot-clé dedans |
| Données chiffrées & stats | 15 | Nombres, %, €, + mots de sourcing (« selon », « étude »…) |
| Structure H2/H3 | 12 | Au moins 3 H2 + 2 H3 |
| Sources citées | 10 | Liens vers domaines autoritaires (.gouv, .edu, Wikipedia, INSEE…) |
| Longueur du contenu | 8 | Idéal ≥ 1500–2500 mots |
| Maillage interne | 8 | Au moins 3–5 liens internes |
| Images & ALT SEO | 7 | ≥ 2 images avec ALT contenant le mot-clé |
| Meta title & description | 5 | Title 30–65 car., description 120–160 car. |
| Fraîcheur | 5 | Modifié il y a < 90 jours = frais |
| Schema Markup | 5 | JSON-LD détecté (FAQ, HowTo…) |
| Signaux E-E-A-T | 5 | Auteur ≠ « admin », bio auteur, date publiée |
Les 5 leviers les plus payants
- Ajoutez une FAQ (3–5 questions en fin d'article) — le critère le plus lourd (18 pts). Les IA adorent extraire des Q/R.
- Répondez dès l'intro : un 1er paragraphe de 30–60 mots avec le mot-clé dans les premiers mots (15 pts).
- Mettez des chiffres : statistiques, pourcentages, données sourcées (15 pts).
- Structurez en H2/H3 clairs (12 pts) et citez 2–3 sources autoritaires (10 pts).
- Allongez si trop court, ajoutez du maillage, des images avec ALT, et gardez le contenu frais.
geo_score). Le GEO Score est un proxy de citabilité, pas une garantie d'être cité.llms.txt, llms-full.txt & pages .md#
Trois fichiers servis automatiquement pour donner aux IA une version propre et structurée de votre site. Pensez à un robots.txt, mais pour aider les LLM à comprendre quoi lire chez vous.
| Fichier | Contenu | Rôle |
|---|---|---|
/llms.txt | Sommaire : piliers, pages clés, posts récents, produits/catégories, ressources (sitemap, RSS) + consignes d'usage. | La « carte » de votre site pour les IA. |
/llms-full.txt | Version étendue (« GEO premium ») : contenu complet des piliers, résumés longs, catalogue produits structuré. | Donne beaucoup plus de matière pour vous citer précisément. |
/mon-article.md | Version markdown propre de chaque page (ajoutez .md à l'URL) : titre, URL, date, auteur, corps converti proprement. | Les LLM lisent mieux du texte propre que du HTML. |
noindex pour ne pas polluer Google). Deux modes dans Réglages SEO → llms.txt : Auto (le plugin choisit piliers + pages clés + posts récents) ou Manuel.# Nom du site
> Description courte de votre activité et de votre expertise.
## Piliers
- [Titre du pilier](https://votresite.com/pilier/) : résumé en une phrase.
## Pages clés
- [Page importante](https://votresite.com/page/) : à quoi elle sert.
## Articles récents
- [Dernier article](https://votresite.com/article/) : de quoi il parle.
## Ressources
- Sitemap : https://votresite.com/sitemap.xml
- Flux RSS : https://votresite.com/feed/
Standard de référence : llmstxt.org. Via l'IA (Ultra) : hts_get_llmstxt, hts_get_llmstxt_full, hts_get_md_page.
Suivi des bots IA (votre « radar »)#
Le plugin détecte quand les crawlers des IA viennent explorer votre site — la preuve que les robots des IA lisent votre contenu, première étape avant d'être cité. 100 % local, aucune clé externe.
Comment ça marche
À chaque page chargée, le module Impact Tracker lit le User-Agent du visiteur et reconnaît les crawlers connus. Chaque passage est enregistré (page, heure, code de réponse) dans les tables hts_crawls et hts_visits, avec anti-doublon (max 1 passage par bot + page + heure). Visible dans le dashboard via le feed « Surveillance IA » (« ChatGPT a exploré [page] », « Claude a exploré… ») + total sur 30 jours et tendance.
Bots IA suivis
| Famille | User-Agents reconnus |
|---|---|
| ChatGPT / OpenAI | GPTBot, ChatGPT-User |
| Claude / Anthropic | ClaudeBot, Claude-Web, anthropic-ai |
| Perplexity | PerplexityBot |
| Google Gemini | Google-Extended, Gemini-Bot |
| Microsoft Copilot | CopilotBot |
| Meta AI | Meta-ExternalAgent, FacebookBot |
| Autres | cohere-ai, Applebot-Extended, CCBot, Bytespider, Diffbot |
Les bots SEO classiques (Googlebot, Bingbot, Semrush, Ahrefs…) sont distingués pour ne pas être mélangés avec les bots IA.
Trafic humain venu des IA
Quand un humain clique vers votre site depuis une interface d'IA (chatgpt.com, claude.ai, perplexity.ai, gemini.google.com…), le plugin le détecte via le referrer. L'outil hts_track_llm_referrer mesure ce trafic GEO réel.
hts_get_ai_bot_visits (Ultra) : répartition par bot, tendance 7 jours, top des pages crawlées.Agents & Inbox#
Les agents IA analysent votre site en continu et déposent leurs recommandations dans l'Inbox. Vous gardez la main : rien n'est appliqué sans votre validation (sauf mode autonome activé explicitement).
Les agents disponibles
Chaque agent s'active/désactive dans Réglages → Agents. La Protection (Réglages → Protection) encadre leur activité : budget maximum mensuel, heures d'activité, pages à exclure.
Traiter une recommandation
Ouvrir l'Inbox
Cockpit → onglet Inbox. Les recommandations sont typées : Meta, Liens internes, Contenu, Technique.
Vérifier l'avant/après
Cliquez une recommandation pour voir le détail et la prévisualisation.
Appliquer ou rejeter
Appliquer (instantané) ou Rejeter. Traitement en lot avec la sélection multiple.
Coach IAFree : 5/mois#
Un assistant IA connecté à vos vraies données : Search Console, maillage, metas, cocons, cannibalisation. Il répond, diagnostique et génère des rapports — mais ne modifie rien directement : toute action passe par l'Inbox.
Quoi lui demander
Rapports exportables (PDF)
| Rapport | Contenu |
|---|---|
| Audit SEO | Score par catégorie, problèmes par priorité, recommandations par impact. |
| Performance | Évolution clics & impressions, pages en hausse/baisse, tendances mots-clés. |
| Maillage | Pages orphelines, distribution des liens. |
| Contenu | Qualité des articles, longueur, structure, scores meta. |
| GEO | Visibilité IA, citations, share of voice, sentiment, comparaison concurrents. |
Free : 5 questions/mois. Pro & Ultra : illimité, avec mémoire, rapports et analytics.
MCP — piloter votre SEO avec ClaudeUltra#
Via le MCP (Model Context Protocol), vous connectez un agent IA — Claude — directement à votre site. Il lit Hack The SEO, votre Search Console et le contenu de vos pages, puis délivre diagnostics et actions. Un consultant SEO conversationnel, disponible 24/7, en français.
Comment ça marche
Vous posez la question
« Pourquoi ma page services ne ranke pas ? » — en langage naturel, dans Claude.
Claude analyse
Il appelle les abilities du plugin : lecture du site, de la GSC, de l'audit Hack The SEO.
Vous recevez le plan
Diagnostic argumenté + plan d'action priorisé. En Ultra, Claude peut aussi appliquer les correctifs.
Abilities de lecture (diagnostic)
Consultables pour comprendre l'état du site, sans rien modifier :
hts_get_site_health # santé globale du site
hts_get_global_score # score SEO du site (/100)
hts_get_geo_score # GEO Score d'un article
hts_audit_cocon # audit d'un cocon sémantique
hts_get_cannibalization # paires de pages en concurrence
hts_get_gsc_gaps # opportunités Search Console
hts_diagnose_seo_issue # diagnostic d'un problème précis
hts_get_ai_bot_visits # visites des crawlers IA
hts_get_prioritized_actions # actions classées par impact
Abilities d'action (Ultra)
Pour exécuter — chaque action est tracée et réversible :
hts_apply_meta_fix # réécrit & applique une meta
hts_apply_internal_link_suggestions # pose les liens internes
hts_create_cocon_plan # crée le plan d'un cocon
hts_create_redirect # crée une redirection 301
hts_fix_missing_schema # ajoute le schema manquant
hts_rollback_action # annule une action (retour arrière)
hts_notify_indexnow # signale la page à Bing/Yandex
Exemples de prompts
Historique, rollback & mesure d'impact#
Chaque action est journalisée. Vous pouvez revenir en arrière en toute sécurité, et mesurer l'effet réel de chaque changement sur votre trafic.
- Annulation (rollback) : Cockpit → Historique, trouvez l'action, cliquez Annuler. Le contenu revient à son état d'avant. Disponible 30 jours.
- Audit trail Ultra : journal complet des actions (qui, quoi, quand), interrogeable via
hts_get_audit_trail. - Mesure d'impact causal : le plugin isole l'effet d'un changement sur le trafic — analyse avant/après, difference-in-differences (DiD), détection de points de rupture (changepoints).
Via l'IA : hts_get_rollback_history, hts_rollback_action, hts_get_impact_report, hts_get_causal_impact, hts_compare_before_after.
Google Search Console#
La Search Console fournit les données officielles de Google : mots-clés qui vous trouvent, clics, impressions, positions. Connectée à Hack The SEO, elle alimente les scores, les opportunités et le Coach.
- Connexion (mode proxy) : Réglages → Connexions → Connecter Google Search Console. Autorisez Hack The SEO à lire vos données ; les tokens OAuth sont gérés côté SaaS — aucun token à manipuler.
- Délai : les données apparaissent sous 24–48 h après la première connexion.
- Analytics dans WordPress : clics, impressions, position moyenne et CTR directement dans Hack The SEO → Analytics.
- Trouver les opportunités : filtrez les mots-clés en position 11–20 (2e page), triez par impressions décroissantes — ce sont vos meilleurs gains rapides.
hts_get_gsc_gaps, hts_get_gsc_impact, hts_get_keyword_opportunities.Si aucun site n'est détecté : vérifiez que vous utilisez le bon compte Google, que l'adresse est exacte (www ≠ sans www), et que le site est en HTTPS. Sur hébergement mutualisé, un cron dédié synchronise les données par lots.
E-commerce WooCommerceUltra#
Hack The SEO optimise les boutiques WooCommerce comme des sites éditoriaux : fiches produit, catégories, cocons e-commerce, schema Product et audit boutique.
- Cocons e-commerce : sur une boutique, le pilier d'un cocon est une catégorie produit (jamais un produit seul). Les produits deviennent les feuilles rattachées à la catégorie. Objectif d'articles plus bas (3 à 5).
- Schema Product : prix, disponibilité, avis (AggregateRating), politique de retour — pour les résultats enrichis Google Shopping.
- Metas & GEO de catégorie : titre/description SEO éditables, GEO Score sur la page d'archive (avec bouton « Générer titre/desc SEO »).
- Maillage produit : suggestions de liens entre produits, catégories et articles éditoriaux liés.
- Pages d'attribut : génération de landing pages par attribut (couleur, taille, marque…) pour capter la longue traîne.
Via l'IA : hts_audit_shop (audit boutique), hts_analyze_product, hts_suggest_ecommerce_links, hts_apply_ecommerce_link, hts_detect_attribute_opportunities, hts_generate_attribute_landing.
Compatibilité & specs techniques#
Hack The SEO s'installe en quelques minutes, fonctionne sur les hébergements mutualisés grand public, et n'exige aucune clé API tierce.
| Élément | Compatibilité |
|---|---|
| WordPress | 5.9 minimum · testé jusqu'à 6.9 |
| PHP | 7.4 à 8.2 (polyfills inclus pour PHP 7.4) |
| Constructeurs de page | Gutenberg, Elementor, Divi, Bricks, Avada |
| E-commerce | WooCommerce |
| Multilingue | Polylang, WPML (une langue par cocon) |
| Hébergement | Mutualisé grand public inclus (rattrapage wp-cron) |
| Clés API IA | Aucune à fournir — OpenAI & Anthropic inclus dans l'abonnement |
| Données & RGPD | Traitements Europe · suivi des bots 100 % local · conforme RGPD |
Ultra léger
Empreinte minimale, chargement instantané, score Lighthouse préservé.
Coexistence
Un module de compatibilité évite les conflits pendant la migration depuis un autre plugin SEO.
Migration en 1 clic
Import des meta titles/descriptions depuis Yoast, Rank Math, SEOPress, AIOSEO.
FAQ & dépannage#
Les questions les plus fréquentes des clients et des consultants.
Hack The SEO remplace-t-il Yoast / Rank Math / SEOPress / AIOSEO ?
Est-ce que ça ralentit mon site ?
Faut-il une clé API OpenAI / Claude ?
Est-ce conforme RGPD ?
Ça marche sur Elementor / Divi / Bricks / WooCommerce ?
Combien de temps pour voir des résultats ?
Mes articles restent « en file d'attente », pourquoi ?
Le contenu IA est-il pénalisé par Google ?
Glossaire SEO / GEO#
Les termes clés de la documentation, en une ligne.
- Cocon sémantique
- Groupe de pages d'un même thème, reliées entre elles autour d'un pilier.
- Pilier
- La page principale d'un cocon (le sujet central). Une seule par cocon.
- Article fille / satellite
- Fille = reliée directement au pilier. Satellite = même thème, sans lien direct au pilier.
- Page orpheline
- Page sans aucun lien interne (ni entrant ni sortant) — à corriger en priorité.
- Topical authority
- « Légitimité thématique » d'un cocon, notée sur 100.
- Embedding
- Empreinte numérique du sens d'un texte, utilisée pour mesurer la proximité entre deux pages.
- Clustering
- L'opération qui regroupe automatiquement les pages par thème.
- Cannibalisation
- Deux pages qui se font concurrence sur le même mot-clé — aucune ne se positionne bien.
- Canonical
- Balise qui indique à Google la version officielle d'un contenu accessible via plusieurs URLs.
- Schema JSON-LD
- Données structurées invisibles qui aident Google (résultats enrichis) et les IA à comprendre une page.
- E-E-A-T
- Experience, Expertise, Authoritativeness, Trust — signaux de crédibilité (auteur, sources, dates).
- GEO
- Generative Engine Optimization : optimiser pour être cité par les IA, pas seulement pour ranker sur Google.
- GEO Score
- Note 0–100 de « citabilité » d'un contenu par les IA (12 critères pondérés).
- llms.txt / llms-full.txt
- Fichiers texte qui présentent votre site aux LLM ; la version full inclut le contenu complet des piliers.
- Page .md
- Version markdown propre d'une page (ajoutez
.mdà l'URL), pensée pour la lecture par les LLM. - Crawler IA
- Robot d'une IA qui explore le web pour nourrir ses réponses (GPTBot, ClaudeBot, PerplexityBot…).
- AI Overviews
- Réponses générées par IA affichées directement par Google en haut des résultats.
- MCP
- Model Context Protocol : le standard qui connecte un agent IA (Claude) au plugin via des « abilities ».
- Ability
- Une fonction que l'IA peut appeler (lecture ou action) sur votre site via le MCP.