Documentation de l'extension · mise à jour le 28 octobre 2026
Hack The SEO, la documentation du plugin WordPress.
Hack The SEO est une extension WordPress qui fait votre SEO et votre GEO avec Claude : chaque matin du lundi au vendredi, Claude fait une action sur votre site, et vous validez d'un clic. Cette documentation explique chaque écran, chaque module et chaque garde-fou.
Sommaire de la documentation
Qu'est-ce que Hack The SEO ?
Hack The SEO est un plugin SEO pour WordPress qui ne se contente pas de signaler les problèmes : il les corrige. Il réunit le SEO technique (titres, données structurées, sitemap, redirections), un moteur sémantique (groupes de contenus, maillage interne, pages en concurrence) et le GEO, c'est-à-dire tout ce qui aide les IA comme ChatGPT, Claude ou Perplexity à citer votre site.
Être en haut de Google, c'est le SEO. Être cité par les IA, c'est le GEO. Hack The SEO travaille les deux, avec Claude, l'assistant d'IA d'Anthropic, branché à votre WordPress.
Ce que vous pouvez faire
- Obtenir un bilan de votre site, une stratégie et un plan de 90 jours, en une conversation avec Claude.
- Laisser Claude faire une action réelle à chaque passage du matin : un titre réécrit, un lien ajouté, une page remise à jour, un brouillon d'article.
- Valider chaque semaine d'un clic, et annuler n'importe quelle modification pendant 30 jours.
- Suivre vos clics Google, vos pages en concurrence, les visites des robots d'IA et votre visibilité dans les réponses des IA.
Gratuit et payant, ce sont deux extensions différentes. L'extension gratuite « Hack The SEO » de wordpress.org fait le SEO technique. Cette documentation décrit l'extension de l'abonnement, téléchargée depuis votre espace client, qui travaille avec Claude. Quand elle est active, l'extension gratuite se met en veille toute seule.
Comment ça marche : trois pièces
Trois pièces travaillent ensemble. L'extension agit sur votre site. Claude réfléchit et propose. Votre espace client tient votre abonnement et votre clé.
| Pièce | Où elle vit | Ce qu'elle fait |
|---|---|---|
| L'extension Hack The SEO | Dans votre WordPress | Sert les titres, les données structurées, le sitemap, le llms.txt ; mesure les pages ; applique les modifications validées ; garde la trace de tout pour pouvoir annuler. |
| Claude | Votre compte claude.ai ou l'application Claude | Se branche à votre site par le connecteur « Hack The SEO », lit vos pages et vos chiffres, propose le plan, fait une action à chaque passage du matin. |
| Votre espace client | app.hacktheseo.com | Votre abonnement, le téléchargement de l'extension et votre clé personnelle. |
Claude ne touche jamais à votre site en dehors de l'extension : il passe par des outils que l'extension lui donne, avec les droits que vous avez acceptés. Vos règles et vos validations restent dans votre WordPress.
Mise en route, en résumé
Comptez environ 15 minutes dans WordPress, puis une dizaine de minutes avec Claude. Rien ne change sur votre site pendant la mise en route. Le guide complet, avec les noms exacts des boutons, est dans le centre d'aide.
- Dans votre espace client, page Installer le plugin : téléchargez l'extension (.zip) et copiez votre clé.
- Dans WordPress : Extensions, Ajouter une extension, Téléverser une extension, puis Activer l'extension.
- L'écran Démarrer s'ouvre, en 6 étapes : votre clé, puis Avec Claude, puis Google (ou Plus tard), puis Brancher Claude (bouton Continuer dans Claude, puis Autoriser une seule fois), puis les règles et la sauvegarde, puis la phrase.
- Dans une nouvelle conversation Claude, envoyez Commence mon SEO. Claude fait le bilan, vous pose quelques questions et vous propose votre plan de 90 jours.
- Dans WordPress, Votre plan : cliquez sur Valider le plan et la semaine 1.
Offres
Deux façons de travailler. Dans les deux cas, il vous faut aussi un compte Claude : la version gratuite suffit pour commencer.
L'extension et le pilote Claude
249 € HT par mois
- L'extension Hack The SEO complète.
- Tout le pilote avec Claude : bilan, plan de 90 jours, passage du matin.
- AVA Solo, la mesure de votre visibilité dans les IA, offerte.
- Vous validez vous-même, d'un clic.
Pilote SEO GEO
490 € HT par mois, à partir de
- Tout ce qui précède.
- L'équipe Hack The SEO valide et suit votre site avec vous.
Le détail et les conditions sont sur la page des tarifs. AVA existe aussi seul, voir la page AVA.
Le rythme de la semaine
Claude travaille sur votre site du lundi au vendredi, le matin, avec une action réelle à chaque passage. Le rythme est le même pour tous les clients.
- Le passage du matin. Avec un abonnement Claude payant, une tâche planifiée de Claude (déclencheur En semaine) lance le passage toute seule ; Claude vous guide pour la créer à la fin de la mise en route. Avec la version gratuite de Claude, vous ouvrez Claude chaque matin et écrivez On continue mon SEO.
- La semaine. Chaque semaine du plan se prépare le jeudi d'avant. Vous la validez d'un clic dans Votre plan, avant le lundi 9 h.
- Le compte rendu. Après chaque passage, Claude écrit quatre lignes : Fait, Contrôle, À vous, Prochain passage.
- Le plan de 90 jours. Il part de votre bilan et de vos chiffres Google des 3 derniers mois. Sans Search Console, Claude fait un plan provisoire et le précise quand les chiffres arrivent.
Les garde-fous
Ces règles sont écrites dans l'extension. Vous les acceptez une fois, à l'étape des règles de l'écran Démarrer ; on vous les redemande seulement si elles changent.
| Garde-fou | Ce qu'il garantit |
|---|---|
| Claude propose, vous validez | Rien ne change sur vos pages sans votre accord. La semaine se valide d'un clic, les modifications hors semaine aussi. |
| Annulation 30 jours | Chaque modification de Claude est tracée et s'annule d'un clic pendant 30 jours. Vous pouvez aussi demander à Claude d'annuler. |
| Tout arrêter | Dans Mon IA, un administrateur peut tout arrêter à tout moment : Claude ne fait alors plus que lire. Claude ne peut ni poser ni lever cet arrêt. |
| Sauvegarde de moins de 7 jours | Une page n'est modifiée qu'avec une sauvegarde de moins de 7 jours (réglage par défaut). Seul un administrateur change ce réglage, dans WordPress. |
| 12 essais à l'abri | Avant la première modification d'une vraie page, Hack The SEO fait 12 essais sur une copie cachée à Google. Rien ne change chez vous. |
| Un plafond par jour | Le nombre de pages que Claude peut modifier chaque jour est limité, et un seul brouillon peut être publié par jour. |
Le menu de l'extension
Avec Claude, le menu Hack The SEO de WordPress tient en trois groupes. Les écrans s'appellent ainsi dans votre administration :
- Tableau de bordL'état de votre site en un coup d'œil.
- Votre planLe plan de 90 jours, les semaines à valider, les modifications qui attendent votre clic. Le chiffre à côté du menu dit combien.
- Mon IALa connexion avec Claude, vos règles, la sauvegarde exigée et le bouton Tout arrêter.
- Groupes de contenusVos pages regroupées par sujet autour d'une page pilier, et les articles qui manquent. Le calendrier des articles s'ouvre en haut de cet écran.
- Pages en concurrenceLes paires de pages qui se disputent la même recherche Google.
- RedirectionsVos redirections et les erreurs 404 relevées sur le site.
- StatistiquesVos clics, affichages et positions Google, page par page.
- Visibilité IALa mesure AVA : les IA citent-elles votre site ? Apparaît quand la mesure est allumée.
- RéglagesL'onglet SEO (titres, sitemap, robots.txt, llms.txt) et l'onglet Connexions, dont Google.
Ce que Claude peut faire sur votre site
Claude se branche à votre WordPress par MCP (Model Context Protocol), le standard qui relie un assistant d'IA à un logiciel. Dans Claude, c'est le connecteur « Hack The SEO ». Il donne à Claude des outils de lecture et des outils d'action, et l'extension vérifie vos droits à chaque appel.
Lire et comprendre
- La santé du site, les défauts de chaque page et leur score.
- Vos chiffres Search Console : requêtes, pages qui montent ou qui baissent, mots-clés en page 2.
- Les groupes de contenus, les pages orphelines, les pages en concurrence.
- Le score GEO d'une page, les visites des robots d'IA, votre visibilité IA.
Agir, dans le cadre validé
- Réécrire un titre Google ou une description.
- Ajouter un lien interne dans le vrai texte d'une page, quel que soit le constructeur.
- Remettre à jour une page, ajouter une FAQ ou des données structurées.
- Écrire un brouillon d'article, créer une redirection, réparer un lien cassé.
- Annuler une modification.
Après une mise à jour de l'extension, Claude peut ne pas voir les nouveaux outils. Dans Claude : Personnaliser, Connecteurs, Hack The SEO, Reconnecter. Puis ouvrez une nouvelle conversation et écrivez On continue mon SEO.
Titres et descriptions
Le titre et la description sont ce que Google affiche dans ses résultats. Hack The SEO les gère page par page, avec un aperçu du rendu Google.
- Page par page : dans l'éditeur WordPress, le bloc Hack The SEO sous le contenu, avec un compteur de caractères.
- Pour tout le site : Réglages, onglet SEO, pour le titre de l'accueil, le format des titres et le séparateur.
- Avec Claude : il repère les titres trop longs, absents ou en double, et propose une réécriture que vous validez.
Repères : un titre de 50 à 60 caractères, une description de 120 à 160 caractères.
Données structurées (schema JSON-LD)
Les données structurées sont un code invisible qui décrit la page à Google et aux IA : article, FAQ, fil d'Ariane, produit, auteur. Elles permettent les résultats enrichis et aident les IA à comprendre qui vous êtes.
- Détectées et servies automatiquement selon le contenu : Article, FAQ, HowTo, Video, Speakable, BreadcrumbList, Organization, Product.
- L'auteur (schéma Person) compte pour la confiance : un vrai nom plutôt que « admin ».
- Claude peut auditer les données structurées de tout le site et ajouter celles qui manquent.
Pour vérifier une page : le test des résultats enrichis de Google, search.google.com/test/rich-results.
Sitemap XML et robots.txt
- Sitemap : servi à l'adresse
/sitemap.xml, mis à jour à chaque publication. Le sitemap natif de WordPress est coupé pour éviter les doublons. - Pages exclues : une page en noindex n'entre pas dans le sitemap.
- robots.txt : un fichier optimisé est servi par défaut et se modifie dans Réglages, onglet SEO.
Un vrai fichier robots.txt posé sur le serveur passe avant celui de l'extension. Ne bloquez jamais tout le site avec Disallow: /.
Redirections et erreurs 404
Une redirection envoie l'ancienne adresse d'une page vers la nouvelle, pour ne perdre ni visiteurs ni positions.
- Créer : Redirections, une adresse de départ, une adresse d'arrivée, et le type : 301 (définitive, le bon choix dans la plupart des cas), 302, 307 ou 410 (page supprimée).
- Les 404 : les adresses introuvables visitées sont relevées, avec la destination la plus proche proposée.
- Avec Claude : il vérifie les chaînes et les boucles de redirections, crée une redirection et répare les liens internes cassés.
Canonique
La balise canonique dit à Google quelle est l'adresse officielle d'un contenu visible à plusieurs adresses. Par défaut, chaque page pointe vers elle-même. Pour pointer une page vers une autre (un contenu republié, deux pages très proches), remplissez le champ canonique du bloc Hack The SEO dans l'éditeur.
Groupes de contenus (cocons sémantiques)
Un groupe de contenus, ou cocon sémantique, réunit les pages d'un même sujet autour d'une page pilier, reliées entre elles. C'est ce qui montre à Google et aux IA que vous êtes une référence sur ce sujet.
| Rôle | Définition |
|---|---|
| Pilier | La page principale du groupe, celle qui doit se classer. Une seule par groupe. |
| Article du groupe | Une page sur le même sujet, rattachée au pilier. |
| Page orpheline | Une page qui ne reçoit aucun lien interne : à relier en priorité. |
- L'extension compare le sens des pages, pas seulement leurs catégories : une page trop éloignée du sujet n'entre pas dans le groupe.
- Une langue par groupe : sur un site multilingue, chaque langue a ses groupes.
- Sur une boutique, le pilier est une catégorie de produits, jamais un produit seul.
Maillage interne
Les liens internes aident Google à trouver vos pages, à comprendre leur sujet et à répartir l'autorité. Hack The SEO propose des liens précis : la page de départ, la page d'arrivée, le texte du lien et le paragraphe où il va.
- Le lien est posé dans le vrai texte de la page, pas dans un widget, que la page soit faite avec Gutenberg, Elementor ou un autre constructeur.
- Un budget de liens limite le nombre de liens ajoutés, pour rester naturel.
- Une page en noindex, redirigée ou retirée ne reçoit plus de lien.
- Chaque lien posé s'annule pendant 30 jours.
Pages en concurrence (cannibalisation)
Quand deux de vos pages visent la même recherche Google, elles se gênent et aucune ne se classe bien. L'écran Pages en concurrence montre ces paires, la recherche partagée et la position de chaque page.
| Solution | Quand l'utiliser |
|---|---|
| Fusionner | Les deux pages disent la même chose : on garde le meilleur des deux dans une seule, et on redirige l'autre. |
| Différencier | Les deux pages sont utiles : on change leurs titres et leur angle pour viser deux recherches différentes. |
| Rediriger | Une page est nettement moins bonne : redirection 301 vers la meilleure. |
| Canonique | Les deux pages restent visibles, une seule est indexée. |
Articles et fraîcheur
Hack The SEO n'est pas un générateur d'articles. Claude retravaille d'abord les pages qui comptent, remet à jour les anciens contenus, puis écrit des articles neufs seulement quand votre plan en a besoin.
- Un article arrive toujours en brouillon. Il n'est jamais publié sans votre validation, et un seul brouillon peut être publié par jour.
- L'article tient compte de son groupe de contenus : il vise un sujet qui manque et se relie au pilier.
- La fraîcheur compte : un contenu mis à jour dans les 90 derniers jours est considéré comme frais. Claude repère les pages qui vieillissent et propose de les rafraîchir.
Images et textes alternatifs
Le texte alternatif décrit une image à Google, aux IA et aux personnes malvoyantes. Hack The SEO repère les images sans texte alternatif et en propose un, descriptif, qui reprend le sujet de la page sans bourrage de mots-clés.
Exemple : « Plombier réparant une fuite sous un évier » plutôt que « plombier lyon plombier pas cher ».
Le score GEO
Le score GEO, de 0 à 100, mesure à quel point une page est facile à citer pour une IA (ChatGPT, Claude, Perplexity, Gemini, les AI Overviews de Google). Pour un article, il repose sur 12 critères pondérés. Pour chaque critère faible, l'extension donne la correction à faire.
| Critère | Poids | Ce qui est vérifié |
|---|---|---|
| FAQ et listes | Fort | Questions-réponses, listes, blocs dépliables : les IA aiment les extraire. |
| Réponse directe en introduction | Fort | Un premier paragraphe court et direct, avec le sujet dès les premiers mots. |
| Chiffres et données | Fort | Des chiffres, des pourcentages, des montants. |
| Intertitres | Fort | Des titres H2 et H3 clairs. |
| Sources citées | Moyen | Des liens vers des sources qui font autorité. |
| Longueur | Moyen | Assez de profondeur pour couvrir le sujet. |
| Liens internes | Moyen | Quelques liens vers des pages proches. |
| Images décrites | Moyen | Des images avec un texte alternatif. |
| Titre et description | Base | Aux bonnes longueurs. |
| Fraîcheur | Base | Une mise à jour dans les 90 derniers jours. |
| Données structurées | Base | Un schéma JSON-LD détecté. |
| Auteur identifié | Base | Un vrai auteur, pas « admin ». |
Les catégories et les fiches produits ont leurs propres critères (texte d'introduction, description du produit, prix et disponibilité, avis…). Le score GEO est un indicateur, pas une garantie d'être cité.
llms.txt, llms-full.txt et pages .md
Trois fichiers servis automatiquement pour donner aux IA une version propre et structurée de votre site.
| Fichier | Contenu |
|---|---|
/llms.txt | Le plan de votre site pour les IA : piliers, pages clés, derniers articles, ressources. |
/llms-full.txt | La version longue, avec le contenu complet des pages piliers. |
/ma-page.md | La version texte propre de chaque page : ajoutez .md à son adresse. Servie en noindex pour ne pas gêner Google. |
Ces fichiers sont virtuels : l'extension les fabrique, les garde en cache et les refait à chaque publication. Le standard de référence est décrit sur llmstxt.org.
Les robots d'IA
Avant de vous citer, une IA doit lire votre site. L'extension reconnaît les robots d'IA qui passent, et enregistre la page visitée et l'heure dans votre propre base de données. Aucun service extérieur n'est appelé pour cela.
Les robots classiques (Googlebot, Bingbot, outils SEO) sont comptés à part. Les visiteurs humains qui arrivent depuis une IA (chatgpt.com, claude.ai, perplexity.ai…) sont repérés grâce à l'adresse d'origine, quand la plateforme la transmet : un total à zéro peut simplement vouloir dire qu'elle la cache.
Visibilité IA (AVA)
AVA mesure si les IA citent votre site quand on leur pose les questions de votre métier, et qui est cité à votre place. Claude s'en sert pour savoir quoi écrire et quelle page renforcer. AVA Solo est offert avec l'offre à 249 €. L'écran Visibilité IA apparaît dans le menu dès que la mesure est allumée.
En savoir plus : la page AVA.
Google Search Console
La Search Console donne les chiffres officiels de Google : les recherches qui vous trouvent, les clics, les affichages, les positions. Reliée à Hack The SEO, elle nourrit le plan de Claude et l'écran Statistiques.
- Relier : à l'étape Google de l'écran Démarrer (bouton Relier avec Google), ou plus tard dans Réglages, onglet Connexions. Hack The SEO ne fait que lire.
- Historique : jusqu'à 13 mois de chiffres sont importés.
- Le bon site : choisissez le compte Google qui voit votre Search Console, et la bonne adresse (avec ou sans www, en https).
Boutiques WooCommerce
Sur une boutique WooCommerce, Hack The SEO traite les fiches produits et les catégories comme des pages à part entière.
- Les groupes de contenus partent des catégories de produits ; les produits s'y rattachent.
- Les données structurées Product : prix, disponibilité, avis.
- Un score GEO adapté aux fiches produits et aux catégories.
- Claude peut auditer la boutique, améliorer une fiche produit et proposer des liens entre produits, catégories et articles.
Compatibilité
| Élément | Compatibilité |
|---|---|
| WordPress | 5.9 minimum, testé jusqu'à 6.9.4 |
| PHP | 7.4 minimum |
| Constructeurs de pages | Gutenberg, Elementor, Divi, Bricks, Oxygen |
| Boutique | WooCommerce |
| Multilingue | Polylang, WPML (une langue par groupe de contenus) |
| Connexion de Claude | Le site doit être en https |
| Autre extension SEO | Yoast, Rank Math, SEOPress ou AIOSEO : vos titres et descriptions sont repris, sans toucher aux données de l'ancienne extension |
Questions fréquentes
Faut-il un compte Claude ?
Oui. Hack The SEO travaille avec Claude, qui se branche à votre site. La version gratuite de Claude suffit pour commencer : vous écrivez alors On continue mon SEO. chaque matin du lundi au vendredi. Avec un abonnement payant, Claude passe seul grâce à une tâche planifiée.
Claude peut-il casser mon site ?
Claude ne modifie rien sans votre validation, et seulement par les outils de l'extension. Chaque modification est tracée et s'annule pendant 30 jours. Avant la première modification, 12 essais sont faits sur une copie cachée, et une sauvegarde de moins de 7 jours est exigée.
Que se passe-t-il si je ne valide pas la semaine ?
Rien n'est modifié sur votre site sans votre clic. La semaine attend votre validation dans Votre plan.
Hack The SEO remplace-t-il Yoast ou Rank Math ?
Il fait tout ce que font ces extensions (titres, descriptions, sitemap, données structurées, redirections, fil d'Ariane) et ajoute le moteur sémantique, le GEO et le travail avec Claude. Il reprend vos titres et descriptions de Yoast, Rank Math, SEOPress ou AIOSEO sans toucher à leurs données.
Est-ce compatible avec Elementor, Divi ou WooCommerce ?
Oui. Les liens et les corrections sont posés dans le vrai contenu des pages, quel que soit le constructeur, et les boutiques WooCommerce ont leurs propres outils.
Au bout de combien de temps voit-on des résultats ?
Le plan est fait pour 90 jours. Google réagit en général en quelques semaines sur les recherches peu disputées, et plus lentement sur les recherches très concurrentielles. Claude mesure chaque modification et vous le dit dans ses comptes rendus.
Quelle différence avec l'extension gratuite ?
Ce sont deux extensions différentes. L'extension gratuite de wordpress.org fait le SEO technique. L'extension de l'abonnement ajoute le travail avec Claude, le moteur sémantique et les modifications annulables. Quand elle est active, l'extension gratuite se met en veille toute seule.
Glossaire
- SEO
- Tout ce qui aide une page à monter dans Google.
- GEO
- Tout ce qui aide une page à être citée par les IA (ChatGPT, Claude, Perplexity, Gemini).
- Groupe de contenus
- Les pages d'un même sujet reliées autour d'une page pilier. On dit aussi cocon sémantique.
- Pilier
- La page principale d'un groupe de contenus.
- Page orpheline
- Une page qui ne reçoit aucun lien interne.
- Cannibalisation
- Deux pages qui visent la même recherche et se gênent.
- Canonique
- La balise qui indique l'adresse officielle d'un contenu.
- Données structurées
- Un code invisible (JSON-LD) qui décrit la page à Google et aux IA.
- Score GEO
- Une note de 0 à 100 : la page est-elle facile à citer pour une IA ?
- llms.txt
- Un fichier qui présente votre site aux IA.
- MCP
- Model Context Protocol : le standard qui branche Claude à l'extension.
- Passage du matin
- La visite de Claude sur votre site, du lundi au vendredi, avec une action à chaque fois.
Voir ce que Claude ferait sur votre site
20 minutes avec Eric : on branche Claude à votre WordPress et on regarde ensemble ce qu'il ferait cette semaine.