Utiliser Claude Code en SEO : de l’analyse de mots-clés à la publication contrôlée

Claude Code est l’agent d’Anthropic qui lit vos fichiers, les modifie et lance des commandes depuis votre terminal, votre éditeur ou son application de bureau. En SEO, il peut enchaîner tout le parcours d’une page : analyse de mots-clés, brief, rédaction à partir d’un gabarit, contrôle des balises et du maillage, données structurées, publication en brouillon via l’API du CMS, puis vérification en ligne.

La qualité du résultat dépend du contexte que vous lui donnez et des garde-fous que vous posez. Ce tutoriel détaille l’installation, le fichier CLAUDE.md, un workflow en cinq étapes enrichi de la méthode présentée par Paul Vengeons dans sa vidéo du 17 août 2026, puis les règles de sécurité à ne pas négocier.

01Claude Code : ce qu’il est et ce qu’il change pour le SEO

Un assistant conversationnel produit du texte que vous copiez ailleurs. Claude Code, lui, agit : il crée des fichiers, exécute des scripts, appelle des API et peut se connecter à vos outils. Pour un consultant ou un marketeur, c’est la différence entre obtenir un brouillon et obtenir une page prête à relire dans le CMS.

Un agent qui travaille dans vos fichiers et votre terminal

Selon la documentation officielle de Claude Code, l’outil lit un projet, modifie des fichiers, lance des commandes et s’intègre à vos outils de développement. Il existe en ligne de commande, en extension VS Code et JetBrains, en application de bureau et sur le web.

• Il lit vos exports (mots-clés, crawl, Search Console) directement dans le dossier du projet.
• Il écrit des scripts Python ou JavaScript pour traiter ces données, les exécute et corrige ses erreurs.
• Il se connecte à des services externes via le Model Context Protocol (MCP).
• Il demande votre autorisation avant les actions sensibles, selon le mode de permission choisi.

Claude Code, Claude dans le navigateur et les skills : les différences

Ces trois briques sont complémentaires, mais elles ne jouent pas le même rôle.

Claude Code peut utiliser Claude in Chrome (option –chrome) et des skills : ce sont des compléments, pas des alternatives. Pour créer les vôtres, voir le guide sur les skills Claude pour vos audits, briefs et reportings. Pour l’analyse de contenu dans l’application, voir le comparatif Claude SEO face à ChatGPT.

02Installer Claude Code et lui donner le contexte de votre site

L’installation prend quelques minutes. Le travail qui fait la différence vient ensuite : décrire votre site, vos règles et vos gabarits.

Installation et premiers réglages

1. Prenez un abonnement Claude (Pro, Max, Team ou Enterprise) ou un compte Anthropic Console.
2. Sur macOS, Linux ou WSL, lancez dans un terminal : curl -fsSL https://claude.ai/install.sh | bash. Sous Windows PowerShell : irm https://claude.ai/install.ps1 | iex. Une installation via Homebrew ou WinGet existe aussi.
3. Ouvrez un nouveau terminal, vérifiez avec claude --version, placez-vous dans le dossier du projet et tapez claude.
4. Si le terminal vous rebute, l’application de bureau inclut Claude Code (onglet Code) sans installation séparée.

Premier réglage utile : le mode plan. Avec Maj+Tab, Claude analyse et propose un plan sans modifier vos fichiers tant que vous ne l’avez pas validé. C’est le bon point de départ pour toute tâche nouvelle.

Connecter Claude Code à votre site et identifier le CMS

La vidéo de Paul Vengeons commence par cette étape : connecter Claude Code au site, puis lui envoyer un premier message de cadrage. Voici comment je la mets en pratique.

• Identifiez le CMS et les technologies du site avec l’extension Wappalyzer (WordPress, Shopify, Webflow, PrestaShop, constructeur de pages).
• Choisissez le canal de connexion : API REST du CMS, serveur MCP officiel quand il existe, ou à défaut Claude in Chrome sur le back-office.
• Rédigez un premier message qui présente le site, sa cible, ses offres, le CMS et l’objectif de la session.
• Joignez une capture d’écran d’une page modèle : Claude comprend plus vite la mise en page attendue qu’avec une description.
• Avancez par allers-retours courts : une demande, une vérification, une correction.

La vidéo suggère aussi de dicter ses consignes plutôt que de les taper. La dictée vocale de votre système fonctionne très bien pour des briefs longs et nuancés.

Le fichier CLAUDE.md : règles de marque, gabarits et conventions

Le fichier CLAUDE.md, placé à la racine du projet, est lu au début de chaque session. La documentation sur la mémoire de Claude Code recommande de rester sous 200 lignes et de lancer /init pour générer une première version. Elle précise aussi que ce fichier sert de contexte, pas de règle imposée : pour bloquer une action, il faut un hook ou une règle de permission.

# Site : exemple-site.fr (WordPress, Elementor)
Cible : PME B2B françaises. Vouvoiement, ton expert et mesuré.
Interdits : chiffres non sourcés, promesses de résultat, tiret cadratin.
Gabarits : templates/article.html, templates/page-service.html
Maillage : uniquement les URL de data/urls.txt, 3 à 8 liens par page.
Publication : toujours en brouillon, jamais en publié.
Contrôle : lancer scripts/check.py avant toute publication.

Ajoutez au fil de l’eau les erreurs constatées : une règle écrite après une correction évite qu’elle se reproduise.

Organiser le dossier projet : données, exports et modèles de pages

Une arborescence claire évite que l’agent mélange sources, brouillons et versions validées.

projet-seo/
  CLAUDE.md
  data/      exports mots-clés, crawl, Search Console, urls.txt
  briefs/    un fichier par page
  templates/ code source des gabarits
  drafts/    pages produites, non validées
  scripts/   contrôles et publication
  .env       identifiants, jamais versionné

03Du mot-clé à la page en ligne : le workflow SEO avec Claude Code

Le workflow ci-dessous reprend la structure en cinq étapes de ce tutoriel et y intègre les étapes de la vidéo, avec ma propre méthode quand je la complète.

1. Analyser les mots-clés et l’intention de recherche

La vidéo recommande de partir d’une stratégie de mots-clés avant d’écrire la moindre page, en utilisant la technique Google Suggest.

1. Tapez le mot-clé principal dans Google et relevez les suggestions de saisie semi-automatique, puis ajoutez des lettres ou des mots (« comment », « prix », « pour ») pour en obtenir d’autres.
2. Confiez la liste à Claude Code avec vos exports d’outil SEO : il regroupe les requêtes par intention et propose une page par groupe.
3. Vérifiez que chaque mot-clé est pertinent pour votre activité : un volume élevé sans lien avec votre offre ne sert à rien.
4. Déduisez l’arborescence recommandée : pages piliers, pages services ou catégories, puis articles qui les soutiennent.
5. Ciblez ensuite les mots-clés un par un, une page à la fois.

Pour chaque mot-clé, la vidéo propose une analyse manuelle de la SERP en vingt minutes. La mienne : classer les dix premiers résultats par type de page, relever les questions « Autres questions posées », ouvrir les trois premiers pour lister leurs H2 et ce qui manque, puis noter en une phrase le format attendu.

2. Produire le brief et la structure Hn

• Récupérez les mots-clés secondaires : requêtes sur lesquelles se classent les pages du top, questions associées, variantes longue traîne.
• Décidez s’il faut créer une page ou optimiser l’existante. Demandez à Claude de croiser la liste des URL du site et les données Search Console avant d’écrire quoi que ce soit.
• En e-commerce, commencez par les pages catégories : elles portent les requêtes commerciales les plus rentables, avant les articles de blog.
• Faites produire un brief normé : mot-clé, intention, title, meta, H1, structure Hn, pages à mailler, sources à vérifier.

Un brief bien construit est réutilisable par un rédacteur humain comme par l’agent. Le détail de la méthode est dans le guide de rédaction IA de qualité.

3. Rédiger la page à partir du gabarit

La vidéo décrit ce qu’est une bonne page : une vidéo, un auteur identifié, un quiz ou un outil interactif, un appel à l’action clair. Elle insiste aussi sur une écriture facile à parcourir, avec des sources, du maillage interne et une biographie de l’auteur.

• Fournissez le code source HTML d’une page modèle de votre site : Claude reproduit vos classes, vos blocs et votre structure au lieu d’inventer une mise en page.
• Exigez une réponse directe dès le premier paragraphe, des paragraphes courts, des listes et des tableaux.
• Faites citer les sources consultées, et vérifiez-les vous-même.
• Ajoutez l’encart auteur avec une biographie réelle, jamais générée.

La vidéo évoque trois façons de produire la page. Celles que je distingue dans ma pratique : Claude rédige section par section pendant que vous validez, Claude produit la page complète à partir du brief et du gabarit avant relecture, ou vous rédigez et Claude se charge de la mise en forme et des contrôles.

4. Contrôler balises, maillage interne et données structurées

C’est l’étape où Claude Code apporte le plus de fiabilité, parce qu’il peut écrire un script de contrôle et le relancer à chaque version.

• Title de 60 caractères environ, meta description, un seul H1, hiérarchie Hn sans saut.
• Liens internes : uniquement des URL existantes, pas de doublon, ancres descriptives.
• Données structurées en JSON-LD (Article, Product, BreadcrumbList selon le gabarit), cohérentes avec le texte visible.
• Caractères et formulations interdits par votre charte, nombre de mots minimum, balises autorisées.

5. Publier via l’API du CMS et vérifier la page en ligne

Sur WordPress, la publication passe par l’API REST avec un mot de passe d’application, disponible depuis WordPress 5.6, révocable à tout moment et à utiliser uniquement en HTTPS.

1. Créez un utilisateur dédié avec le rôle le plus limité possible (Auteur ou Éditeur selon le besoin) et un mot de passe d’application propre à Claude Code.
2. Publiez toujours avec le statut brouillon, puis prévisualisez la page, comme le recommande aussi la vidéo.
3. Après validation, passez la page en publié et demandez à Claude de vérifier la version en ligne : code HTTP, balises, canonical, présence dans le sitemap.
4. Contrôlez le rendu avec Claude in Chrome et demandez l’indexation dans Google Search Console.

Les points de vigilance propres à ce CMS sont détaillés dans l’article sur l’automatisation WordPress.

Brancher des outils SEO dans Claude Code via MCP

La vidéo met en avant un outil SEO connecté à Claude Code par MCP. Plusieurs éditeurs proposent ce type de connecteur, ce qui évite les exports manuels.

• Ahrefs publie un serveur MCP hébergé, accessible sur les offres payantes à partir de Lite, qui donne accès aux données de l’API Ahrefs et aux projets Search Console connectés.
• Google publie un serveur MCP expérimental pour Google Analytics, et des serveurs communautaires existent pour Search Console.
• L’ajout se fait en une commande : claude mcp add --transport http ahrefs https://api.ahrefs.com/mcp/mcp, puis /mcp pour s’authentifier.

La documentation de Claude Code rappelle de vérifier la fiabilité de chaque serveur avant de le connecter, car un serveur qui récupère du contenu externe expose à l’injection de consignes. Pour les cas d’usage, voir le guide MCP et SEO : connecter GA4, Search Console et Ahrefs à Claude.

Automatiser une page par jour, en gardant la main

La vidéo aborde l’automatisation d’une page par jour. Claude Code propose des tâches planifiées (routines dans le cloud, tâches de l’application de bureau), et n8n peut orchestrer le même enchaînement, comme dans nos cinq workflows SEO avec n8n.

Automatisez la préparation, pas la mise en ligne : la page arrive en brouillon, un humain la relit et la publie. C’est aussi la réponse de la vidéo à la question du pilote automatique : on ne le laisse pas tourner sans contrôle.

04Retour d’expérience : site, visuels et vidéos pilotés avec Claude Code

J’utilise cette logique sur mes propres projets, à commencer par ce site WordPress.

• Site : chaque article part d’un brief structuré, d’un fichier de règles de marque et de la liste des URL autorisées pour le maillage. Un script contrôle le résultat (liens, balises, caractères interdits, nombre de mots) avant toute mise en ligne, et la publication passe par un workflow n8n relié à WordPress.
• Visuels : les couvertures sont produites à partir d’un gabarit et de paramètres choisis dans une liste fermée (un motif central, quelques pictogrammes), ce qui garde une identité graphique cohérente.
• Vidéos : même principe de gabarit, de paramètres et de validation humaine du rendu final.

Ce que j’en retiens : la qualité vient du contexte écrit et des contrôles, pas du modèle seul. La vérification des faits reste un travail humain. Je n’ai pas mesuré précisément le temps gagné, je ne l’avance donc pas.

05Les garde-fous indispensables pour faire son SEO avec Claude Code

Un agent qui peut publier peut aussi publier une erreur. Ces garde-fous sont à poser dès le premier jour.

Relecture humaine et validation avant publication

• Relisez chaque page avant publication : faits, chiffres, dates, citations, promesses.
• Vérifiez chaque source citée en l’ouvrant vous-même.
• Gardez le mode plan pour les tâches qui touchent plusieurs pages.

Droits limités, sauvegardes et versionnage

• Compte CMS dédié, rôle minimal, mot de passe d’application révocable.
• Sauvegarde complète du site avant toute opération en masse.
• Projet versionné avec Git : chaque modification est traçable et réversible.
• Règles de permission qui interdisent les commandes destructrices.

Aucun mot de passe ni clé d’API dans le code

Stockez les identifiants dans des variables d’environnement ou un fichier .env exclu de Git, et interdisez à Claude de le lire. La documentation des réglages de Claude Code donne cet exemple de règle, à placer dans le fichier settings.json :

{
  "permissions": {
    "deny": ["Read(./.env)", "Read(./.env.*)"]
  }
}

Les règles « deny » s’appliquent dans tous les modes de permission. Vos scripts lisent le .env, l’agent n’en voit jamais le contenu.

06Limites de Claude Code en SEO et erreurs à éviter

Claude Code accélère l’exécution, il ne remplace ni la stratégie ni la connaissance du marché. Il peut se tromper sur un fait, mal lire une SERP ou produire un texte générique si le brief est flou.

• L’erreur classique du débutant, selon moi : publier vite beaucoup de pages sans vérifier leur indexation ni leur utilité réelle.
• Laisser l’agent choisir les mots-clés sans contrôle de pertinence business.
• Oublier que les règles anti-spam de Google visent la production de pages en masse sans valeur ajoutée, quel que soit l’outil utilisé (politique dite de « scaled content abuse », mars 2024).
• Connecter un serveur MCP inconnu ou donner un accès administrateur au CMS.

Quand augmenter le rythme de publication ? La vidéo pose la question, et ma règle est simple : quand les premières pages sont indexées, gagnent des impressions dans Search Console et que la relecture tient le rythme. Pas avant. Ce workflow s’inscrit dans une démarche plus large d’automatisation SEO et d’usage raisonné de l’IA en SEO.

07Questions fréquentes

Qu’est-ce que Claude Code ?

Claude Code est un agent d’Anthropic qui travaille directement dans vos fichiers : il lit un projet, modifie des fichiers, exécute des commandes et se connecte à des outils externes via MCP. Il fonctionne dans le terminal, dans VS Code et JetBrains, dans l’application de bureau et sur le web. Conçu pour le développement, il s’applique très bien aux tâches SEO répétitives et structurées.

Claude Code peut-il publier sur WordPress ?

Oui, via l’API REST de WordPress et un mot de passe d’application, ou via un serveur MCP dédié. La bonne pratique consiste à utiliser un compte au rôle limité, à publier en brouillon, à prévisualiser la page, puis à valider manuellement la mise en ligne. Les identifiants restent dans un fichier .env que Claude n’a pas le droit de lire.

Quelle différence entre Claude Code et Claude dans le navigateur ?

Claude Code agit sur des fichiers, des scripts et des API depuis votre machine ou le cloud. Claude in Chrome est une extension qui pilote votre navigateur avec vos sessions connectées : naviguer, cliquer, lire la console, remplir un formulaire. Les deux se combinent : lancé avec l’option –chrome, Claude Code peut vérifier dans le navigateur la page qu’il vient de produire.

Comment sécuriser Claude Code ?

Travaillez en mode plan pour les tâches nouvelles, ajoutez des règles de permission qui interdisent la lecture du fichier .env et les commandes destructrices, et versionnez le projet avec Git. Côté CMS, créez un compte dédié au rôle minimal avec un mot de passe d’application révocable. Ne connectez que des serveurs MCP de confiance et relisez tout avant publication.

Faut-il savoir coder pour utiliser Claude Code en SEO ?

Non, mais il faut savoir lire ce qu’il fait. L’application de bureau évite le terminal, et Claude écrit lui-même les scripts nécessaires. En revanche, comprendre la structure d’une page HTML, le fonctionnement d’une API et le rôle d’un fichier de configuration aide à repérer une erreur avant qu’elle n’arrive en ligne.