Claude SEOSearch Engine Optimization. Ensemble des techniques visant à améliorer le positionnement d'un site web dans les résultats naturels des moteurs de recherche. désigne surtout claude-seo, un plugin open source sous licence MIT pour Claude Code, l'agent en ligne de commande d'Anthropic. Il ajoute 26 sub-skills et 19 agents spécialisés qui auditent une URLUniform Resource Locator. Adresse unique d'une page web. Une URL optimisée est courte, descriptive et contient le mot-clé. en technique, contenu, données structuréesCode ajouté au HTML pour aider les moteurs à comprendre le contenu et générer des rich snippets. et GEOGenerative Engine Optimization. Optimisation pour apparaître dans les réponses des IA génératives., via des commandes /seo. Le plugin est gratuit ; le modèle qui le fait tourner est payant.
Ce que fait claude-seo, commande par commande
claude-seo est un paquet d'instructions et d'agents que Claude Code charge pour auditer un site. Son orchestrateur détecte le type de site (SaaS, local, e-commerce, éditeur, agence), puis répartit le travail entre ses agents. Sur un audit complet, jusqu'à 17 agents tournent en parallèle, et chaque recommandation sort avec la façon de vérifier qu'elle a échoué. C'est un outil d'analyse qui travaille depuis votre machine, dans une autre catégorie qu'Ahrefs, Semrush ou un crawler du marché.
Les commandes que vous utiliserez vraiment :
/seo audit <url>: l'audit complet, délégué aux agents en parallèle, qui produit un plan d'action priorisé ;/seo page <url>: l'analyse détaillée d'une seule page (balises, contenu, schema) ;/seo technical <url>: l'audit technique, réparti en 9 catégories ;/seo schema <url>: détecte, valide et génère le balisage Schema.orgVocabulaire standardisé de balisage structuré reconnu par Google, Bing et Yahoo. ;/seo geo <url>: la préparation aux AI Overviews et aux moteurs génératifs ;/seo content <url>: la qualité du contenu au regard de l'E-E-A-TExperience, Expertise, Authoritativeness, Trustworthiness. Critères de qualité évalués par Google. ;/seo agentic <url>: l'accès des agents IA à la page, le llms.txt et la lecture par les navigateurs agentiques ;/seo setupet/seo doctor: installent puis contrôlent l'environnement Python du plugin.
Le README en recense 34 au total, dont celles des extensions (SE RankingPosition d'une page web dans les résultats de recherche pour une requête donnée., Bing Webmaster, Unlighthouse et d'autres). Les rapports sortent en fichiers markdown dans votre dossier, avec un PDF en option.
Sans clé d'API, le plugin ne contacte aucun service tiers, seulement les URL que vous lui donnez. La contrepartie est écrite noir sur blanc dans sa documentation : sans identifiants Google, les Core Web VitalsMétriques de Google mesurant l'expérience utilisateur : LCP (chargement), INP (interactivité), CLS (stabilité visuelle). sont des estimations de laboratoire et l'indexationProcessus par lequel Google ajoute une page à sa base de données pour qu'elle puisse apparaître dans les résultats. est déduite des signaux de la page. Une simple clé d'API Google débloque PageSpeed InsightsOutil Google analysant la performance d'une page et fournissant des recommandations d'optimisation. et les données CrUX ; Search ConsoleOutil gratuit Google pour surveiller et optimiser la présence d'un site dans les résultats de recherche., GA4Outil gratuit Google pour analyser le trafic et le comportement des visiteurs d'un site. et le Planificateur de mots clés demandent des accès supplémentaires.

Claude, Claude Code, skill, MCP : trier le vocabulaire
Ces mots reviennent dans tous les tutoriels, et chacun désigne une couche différente. Claude est le modèle. Claude Code est le client qui lui donne accès à votre système de fichiers, à votre terminal et à git. claude-seo est un plugin tiers qui charge un paquet d'instructions SEO dans ce client. Vous pouvez faire du SEO avec Claude seul dans le navigateur, mais vous perdez l'accès au repo, donc l'essentiel.
Skill et sub-skill
Le format est simple : un dossier, un fichier. Une skill est un dossier qui contient un SKILL.md, des instructions en markdown précédées d'un en-tête qui dit à Claude quand s'en servir. Claude la charge seul quand votre demande correspond à sa description, ou vous l'appelez par son nom. Une sub-skill est une skill appelée par une autre, pour découper un gros process en morceaux plus étroits : un domaine, ou une seule décision.
Serveur MCP
Un serveur MCP (Model Context Protocol, un standard ouvert) est une connexion. Il branche Claude sur un outil, une base de données ou une API. DataForSEO en MCP vous donne des volumes et des SERPSearch Engine Results Page. Page affichée par un moteur de recherche en réponse à une requête utilisateur. réelles, Firecrawl du rendu de page ; les deux existent en extension de claude-seo. Sans MCP, Claude raisonne sur ce qu'il a sous la main, et sur le reste il devine.
Plugin et agent
Un plugin regroupe des skills, des agents, des hooks et des serveurs MCP que Claude Code installe et charge d'un bloc. Un agent est une instance de Claude à qui on confie un périmètre et qu'on peut lancer en parallèle d'autres agents. C'est ce parallélisme qui permet à un audit claude-seo de couvrir beaucoup de terrain en une passe.

Installer claude-seo et sortir un premier audit exploitable
L'installation prend trois commandes dans Claude Code, plus un environnement Python que le plugin prépare lui-même.
Les prérequis
Il vous faut Claude Code et un compte qui y donne accès : abonnement Pro, Max, Team ou Enterprise, ou compte Console facturé à l'usage. Le plan gratuit de claude.ai n'inclut pas Claude Code.
Anthropic recommande son installateur natif ; le paquet npm reste possible et demande Node.js 22 ou plus. Côté plugin, comptez Python 3.10 ou plus récent, et préférez la version 3.11 pour une nouvelle installation : le README prévient que la 3.10 arrive en fin de vie en octobre 2026. Git aussi : l'installation manuelle l'exige, et vous voudrez relire les modifications avant de commit.
L'installation par le marketplace
Dans une session Claude Code (version 1.0.33 ou plus récente), ajoutez le dépôt comme source de plugins, installez, puis lancez la préparation. Le suffixe compte :
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup
Le suffixe @agricidaniel-claude-seo est le nom sous lequel le marketplace s'enregistre : Claude Code installe un plugin sous la forme <plugin>@<marketplace>.
La commande /seo setup crée un environnement Python isolé dans les données du plugin et installe Chromium pour Playwright, qui sert au rendu des pages en JavaScriptLangage de programmation web. Son mauvais usage peut bloquer l'indexation par les moteurs de recherche.. La commande /seo doctor vérifie ensuite que tout est prêt, sans rien modifier. Le README du dépôt fait foi si les noms bougent : le projet a publié 29 versions sur GitHub entre février et octobre 2026, la dernière (2.4.2) le 4 octobre.
L'installation manuelle depuis GitHub
Pour relire le script avant de l'exécuter, clonez le dépôt puis lancez-le :
git clone --depth 1 httpsProtocole sécurisé de transfert de données. Facteur de ranking depuis 2014.://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh
Le script télécharge la version épinglée (2.4.2 aujourd'hui), copie les skills dans ~/.claude/skills et les agents dans ~/.claude/agents, puis prépare l'environnement Python. Sous Windows, le dépôt fournit install.ps1, à lancer depuis PowerShell après le même git clone. Une skill placée dans ~/.claude/skills sert dans tous vos projets. Placée dans .claude/skills à la racine d'un projet, elle ne vaut que pour ce projet et se versionne avec lui. Pour vos propres skills d'équipe, prenez la seconde option.
Lancez l'audit depuis la racine du repo
/seo audit prend une URL. Lancé depuis un dossier vide, il produit un rapport proche de ce que donne un outil d'audit en ligne, sans accès au code qui fabrique les défauts. Ouvrez plutôt Claude Code à la racine du projet, lancez /seo page sur une URL qui représente un template, puis demandez à Claude de croiser le résultat avec le code :
Reprends les écarts trouvés par /seo page sur https://www.exemple.fr/produit/chaise-oslo.
Pour chacun, trouve dans src/pages/produit/[slugPartie de l'URL identifiant une page spécifique, généralement après le nom de domaine.].astro la ligne qui le produit.
Compare avec le HTML servi sur 5 autres URL produit (curl -s).
Liste uniquement les écarts présents sur toutes les URL, avec fichier et numéro de ligne.
Cette formulation force la preuve : Claude doit citer un fichier, une ligne, un extrait de HTML.
Lire le rapport sans se faire avoir
Le score global sur 100 sert à situer le site d'un audit à l'autre ; pour décider quoi corriger, triez les findings un par un.
Un finding qui touche un template partagé se corrige tout de suite : il se multiplie par le nombre d'URL qui utilisent ce template, c'est le meilleur ratio effort/impact d'un audit. Un finding sur une URL isolée part en ticket, sans urgence. Un finding formulé sans seuil, du type « améliorez la profondeur sémantique », se jette : il n'y a rien à exécuter derrière.
Le cas le plus risqué est ailleurs : un finding sur une URL que la session n'a jamais récupérée. Dès que vous sortez des commandes du plugin pour poser une question libre, Claude peut produire une analyse plausible sur une page qu'il n'a pas vue. Le contrôle est simple, vous demandez le code HTTP et un extrait du HTML pour chaque URL citée. Pas de preuve, pas de finding.

Claude contre le crawler : qui fait quoi
Un crawler fait l'inventaire, Claude Code fait le correctif. Le README de claude-seo le dit lui-même : Screaming FrogLogiciel de crawl permettant d'auditer techniquement un site web. explore plus profond et plus vite le graphe de liens, et le plugin ne cherche pas à le remplacer.
| Tâche | Claude Code + claude-seo | Crawler | Plateforme SEO |
|---|---|---|---|
| Explorer 500Code HTTP indiquant une erreur côté serveur. Impacte négativement le crawl et l'expérience utilisateur. 000 URL | non | oui | oui |
| Volumes de recherche et SERP fiables | via MCP ou extension | non | oui |
| Trouver la cause d'un défaut dans le code | oui | non | non |
| Corriger le template et livrer un diff | oui | non | non |
| Réécrire 3 000 metas au format maison | oui, via l'API | en partie, avec votre clé d'IA | en partie |
Les lignes 3 et 4 sont nouvelles, et la dernière passe par l'API. Pour explorer un site et mesurer des volumes, votre stack d'outils SEO fait mieux et moins cher. Demander à Claude de jouer le crawler, c'est payer des tokens pour un travail qu'un outil dédié fait déjà.

Et face à ChatGPT ou Gemini ?
L'écart qui compte se joue entre un chat dans un navigateur et un agent qui a accès à vos fichiers, à votre terminal et à vos API. OpenAIAgent conversationnel d'OpenAI utilisant un LLM pour générer des réponses. (Codex CLI) et Google (GeminiIA multimodale de Google, intégrée progressivement à ses produits dont la recherche. CLI) ont aussi leur agent en terminal : le choix se fait entre agents. claude-seo tourne dans Claude Code, et son auteur en publie un portage pour Codex, Codex SEO.
Un modèle un peu moins bon avec un accès au repo fait plus de travail utile qu'un modèle un peu meilleur enfermé dans une fenêtre. Gemini a un avantage quand vous travaillez déjà dans l'écosystème Google, par exemple pour croiser Search Console et BigQuery. Pour le SEO technique, le critère de choix reste l'accès au code, puis le modèle.
Encoder votre méthode dans une sub-skill plutôt que dans un long prompt
Un bon prompt SEO est une méthode qui n'existe que dans votre presse-papier. Trois semaines plus tard, personne ne sait laquelle des cinq versions était la bonne. Une skill, c'est le même prompt, versionné dans le repo, déclenché quand le contexte correspond, relançable telle quelle par n'importe qui. claude-seo vous donne la méthode de son auteur ; vos propres skills encodent la vôtre.
L'anatomie d'un SKILL.md
Cinq blocs suffisent : l'en-tête, les entrées attendues, les seuils, les décisions qu'ils déclenchent, le format de sortie.
---
name: audit-maillage-pdp
description: Audite le maillage interneEnsemble des liens entre les pages d'un même site. Distribue le jus SEO et guide les utilisateurs. des pages produit.
À utiliser quand on parle de liens internes, de profondeur
de clic, de pages orphelines ou de pages produit non maillées.
---
## Entrées
- export crawlProcessus par lequel les robots des moteurs de recherche parcourent et analysent les pages web. CSV : url, status, depth, inlinks, outlinks
- export GSC 16 mois : url, clics, impressionsNombre de fois qu'une page apparaît dans les résultats de recherche, qu'elle soit cliquée ou non., position
## Seuils
- depth > 4 depuis la home : à remonter
- inlinks < 3 : page sous-maillée
- inlinks = 0 et présente au sitemapFichier XML listant toutes les URLs d'un site pour faciliter leur découverte par les moteurs de recherche. : orpheline, priorité 1
- impressions > 500 et position entre 11 et 20 et inlinks < 5 :
candidat prioritaire au renforcement
## Décision
- orpheline + 0 impression sur 16 mois : sortir du sitemap
- orpheline + impressions : ajouter au bloc de maillage catégorie
- position 11-20 + sous-maillée : 3 liens contextuels depuis
les pages de la même catégorie qui rankent top 5
## Sortie
Tableau markdown trié par impressions décroissantes,
colonnes : url, depth, inlinks, décision, action, effort.
Aucune ligne sans décision.
Le champ description sert de clé de routage : d'après la documentation de Claude Code, c'est lui que Claude lit pour décider de charger la skill. Écrivez-le pour le routage : ce que fait la skill, puis quand s'en servir.
Si vous écrivez « analyse de liens » et que votre équipe dit « maillage », vous laissez la correspondance au hasard. Mettez-y le vocabulaire réel de vos tickets, formulations approximatives comprises, et le cas d'usage principal en premier : au-delà de 1 536 caractères, la description est tronquée dans la liste des skills.

Les seuils sont tout le travail
Une skill sans chiffres est un prompt déguisé. « Identifiez les pages sous-maillées » produit une réponse différente à chaque exécution. « inlinks < 3 » se vérifie et se discute : votre équipe peut contester le seuil, le passer à 5, versionner le changement. Un seuil se corrige, un adjectif se contourne.
Pour que la liste sorte identique à chaque passe, faites appliquer le seuil par un script (pandas, awk) que la skill lance. Lu par le modèle sur un export de plusieurs milliers de lignes, le même seuil peut laisser filer des lignes d'une exécution à l'autre.
Les seuils du fichier ci-dessus sont un exemple, pensé pour un catalogue de quelques milliers de références. Sur un site vitrine de quelques dizaines de pages, ils ne veulent rien dire. Les vôtres doivent sortir de vos données.
Une skill, une décision
Le réflexe naturel, c'est la skill qui fait tout : audit technique, contenu, netlinkingStratégie d'acquisition de backlinks de qualité pour renforcer l'autorité d'un site., GEO. Le contexte se remplit, le modèle noie les instructions importantes dans les secondaires, et vous ne savez plus quelle partie a raté.
Découpez par décision : une skill qui classe les orphelines, une autre qui valide un JSON-LDFormat recommandé par Google pour implémenter les données structurées dans le code source.. Chacune tient en quelques lignes de logique et se teste seule. claude-seo découpe déjà par domaine (technique, schema, GEO) en 26 sub-skills d'une centaine à plus de 400 lignes chacune ; pour votre propre méthode, descendez d'un cran, jusqu'à la décision.
La skill qui produit ce blog pousse la logique jusqu'au script : avant toute relecture, chaque article passe un linter de plus de cinquante règles bloquantes, chacune une décision qui se teste seule.
Contenu et GEO : ce que vous déléguez à Claude
Côté contenu, Claude fait gagner le plus de temps sur l'analyse et le contrôle, et le moins sur la thèse.
Du brief au plan
La chaîne utile commence à l'analyse d'intention. Donnez au modèle les dix premiers résultats bruts sur un mot-clé : il vous sort la structure H2 récurrente, le format dominant et ce que personne ne traite. Le plan se construit ensuite contre cette structure, en cherchant ce qu'elle oublie.
Puis vient la rédaction. Un texte généré à partir des dix premiers résultats les résume, et Google rappelle dans son guide sur l'IA générative qu'un résumé de contenus existants se contente de reformuler ce qui est déjà disponible ailleurs. Utilisez le modèle pour le plan, les données structurées, les metas, les variantes de titles. Gardez la thèse et les prises de position.
Ce que vous lui faites vérifier pour la GEO
Le trafic envoyé par les assistants d'IA reste marginal. D'après l'étude de SE Ranking sur 101 574 sites suivis dans GA4, les plateformes d'IA pèsent en moyenne 0,26 % du trafic internet en France sur les quatre premiers mois de 2026, quand la recherche organique y représente encore 52,76 %. Au niveau mondial, c'est 0,32 % contre 42,75 %. Personne ne devrait réallouer son budget là-dessus.
La tendance reste incertaine. En moyenne annuelle, la part française a gagné 29 % entre 2025 et 2026, mais elle recule depuis janvier : de 0,269 % à 0,241 % en avril, selon la même étude.
Google tranche dans son guide d'optimisation pour l'IA générative : les bonnes pratiques SEO restent valables et, pour la recherche Google, vous pouvez ignorer le « découpage » de contenu ou un fichier llms.txt. /seo geo suit la même ligne.
Les autres moteurs ont leur propre logique d'extraction. Demandez donc à Claude de rendre la page citable sans la réécrire pour les machines : repérer les affirmations qui perdent leur sens une fois isolées, vérifier que chaque chiffre porte sa source dans le corps du texte.
Faites-lui contrôler la cohérence entre le texte et ce que déclare le balisage schema.org : un prix affiché qui contredit le prix du JSON-LD coûte plus cher qu'un balisage manquant. Pour suivre ce que les assistants disent vraiment de votre marque, il faut une mesure dédiée, celle d'un accompagnement GEO ou d'un outil de suivi.

Données clients : ce qui part chez Anthropic
Le plugin est local, le modèle ne l'est pas. Les logs serveurFichiers enregistrant toutes les requêtes reçues par un serveur, permettant d'analyser le comportement des bots., les exports Search Console, les fichiers clients : tout ce que la session lit part sur les serveurs d'Anthropic.
La durée de conservation dépend du compte. Vérifiez le vôtre. En compte commercial (Team, Enterprise, API), c'est 30 jours en standard, sans entraînement des modèles. En compte Pro ou Max, c'est 30 jours si vous refusez l'usage de vos données pour l'entraînement, cinq ans si vous l'acceptez.
Pour un prestataire qui manipule les données d'un client, ça se règle dans le contrat et dans les réglages du compte. Anonymisez les exports avant de les donner à Claude, en particulier les fichiers de logs, qui contiennent des adresses IP : un sed ou un script de quelques lignes suffit.

Passer à l'API Claude quand le terminal ne suffit plus
Le terminal est bon jusqu'à l'échelle du template. Au-delà, quand vous devez traiter 5 000 fiches produit, utilisez l'API Claude dans un script : lecture du CSV, appel par lot, validation du format de sortie, écriture. Ne faites jamais confiance à la sortie brute.
Un contrôle programmatique sur la longueur, la présence du mot-clé, l'absence de doublon et le respect du gabarit écarte des lignes, plus ou moins selon la propreté de vos entrées. Ces lignes repassent en manuel. Sans ce filet, vous publiez des meta descriptions tronquées à l'échelle du catalogue.
Le coût se calcule au token, avant d'écrire la première ligne du script. Prenons 5 000 fiches, avec 1 500 tokens d'entrée par fiche (la consigne et les données produit) et 80 tokens de sortie pour la meta.
Avec Claude Sonnet 5.5, facturé 2 $ par million de tokens en entrée et 10 $ en sortie, les 7,5 millions de tokens d'entrée coûtent 15 $ et les 400 000 tokens de sortie 4 $. Total : 19 $ pour le catalogue. L'API Message Batches divise la facture par deux, soit 9,50 $, en échange d'un traitement asynchrone, terminé en général en moins d'une heure. Fixez une limite de dépense mensuelle dans la console dès le premier script.

Le partage des rôles tient en une ligne : claude-seo pour l'audit d'une URL, la session Claude Code dans le repo pour le correctif du template, l'API pour le catalogue. Commencez lundi par un /seo page sur votre template le plus rentable, puis écrivez votre première skill avec trois seuils que votre équipe peut contester.
Questions fréquentes
Claude SEO est-il gratuit ?
Le plugin claude-seo est gratuit et open source, sous licence MIT. Le moteur, lui, est payant : Claude Code demande un abonnement Pro, Max, Team ou Enterprise, ou un compte Console facturé à l'usage. Un audit complet consomme du quota : cinq de ses agents tournent sur Opus, deux fois plus cher que Sonnet en entrée (4 $ contre 2 $ par million de tokens), les autres sur Sonnet. Les extensions qui s'appuient sur des services payants (SE Ranking, DataForSEO) demandent aussi votre propre compte chez ces fournisseurs.
Comment installer claude-seo sans le marketplace ?
Clonez le dépôt avec git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git, puis lancez bash claude-seo/install.sh sous macOS ou Linux. Sous Windows, le même clone suivi du script install.ps1 dans PowerShell. Il vous faut Python 3.10 ou plus récent ; le script prépare aussi Chromium pour le rendu des pages en JavaScript.
claude-seo fonctionne-t-il sur un site Next.js ou React ?
Oui. Le plugin détecte les pages qui arrivent vides côté serveur et passe alors par un rendu headless avec Playwright. Son README signale une limite : le contenu chargé après un scroll ou un clic peut encore produire des findings bruités. Si votre site dépend du rendu côté client, vérifiez d'abord ce que Google reçoit sans JavaScript.
Quelle différence entre claude-seo et les skills SEO de SE Ranking ?
claude-seo analyse les pages elles-mêmes et fonctionne sans aucun compte tiers. Les skills publiées par SE Ranking sont conçues pour son serveur MCP, qui expose plus de 180 outils (mots-clésTerme ou expression que les utilisateurs saisissent dans un moteur de recherche. Base de toute stratégie SEO., backlinksLien provenant d'un site externe pointant vers votre site. Facteur de ranking majeur., audit de site, visibilité IA) : elles transforment ces données d'API en livrables. Les deux se combinent, et claude-seo propose d'ailleurs une extension SE Ranking.
Sources
- AgriciDaniel/claude-seo (README), GitHub
- marketplace.json du dépôt claude-seo, GitHub
- Discover and install plugins, Claude Code Docs
- Releases claude-seo, GitHub
- install.sh du dépôt claude-seo, GitHub
- Set up Claude Code, Claude Code Docs
- Extend Claude with skills, Claude Code Docs
- Connect Claude Code to tools via MCP, Claude Code Docs
- Plugins, Claude Code Docs
- Le trafic de l'IA en France en 2026, SE Ranking
- Guide Google pour optimiser les fonctionnalités d'IA générative dans la recherche Google, Google Search Central
- Data usage, Claude Code Docs
- Pricing, Claude Docs
- Batch processing, Claude Docs
- Rate limits, Claude Docs
- Skills SEO pour Claude, propulsés par SE Ranking
- seranking/seo-skills (README), GitHub
- openai/codex, GitHub
- google-gemini/gemini-cli, GitHub
- PRIVACY.md du dépôt claude-seo, GitHub
- Dossier skills du dépôt claude-seo, GitHub
- Screaming Frog SEO Spider Update, version 21.0

