Guide d'installation

Installer l'agent SEO technique

Ce guide installe les six modules et te fait sortir ton premier rapport. Compte dix minutes, dont huit d'installation d'outils si tu ne les as pas déjà.

En résumé, à lire en premier

  • Les modules sont des dossiers. Tu les copies dans ~/.claude/skills/.
  • Claude Code les détecte au démarrage suivant. Il n'y a rien à configurer.
  • Un module a besoin de deux outils en plus : Lighthouse et jq.
  • Deux modules ont besoin d'un export Search Console.
  • Les trois autres tournent avec une URL, un sitemap ou ton code.
  • Tu déclenches un module en écrivant ta demande, pas avec une commande.
  • Chaque module rend un rapport en markdown.
  • Aucun module ne publie ni ne modifie ton site en ligne.

L'agent SEO technique, en deux lignes

Six modules qui tournent dans Claude Code : indexation, Core Web Vitals, données structurées, maillage par la structure, maillage par la Search Console, cannibalisation.

Chacun prend une entrée précise, applique un pipeline fixe et rend un rapport. Aucun ne touche à ton site.

Voir les six modules en détail

1. Ce qu'il te faut

Claude Code installé sur ta machine.

Un terminal ouvert dans le dossier de ton projet, ou dans n'importe quel dossier si tu audites un site en ligne.

Node.js, pour installer Lighthouse.

Un accès Search Console au site, pour deux des six modules.

Sans Search Console, quatre modules sur six tournent quand même.

2. Déposer les six modules

Dézippe l'archive directement dans ton dossier de skills.

unzip agent-seo-technique.zip -d ~/.claude/skills/

Chaque dossier contient un fichier SKILL.md. C'est ce fichier que Claude Code lit.

Ne renomme pas les dossiers. Le nom du dossier est le nom du module.

Si le dossier ~/.claude/skills/ n'existe pas encore, crée-le avant de dézipper.

mkdir -p ~/.claude/skills/

3. Vérifier que Claude Code les voit

Liste le dossier.

ls ~/.claude/skills/

Tu dois voir les six noms.

indexation-check
seo-core-web-vitals
seo-donnees-structurees
maillage-systeme
maillage-interne-gsc
seo-cannibalisation

Ferme Claude Code, puis rouvre-le. Il lit les skills au démarrage.

Un module qui n'apparaît pas dans cette liste ne se déclenchera jamais, quoi que tu écrives.

4. Installer Lighthouse et jq

Le module Core Web Vitals appelle Lighthouse en local et découpe ses résultats avec jq.

npm install -g lighthouse
brew install jq

Vérifie que les deux répondent.

lighthouse --version
jq --version

Tu ne veux rien installer en global ? Remplace lighthouse par npx lighthouse dans les commandes.

Le premier lancement est plus lent, le résultat est identique.

Les cinq autres modules n'ont besoin d'aucun de ces deux outils.

Les deux modules qui lisent ta Search Console

Le maillage sort la hiérarchie mère, fille, petite-fille, puis la liste des liens à poser avec leur ancre et le contexte de la phrase.

La cannibalisation classe les conflits en quatre types et tranche : redirection 301, fusion, différenciation, ou rien du tout.

Voir ce que rend chaque module

5. Sortir un export Search Console propre

Ouvre la Search Console, onglet Performances.

Choisis la période. Trois mois pour la cannibalisation, six mois pour le maillage.

Clique Exporter, puis CSV.

L'archive contient un fichier par onglet. Tu as besoin de Pages et de Requêtes.

Dézippe-la dans le dossier de ton projet.

Ne réenregistre pas les fichiers depuis Excel. Les modules lisent les colonnes d'origine.

6. La première demande

Il n'y a pas de commande à retenir. Tu écris ce que tu veux.

audit indexation de mon-site.fr, la liste des URLs est dans sitemap.xml

Claude Code reconnaît la demande et charge le module correspondant.

Les cinq autres se déclenchent de la même façon.

audit Core Web Vitals de https://mon-site.fr/sitemap.xml audit de cannibalisation, l'export GSC est dans ./gsc-requetes.csv plan de maillage interne à partir de ./gsc-pages.csv audit du maillage interne du site, sans passer par la Search Console mets en place les données structurées JSON-LD sur ce projet

Commence par l'indexation. Tant qu'une page est bloquée, tout ce que mesurent les autres modules ne sert à rien.

7. Lire le rapport

Chaque module rend un fichier markdown.

Les anomalies critiques sont en tête, les mineures ensuite, les corrections classées par priorité.

Le module d'indexation distingue « non indexée » et « non testable ». Une page non testable n'est pas un problème, c'est une limite de mesure.

Le module de cannibalisation ne recommande jamais une redirection 301 sans avoir regardé les chiffres des deux pages.

Le seul module qui écrit dans ton code est celui des données structurées. Claude Code te demande l'autorisation avant chaque écriture.

8. Les pannes fréquentes

  • Claude ne trouve pas le module.Le dossier est ailleurs que dans ~/.claude/skills/, ou Claude Code n'a pas été relancé depuis la copie.
  • lighthouse: command not foundNode n'est pas installé, ou l'installation globale a échoué. Passe par npx lighthouse.
  • Le sitemap ressort vide.L'URL pointe sur un index de sitemaps et pas sur un sitemap d'URLs. Donne le sitemap enfant.
  • Le rapport dit « non testable » partout.Google limite les requêtes automatisées. Relance plus tard, ou branche l'API Search Console officielle.
  • Le module ne trouve pas les colonnes du CSV.Le fichier a été ouvert puis réenregistré par un tableur. Repars du CSV d'origine.
  • Le module tourne mais ne trouve rien.Vérifie la période de l'export. Trois mois de données sur un site neuf ne suffisent pas à faire ressortir un conflit.

Tu lis ce guide sans avoir les modules

Les six modules s'installent en une fois, dans un seul dossier, et tournent en local sur tes propres fichiers.

Ton vault Obsidian branché en RAG et un fil WhatsApp en 1:1 viennent avec.

Voir l'agent SEO technique