Claude Code pour le SEO : du premier prompt à une équipe d'agents

Claude Code pour le SEO consiste à utiliser un agent IA qui lit les fichiers de votre site, les modifie, exécute des commandes et, via un connecteur MCP, lit vos données Search Console, Analytics et Google Business Profile. Commencez petit : un dossier sous git, une règle selon laquelle vous lisez chaque diff, et un accès aux données en lecture seule. Une fois cette boucle fiable, ajoutez des agents en parallèle, puis plusieurs sessions avec un pilote.

Certains appellent cela le « vibe coding SEO » ou le « vibe SEO » : décrire le résultat en mots simples et laisser l'IA écrire le code. C'est une étiquette informelle, pas un terme d'Anthropic ou de Google, et elle n'est sûre qu'avec les vérifications ci-dessous. Parmi les étiquettes voisines figurent « Claude SEO », « Claude Code SEO » et « MCP SEO ». Pour commencer tout de suite, connectez le connecteur ZeusSEO, inclus dans toutes les offres : le guide MCP de Google Business Profile décrit la configuration, et la section MCP ci-dessous ajoute les commandes de Claude Code. Si vous préférez lire à propos d'un expert prêt à l'emploi plutôt que de construire un flux de travail, il y a aussi Athena, l'expert SEO IA de ZeusSEO (en accès anticipé).

Ce qu'est Claude Code, et ce qu'il peut faire pour le SEO

Anthropic décrit Claude Code comme un outil de codage agentique qui lit votre base de code, modifie des fichiers, exécute des commandes et s'intègre à vos outils de développement. Il fonctionne dans un terminal, un IDE, une application de bureau et un navigateur, et la plupart des surfaces exigent un abonnement Claude ou un compte Anthropic Console.

Pour le SEO, une « base de code » désigne tout dossier de texte : modèles, articles en markdown, extraits schema, robots.txt, tables de redirections et exports CSV. Le « SEO avec Claude » consiste souvent à discuter dans une fenêtre ; Claude Code travaille dans un dossier de votre machine, il peut donc ouvrir des fichiers, les modifier et lancer des vérifications. Il ne voit pas Google tant que vous ne lui en donnez pas une vue, sous forme d'exports ou via un connecteur.

Outils recommandés et suggérés

Installez-le depuis la présentation officielle, comme outil de terminal, extension VS Code ou application de bureau. Toutes les surfaces utilisent le même moteur : vos fichiers CLAUDE.md, vos réglages et vos serveurs MCP vous suivent.

Un CLAUDE.md de départ pour un dossier client pourrait indiquer :

• Quels dossiers contiennent les modèles, le contenu et les exports.
• Ne jamais modifier robots.txt ni la table de redirections sans demander.
• Ne jamais inventer de faits, de prix, d'avis ou de statistiques.
• Proposer les modifications de Google Business Profile ; ne jamais les publier.

Git et dossiers locaux : votre bouton d'annulation

Donnez à chaque client un dossier pour les fichiers du site, les exports et les rapports, et lancez Claude Code depuis celui-ci. En mode Manual, il demande avant de lire ou d'écrire en dehors du dossier de lancement, comme l'explique la page de sécurité.

1. Utilisez git, même pour les exports. Pas de dépôt pour un site sur CMS ? Gardez les brouillons et les CSV dans un dossier et lancez git init.
2. Une branche par tâche, et validez avant chaque exécution.
3. Lisez git diff avant d'accepter. Claude Code peut valider à votre place, mais la relecture vous revient.

Cinq flux de travail SEO pour commencer

Utilisez un même flux de travail SEO IA reproductible pour les cinq tâches de Claude Code SEO : cadrer, récupérer les données, planifier, modifier les fichiers sur une branche, lancer une vérification, lire le diff, valider. Les bonnes pratiques d'Anthropic recommandent de planifier avant de coder et de donner à Claude une vérification exécutable, pour qu'il itère jusqu'à ce qu'elle passe.

1. Audit technique des fichiers d'un site

Demandez à Claude de lire les modèles, robots.txt et la configuration du sitemap en mode plan, et de lister les constats par fichier et par ligne. Google indique que robots.txt n'est pas un moyen de garder une page hors de Google : signalez donc tout Disallow utilisé pour cela. Notre guide de l'audit SEO technique couvre le côté en ligne.

2. Rédiger et vérifier le schema

L'introduction aux données structurées de Google recommande JSON-LD dans la plupart des cas et précise que le balisage doit décrire un contenu visible par les utilisateurs. Faites rédiger un brouillon par modèle à Claude, puis validez-le vous-même.

3. Corrections on-page en masse dans un dépôt

Donnez à Claude un CSV d'URL et de nouveaux titres et laissez-le modifier les fichiers correspondants. Testez d'abord sur quelques-uns, puis utilisez /batch, qui répartit une modification entre 5 et 30 sous-agents travaillant chacun dans leur propre worktree.

4. Tableurs de regroupement de mots-clés

Exportez les requêtes dans un CSV et demandez à Claude d'écrire et d'exécuter un script qui les regroupe par thème et propose une page pour chaque groupe.

5. Préparation de rapports

Récupérez les chiffres via le connecteur et demandez un court commentaire par client. Voir notre guide du rapport de positionnement SEO pour le contenu d'un rapport client.

MCP : connecter ZeusSEO à Claude Code

MCP, le Model Context Protocol, est une norme ouverte pour connecter des outils d'IA à des sources de données externes, et Claude Code prend en charge les serveurs MCP distants via HTTP. Le MCP pour le SEO signifie que votre agent lit les données clients en direct plutôt qu'un export collé. Le connecteur ZeusSEO a une seule URL et plus de 100 outils.

1. Ajoutez le serveur dans un terminal, pas dans une session :

2. Vérifiez-le. claude mcp list affiche « Needs authentication » tant que vous ne vous êtes pas connecté, comme le décrit le démarrage rapide MCP.
3. Connectez-vous. Lancez claude, tapez /mcp, choisissez zeuseo et sélectionnez Authenticate. Votre navigateur s'ouvre sur l'étape de connexion décrite dans le guide MCP de Google Business Profile.

Ajoutez --scope user pour l'utiliser dans tous les projets. Si vous avez ajouté le connecteur dans Claude et utilisez ce même compte pour Claude Code, la documentation MCP indique que les connecteurs Claude se chargent automatiquement, sauf si une clé API sert de connexion. Notre connexion est un flux OAuth standard avec PKCE qui accepte l'adresse de rappel locale de Claude Code.

Lire vos propres données ne coûte aucun Stater, les crédits d'usage prépayés de ZeusSEO. Quelques outils nommés qui appellent nos fournisseurs payants ou l'IA, comme la recherche de mots-clés et l'analyse des concurrents dans les SERP, en consomment, et l'assistant reçoit pour consigne de vous prévenir d'abord. Ses instructions précisent aussi de confirmer le contenu et les cibles avant toute publication, modification, suppression ou réponse, et un accès en lecture seule est refusé en écriture. Un essai gratuit est soumis à un plafond d'usage raisonnable de 100 appels d'API. Voir Staters et crédits IA, les tarifs, et les guides MCP de Search Console et d'Analytics.

Usage des API : clés, coûts et scripts

Vous vous connectez avec un abonnement Claude ou un compte Anthropic Console. La page des coûts indique que le montant en dollars affiché par /usage est une estimation locale et que l'usage des abonnés est inclus dans leur offre.

Pour les scripts, claude -p exécute un prompt sans session interactive et accepte une entrée redirigée, un schéma tiré de la présentation :

En mode --bare, Claude Code n'utilise pas votre connexion d'abonnement : définissez donc ANTHROPIC_API_KEY, comme l'explique la page sur l'usage programmatique. Si Claude écrit des scripts qui appellent une API de données, gardez la clé dans une variable d'environnement et ajoutez la règle de refus Read(./.env). Pour les données Google, le connecteur vous évite l'attente de validation de votre propre projet d'API ; voir API Google ou MCP.

Permissions et hooks : posez les garde-fous une fois pour toutes

Les instructions d'un prompt ou de CLAUDE.md orientent ce que Claude tente, mais les règles de permission sont appliquées par Claude Code, pas par le modèle. Les règles sont vérifiées dans l'ordre : refuser, puis demander, puis autoriser. Les modes de permission ci-dessous déterminent la fréquence des demandes de Claude. Avec Claude Code 2.1.283 ou plus récent, le mode auto est le mode de départ intégré des sessions interactives du terminal et de VS Code : pour le travail client, appuyez donc sur Shift+Tab pour atteindre le mode Manual, ou démarrez avec claude --permission-mode default.

• Autorisez les outils de lecture : mcp__zeuseo__gsc_*, mcp__zeuseo__ga4_* et mcp__zeuseo__argus_*. Le préfixe zeuseo est le nom de serveur que vous avez choisi en l'ajoutant.
• Gardez les outils d'écriture hors des règles d'autorisation, pour que le mode Manual demande à chaque fois. En mode auto, un classificateur examine l'appel à la place : ajoutez donc une règle « demander » dans /permissions si vous voulez une confirmation dans tous les cas.
• Refusez les secrets : Read(./.env).
• Blocages stricts : un hook PreToolUse qui se termine avec le code 2 empêche les modifications des fichiers protégés. Le guide des hooks indique que les hooks sont déterministes, contrairement à CLAUDE.md.

Agents IA pour le SEO : sous-agents en parallèle

Un sous-agent s'exécute dans sa propre fenêtre de contexte avec un prompt personnalisé, des outils précis et des permissions indépendantes, puis renvoie un résumé. Définissez-en un sous forme de fichier markdown dans .claude/agents/, par exemple un relecteur de schema limité à Read, Grep et Glob pour qu'il ne puisse pas modifier. Anthropic liste plusieurs façons d'exécuter des agents en parallèle, dont :

Un agent qui joue le rôle de pilote

La présentation décrit un agent pilote qui coordonne le travail, attribue les sous-tâches et fusionne les résultats. Les sous-agents ne rendent compte qu'à la conversation qui les a lancés : cette conversation est donc votre interlocuteur unique.

1. Briefez le pilote : « Utilise des sous-agents en lecture seule pour auditer /product, /locations et /blog en parallèle. Rends compte par fichier et par ligne. »
2. Fusionnez et modifiez : le pilote supprime les doublons, classe par gravité et est le seul à modifier, pour que les exécutants ne puissent pas entrer en collision.
3. Relisez : lancez un relecteur indépendant, comme la skill intégrée /code-review, sur le diff.

Avancé : plusieurs sessions, un pilote, vous comme dernier filtre

C'est un schéma de travail construit à partir de fonctions documentées, pas un mode intégré. La documentation ne décrit un pilote intégré que pour les équipes d'agents, qui sont expérimentales et désactivées par défaut ; dans ce cas, les demandes de permission des coéquipiers remontent dans la session pilote, pour un coût en tokens plus élevé.

• Même logique : les fichiers CLAUDE.md du projet et les réglages de permission peuvent être partagés via le contrôle de version.
• Fichiers séparés : claude --worktree schema-fixes démarre une session sur sa propre branche sous .claude/worktrees/ ; la documentation des worktrees suggère d'ajouter ce dossier à .gitignore.
• Messages : la messagerie entre sessions permet à Claude de lister vos autres sessions et de leur envoyer du texte brut. Elle exige Claude Code 2.1.224 ou plus récent (2.1.234 sous Windows natif).

1. Validez les règles et répartissez par fichiers : chaque session démarre de la même façon, et aucune ne partage un fichier avec une autre.
2. Nommez les sessions avec --name ou /rename ; vérifiez-les avec /list-agents, ou mentionnez-en une avec @name.
3. Le pilote attribue par message ; les exécutants valident et renvoient un résumé par message.
4. Le pilote relit chaque diff, lance les vérifications et rejette les modifications hors périmètre. Vous relisez sa courte liste.

Bonnes pratiques de sécurité et position de Google sur le contenu IA

• Lisez chaque diff. La page de sécurité d'Anthropic indique que vous êtes responsable de la relecture du code et des commandes proposés.
• Moindre privilège, aucun secret : autorisez les lectures, demandez pour les écritures, et ne mettez jamais de clés ni de mots de passe dans les prompts, CLAUDE.md ou la configuration validée.

Un ordre raisonnable pour tout adopter

1. Installez Claude Code, ouvrez un dossier client et lancez git init si nécessaire.
2. Rédigez un court CLAUDE.md, refusez Read(./.env) et passez en mode Manual pour les fichiers clients.
3. Lancez un audit en lecture seule en mode plan.
4. Connectez ZeusSEO et n'autorisez que les outils de lecture.
5. Effectuez une modification en masse sur une branche, avec une vérification.
6. Ajoutez un sous-agent relecteur en lecture seule, puis une deuxième session dans son propre worktree, puis un pilote nommé.

Vous gérez de nombreux établissements ? La même approche convient à nos guides sur plusieurs établissements, l'optimisation de fiche et les réponses aux avis. Votre prochaine étape est le guide MCP de Google Business Profile, qui connecte le connecteur ZeusSEO. Si vous préférez lire à propos d'un expert prêt à l'emploi plutôt que de construire le vôtre, il y a aussi Athena (en accès anticipé).