Automatiser son SEO avec Claude Code, le tutoriel

Posons le décor sans exagérer, parce que les démonstrations en ligne le font déjà beaucoup.

Un assistant de code ne vous fera pas passer devant un concurrent installé depuis 10 ans sur sa requête principale. En revanche il abat en quelques minutes 3 travaux qui demandaient chacun un spécialiste.

• La production. Écrire un article structuré, avec ses images, ses liens et ses questions fréquentes.
• Le contrôle on-page, c’est-à-dire tout ce qui se passe sur la page elle-même. Vérifier 80 points de conformité, un par un.
• La technique. Le plan du site, le fichier des robots, la vitesse de chargement.

Ce qu’il ne fait pas, et c’est important de le savoir avant de commencer. Il ne décide pas de votre positionnement, il n’a pas vos chiffres, il ne connaît pas vos clients, et sa première version est toujours fade. Ces 4 manques sont le sujet des étapes 3, 4 et 10.

⚠ Un dernier point d’honnêteté sur les gains. On lit partout que la première position récolte 40 pour cent des clics. C’est la donnée mesurée sur les pages sans aperçu IA. Sur une page de résultats qui en affiche un, la première position tombe autour de 19 pour cent, et la moyenne 2026 toutes pages confondues se situe autour de 27,6 pour cent, selon les relevés qui croisent plusieurs études. Le classement compte toujours, il rapporte simplement moins qu’avant, ce que nous avons détaillé dans les aperçus IA et le trafic perdu.

Tout part d’un dossier sur votre ordinateur, et d’un seul fichier dedans. Ce fichier est le mode d’emploi permanent de l’assistant.

Pensez-y comme au livret d’accueil d’un nouveau salarié. Il le relit au début de chaque séance, donc tout ce qui compte doit y figurer une bonne fois.

CLAUDE.md, le fichier de consignes a poser a la racine

# Le site

Metier ........... plombier
Zone ............. Montpellier et 20 km autour
Public ........... particuliers, urgences et travaux

# Regles techniques NON NEGOCIABLES

- Le site est genere en pages STATIQUES, pas de rendu
  cote client. Une page doit exister en HTML complet
  avant toute visite.
- 1 seul titre de niveau 1 par page.
- Chaque page porte une balise title et une meta
  description ecrites a la main.
- Chaque page est reliee au plan du site.

# Regles d'ecriture

- Phrases courtes. Jamais de deux-points dans le texte.
- Les nombres en chiffres.
- Vouvoiement.
- Aucune promesse de resultat, aucun superlatif.

⚠ La ligne sur les pages statiques est la plus importante du fichier, et c’est celle que personne n’écrit. Un site qui se construit dans le navigateur du visiteur peut apparaître parfait à vos yeux et rester vide pour un moteur. Vous optimiseriez alors pendant des mois une page que personne n’indexe.

La vérification tient en une commande. Vous n’avez pas à l’écrire, vous la collez dans la fenêtre de Claude Code, qui l’exécute et vous rend le résultat. C’est vrai de tous les blocs de ce tutoriel.

# Le moteur voit-il votre texte, ou une page vide ?
# On demande la page SANS executer le moindre script,
# exactement comme le fait un robot d'indexation.

SITE="https://votre-site.fr"

echo "── Poids du HTML reellement servi"
curl -s "$SITE" | wc -c | sed 's/^/   octets : /'

echo
echo "── Le titre de niveau 1 est-il dans le HTML brut"
curl -s "$SITE" | grep -oE '<h1[^>]*>[^<]*' | head -2

echo
echo "── Un paragraphe de contenu est-il present"
curl -s "$SITE" | grep -oE '<p[^>]*>[^<]{40,}' | head -2

Si les 2 derniers contrôles ne rendent rien alors que la page s’affiche bien dans votre navigateur, votre site se construit côté visiteur. C’est le problème à régler avant d’écrire la moindre ligne.

C’est l’étape où l’on perd le plus de temps, et la seule que l’assistant ne peut pas faire seul. Il ne connaît ni les volumes de recherche, ni la difficulté réelle des requêtes.

Il vous faut donc un outil de mots-clés, et 3 filtres. Une requête, c’est simplement ce que quelqu’un tape dans le moteur. Ces 3 filtres transforment une liste d’un million de requêtes en une centaine d’occasions réelles.

LES 3 FILTRES, dans cet ordre

  1. DIFFICULTE  30 sur 100 MAXIMUM
     Au-dela, vous affrontez des sites installes depuis
     10 ans avec une equipe dediee. Un site neuf part
     avec un handicap tres lourd.

  2. VOLUME      100 recherches par mois MINIMUM
     En dessous, l'article ne rentabilisera jamais le
     temps passe a l'ecrire.
     ⚠ Garde-fou de DEMARRAGE, pas regle absolue. Une
     fois installe, une requete a volume nul mais a
     demande prouvee peut valoir mieux.

  3. INTENTION   informationnelle pour un ARTICLE
                 commerciale pour une PAGE DE SERVICE
     Quelqu'un qui tape acheter des chaussures ne veut
     pas lire un article sur les chaussures.

⚠ LE 4e FILTRE, MANUEL, QUE PRESQUE PERSONNE NE FAIT
  Retirer les requetes qui sont des NOMS D'ENTREPRISES
  concurrentes. Elles ressortent en masse dans les
  outils, elles ont l'air faciles, et se classer
  dessus n'amene aucun client. Il faut les ouvrir une
  par une pour s'en rendre compte.

Une fois la liste triée, exportez-la en fichier tableur et déposez-la dans votre dossier. C’est elle qui alimentera toute la suite.

Le regroupement, la partie qui multiplie le rendement. Une page ne se classe jamais sur un seul mot. Elle se classe sur des dizaines de variantes. Plutôt qu’un article par requête, on prend une requête principale et on lui rattache toutes ses voisines.

GABARIT DE REGROUPEMENT

  REQUETE PRINCIPALE   deboucher un evier

  VARIANTES A COUVRIR DANS LA MEME PAGE
    deboucher evier cuisine
    evier bouche que faire
    evier qui se vide lentement
    remede maison evier bouche
    produit pour deboucher un evier
    deboucher evier sans produit

➜ Une seule page, 6 portes d'entree. Un tres bon
  rapport effort sur resultat.

Voilà l’étape que tout le monde bâcle, et c’est elle qui décide si l’article sert à quelque chose.

Demandez un article à une IA sans autre consigne, et vous obtiendrez une introduction du genre dans un monde en constante évolution, suivie de 1200 mots que personne ne lira. Ce n’est pas un défaut de l’outil, c’est le résultat statistique attendu quand on ne lui donne rien de vous.

La parade tient en 5 fichiers, écrits une seule fois, relus à chaque article.

LES 5 FICHIERS DE REFERENCE, a poser dans le dossier

  voix.md       Comment vous parlez. Collez-y 3 ou 4
                de vos vrais textes, un mail client,
                une publication, une page existante.

  humour.md     Le registre autorise. Un exemple vaut
                mieux qu'une consigne abstraite.

  chiffres.md   Vos vrais nombres. 12 ans de metier,
                un delai moyen de 2 heures, 400
                interventions par an. C'est ce que
                personne d'autre ne peut ecrire.

  histoires.md  3 ou 4 anecdotes de chantier que vous
                racontez deja a vos clients.

  interdits.md  Ce qu'on n'ecrit jamais. Les promesses
                de resultat, les superlatifs, les
                termes reserves a une profession
                reglementee.

⚠ Le fichier chiffres.md est celui qui vous distingue
  Une entreprise qui traite 400 dossiers par an detient
  une donnee que personne d'autre ne possede. C'est
  ce qui a le plus de chances d'etre cite par
  quelqu'un d'autre.

Ces fichiers sont l’équivalent de la charte de rédaction que nous appliquons à ce site. Le principe est détaillé dans écrire un bon prompt, et il vaut ici plus qu’ailleurs.

👉 Le test qui tranche. Lisez les 50 premiers mots à voix haute. Si vous ne les diriez jamais à un client au téléphone, l’article n’est pas prêt.

Le moteur a déjà tranché pour vous. Les 3 premiers résultats d’une requête ont quelque chose que les autres n’ont pas, et cette chose se mesure.

On ne copie surtout pas leur texte. On copie leur structure, ce qui est parfaitement légitime.

A DEMANDER AVANT D'ECRIRE, sur chaque requete

  Ouvre les 3 premiers resultats de la requete
  <REQUETE>, en ignorant les forums et les places de
  marche. Pour chacun, releve :

    1. le nombre de mots
    2. le nombre de sous-titres
    3. le nombre d'images
    4. les questions traitees
    5. les sujets abordes que je n'ai PAS prevus

  Fais la moyenne des points 1 a 3, et propose-moi un
  plan qui la respecte. Signale separement les sujets
  du point 5, je deciderai lesquels garder.

⚠ Le point 5 est le vrai apport. Le nombre de mots est
  une commodite. Ce que les 3 traitent et que vous
  aviez oublie, c'est ce qui vous manquait pour vous
  classer.

Cette moyenne devient votre gabarit. Elle évite les 2 erreurs opposées, l’article de 300 mots qui n’a rien à dire et le pavé de 4000 mots que personne ne finit.

Le référencement on-page, c’est tout ce qui se passe sur la page elle-même. Les référentiels du métier en recensent environ 80, et les vérifier à la main sur chaque article est un travail à temps plein. Voici les 12 qui pèsent le plus.

C’est exactement le genre de tâche répétitive et vérifiable où la machine est meilleure que nous. Voici le cœur de la liste.

LES 12 POINTS QUI PESENT LE PLUS

  [ ] 1 seul titre de niveau 1, et il porte la requete
  [ ] la requete principale dans les 100 premiers mots
  [ ] une balise title de 50 a 60 caracteres
  [ ] une meta description de 140 a 160 caracteres
  [ ] 3 a 5 liens vers d'autres pages de votre site
  [ ] 2 a 3 liens vers des sources exterieures serieuses
  [ ] 4 a 8 questions frequentes avec leurs reponses
  [ ] chaque image porte une description alternative
  [ ] les images pesent moins de 200 Ko
  [ ] une adresse de page courte et lisible
  [ ] la date de mise a jour est visible et vraie
  [ ] la page est reliee depuis au moins 1 autre page

⚠ Le dernier point est celui qu'on oublie systematiquement.
  Une page que rien ne relie au reste du site est une
  page que le moteur met des semaines a trouver, et
  qu'il juge accessoire.

Le contrôle se rejoue sur la page publiée, pas sur le brouillon. C’est la seule mesure qui ne ment pas.

#!/usr/bin/env bash
# Controle on-page d'une page publiee, les 5 points
# qui se verifient sans outil payant.

PAGE="https://votre-site.fr/deboucher-un-evier/"

echo "── Nombre de titres de niveau 1, il en faut 1"
# ⚠ grep -c compte les LIGNES. Avec -o et wc -l on compte
#   bien les OCCURRENCES, meme si 2 sont sur la meme ligne.
curl -s "$PAGE" | grep -o '<h1' | wc -l | sed 's/^/   /' 

echo
echo "── Balise title et sa longueur"
TITRE=$(curl -s "$PAGE" | grep -oE '<title>[^<]*' | cut -c8-)
echo "   $TITRE"
echo "   ${#TITRE} caracteres"

echo
echo "── Meta description et sa longueur"
DESC=$(curl -s "$PAGE" \
  | grep -oE 'name="description" content="[^"]*' | cut -c29-)
echo "   ${#DESC} caracteres"

echo
echo "── Liens internes trouves sur TOUTE la page"
# ⚠ Ce compte inclut le menu et le pied de page. La regle
#   des 3 a 5 liens porte sur le CORPS de l'article, il
#   faut donc retrancher ceux du gabarit.
curl -s "$PAGE" | grep -oE 'href="/[^"]*"' | sort -u | wc -l

echo
echo "── Images sans description alternative"
curl -s "$PAGE" | grep -oE '<img[^>]*>' | grep -vc 'alt="'

3 éléments techniques décident si vos pages entrent dans l’index, la base où le moteur range les pages qu’il connaît. Ils se règlent une seule fois.

Le plan du site est la liste de vos pages, dans un format que les moteurs lisent. Sans lui, ils doivent deviner. Le fichier des robots dit ce qu’ils ont le droit de parcourir. La vitesse est mesurée par Lighthouse, l’outil de mesure intégré à votre navigateur.

Sur ce dernier point, la méthode est plus simple qu’il n’y paraît. On mesure, on colle le rapport, on redemande. La boucle est exactement celle décrite dans la boucle qui prompte l’agent.

LA BOUCLE DE PERFORMANCE, a repeter jusqu'a 100

  1. Ouvrir les outils de developpement du navigateur,
     onglet Lighthouse, puis analyser la page.

  2. Copier le rapport ENTIER, y compris les sections
     depliees des points en echec.

  3. Le coller a l'assistant avec cette consigne :
     Voici mon rapport. Corrige les points en echec
     pour atteindre 100 sur les 4 indicateurs, sans
     modifier le texte visible de la page.

  4. Reconstruire, remesurer, recommencer.

⚠ ARRET au bout de 4 passages. Si le score plafonne, le
  blocage est ailleurs, souvent une police externe ou
  un script de mesure d'audience. C'est un arbitrage,
  pas un reglage.

⚠ Et le piege classique. Ne laissez JAMAIS l'assistant
  gagner des points en retirant du texte ou des images de
  contenu. Un score de 100 sur une page vide ne vaut
  rien.

Notre propre plan du site est généré automatiquement à chaque publication, et le contrôle qui suit vérifie qu’aucune adresse n’y manque. C’est la même logique, à une échelle plus grande.

À ce stade vous avez fait le tour une fois, et ça vous a pris une demi-journée. L’intérêt n’est pas là. Il est dans le fait de ne plus jamais le refaire.

On range toute la chaîne dans une compétence, un simple dossier avec un fichier qui décrit la procédure. Ensuite, un mot suffit.

SKILL.md, la chaine complete rangee une bonne fois

---
name: article-seo
description: Ecrit et optimise un article de blog a
  partir d'une requete du fichier mots-cles.csv
---

# Procedure

1. Prendre la premiere requete NON TRAITEE du fichier
   mots-cles.csv, et la marquer comme traitee.
2. Construire le regroupement de variantes.
3. Analyser les 3 premiers resultats, relever la
   moyenne des mots, sous-titres et images.
4. Rediger en appliquant voix.md, humour.md,
   chiffres.md, histoires.md et interdits.md.
5. Appliquer la liste de controle on-page.
6. Reutiliser le gabarit de page deja optimise, ne
   jamais repartir d'une structure neuve.
7. Ajouter la page au plan du site.
8. S'ARRETER et me montrer le resultat.

# Interdits

- Ne jamais publier sans validation humaine.
- Ne jamais reutiliser une requete deja traitee.
- Ne jamais inventer un chiffre absent de chiffres.md.

⚠ Le point 8 et le premier interdit ne sont pas des précautions de style. Une chaîne qui publie toute seule finit par publier une erreur factuelle sous votre nom, et vous ne le saurez qu’au moment où un client vous la citera.

👉 Le point 6 fait gagner beaucoup de temps sur la durée. Une page dont la structure technique est déjà réglée n’a pas besoin d’être remesurée à chaque article.

Vous pouvez désormais produire un article en quelques minutes. C’est précisément le moment où l’on fait la faute qui coûte le plus cher.

Un site qui publie 200 pages en une nuit envoie un signal très net, et les moteurs surveillent exactement ça. Il ne s’agit pas d’une pénalité annoncée, mais d’un ralentissement d’indexation dont on ne comprend jamais la cause.

python3 <<'PY'
# Une montee en charge qui ne declenche rien.
# A adapter, mais gardez la forme progressive.

PLAN = [(1, 1), (2, 1), (3, 2), (5, 3), (8, 4), (12, 5)]

total = 0
print("  JOUR   ARTICLES   CUMUL")
for jour, nb in PLAN:
    total += nb
    print(f"  {jour:4}   {nb:8}   {total:5}")

print()
print(f"  ➜ {total} articles en 12 jours, sans pic visible.")
print("    Les memes 16 articles publies en une seule nuit")
print("    donnent le meme total et un signal tout different.")
PY

2 gestes gratuits accélèrent l’indexation, bien plus sûrement que le volume.

Déclarer votre plan du site dans la console de recherche, une seule fois. Et demander l’indexation d’une page précise juste après l’avoir publiée. Cette seconde action est limitée à une dizaine de demandes par jour, et elle raccourcit souvent un délai de plusieurs semaines à quelques jours, sans aucune garantie.

Terminons par les limites, parce qu’elles décident du résultat autant que la méthode.

Le positionnement reste votre travail. L’outil écrit sur ce que vous lui indiquez. Il ne sait pas que votre marge est meilleure sur les dépannages que sur les installations neuves, ni que vos meilleurs clients viennent d’un quartier précis.

Les pages de service par ville sont un terrain miné. La méthode consiste à croiser chaque service avec chaque ville, ce qui produit vite des dizaines de pages presque identiques. C’est utile à petite dose et sanctionné à grande échelle. Nous avons tracé la limite exacte dans pages par ville, la ligne à ne pas franchir.

Les liens ne s’achètent pas. Les offres à 100 liens pour quelques euros passent par des réseaux de sites créés pour ça. C’est détecté, c’est sanctionné, et c’est très long à réparer.

Et le SEO pour les IA n’est pas tout à fait le SEO classique. L’argument selon lequel une IA cherche puis synthétise est juste, et le travail de fond se recoupe largement. Mais la première position rapporte environ 39,8 pour cent des clics sur une page sans aperçu IA, et environ 19 pour cent avec. Le même classement, la moitié moins de visites. Ce qui change n’est pas la méthode, c’est ce qu’elle rapporte.

👉 Notre position, après avoir appliqué cette chaîne sur notre propre site. Elle fonctionne, elle fait gagner plusieurs heures par article sur la production et sur la technique, et elle ne dispense d’aucune décision. Si vous préférez confier l’ensemble, c’est exactement notre prestation de référencement.