Guide AUDIT SEO TECHNIQUE avec Claude code

Avant de démarrer et te montrer comment créer ton propre système SEO avec Claude + Obsidian, voici quelques exemples de la puissance du système pour te convaincre d’aller un peu plus loin :

Mon système SEO rassemble mes méthodes, les données du site et les rapports dans un dossier de travail. Claude utilise ces documents pour effectuer les contrôles et préparer les corrections. Obsidian, une application de prise de notes, permet de consulter et d’organiser les analyses. Les décisions et les mesures sont conservées pour comparer les audits successifs.

Dans ce guide, je détaille cinq sujets : indexation, vitesse sur mobile, données structurées, maillage interne et cannibalisation. Le maillage utilise deux méthodes, ce qui porte le total à six skills. Un skill est un ensemble de consignes et de fichiers que Claude Code utilise pour réaliser une tâche précise.

Quatre fonctionnent sans Search Console. Les deux autres exploitent ses exports. Le skill de données structurées peut modifier le code local d’un site Next.js ; les autres produisent des rapports. Pour l’essai présenté ici, j’ai demandé une analyse en lecture seule aux six outils.

En résumé

Six skills Claude Code couvrent cinq sujets du SEO technique : l’indexation, la vitesse sur mobile, les données structurées, le maillage interne et la cannibalisation. Quatre fonctionnent sans Search Console, les deux autres exploitent ses exports. Lancés en lecture seule sur organikk.co le 11 novembre 2026, ils relèvent 55 URL indexées sur 89 au sitemap, un LCP médian de 4,26 s en laboratoire sur 49 pages et 12 requêtes en conflit confirmé. L’effet SEO des corrections proposées n’a pas été mesuré.

01 · Choisir le skill selon le problème SEO et les données disponibles

Six skills couvrent l’indexation, la vitesse, le balisage, le maillage et la cannibalisation

Le pack du 30 octobre 2026 contient six dossiers, deux annexes et un fichier LIRE-MOI.txt.

SkillContrôle réaliséDonnées minimalesLivrableSearch Console
indexation-checkDécouverte, exploration et indexation des URL importantesDomaine et sitemap ou liste d’URLRapport : blocages, inspection, sitemap, soft 404, redirections et balises canoniquesFacultative, pour l’inspection d’URL
seo-core-web-vitalsVitesse de chargement sur mobileSitemap, avec 50 URL testées par défautRapport séparant tests en laboratoire et données terrainNon
seo-donnees-structureesCohérence du JSON-LD avec le contenu affichéProjet Next.js App RouterModule lib/schema.ts et contrôles de validationNon
maillage-systemeStructure des liens et pages qui en reçoivent peuListe des URL et contenu des pagesArchitecture, audit des liens et plan de maillageNon
maillage-interne-gscChoix des pages à relier selon leurs requêtes et leurs impressionsExport Search Console des pages ; requêtes associées pour l’analyse détailléeLiens proposés avec page source, destination et ancreOui
seo-cannibalisationConcurrence entre plusieurs pages sur une même requêteRequêtes associées aux URL sur 90 joursConflits classés selon les preuves et actions proposéesOui

Les documents fournis déterminent la précision du diagnostic

Pour l’indexation, le minimum demandé est une liste d’URL et le domaine. L’accès à l’inspection Search Console permet ensuite de vérifier le statut connu de Google.

Les méthodes maillage-interne-gsc et seo-cannibalisation dépendent des données Search Console. Pour rapprocher les requêtes des pages, elles ont besoin d’un export qui conserve cette association.

Le contenu intégral des pages est également nécessaire pour proposer des liens précis. Sans lui, maillage-systeme peut préparer une architecture, mais ne peut pas choisir les ancres dans les phrases existantes.

Les rapports distinguent les blocages confirmés et les contrôles incomplets

Le rapport d’indexation suit un gabarit fixé le 26 septembre 2026. Sa rubrique « Ce qui bloque réellement » peut répondre « rien de confirmé ». Une autre rubrique conserve les anomalies détectées mais non retenues comme causes.

Le rapport de cannibalisation distingue les faits, les hypothèses et les actions proposées. Dans les six méthodes, le contrôle final impose de signaler les vérifications qui n’ont pas pu être exécutées. Une inspection Search Console qui échoue ne permet donc pas de déclarer une page non indexée.

Les modifications du site restent soumises à validation

Le contrôle d’indexation est réalisé en lecture seule : aucune modification du site et aucune tentative de forçage de l’indexation. La règle est simple : Claude observe, je décide.

Si Lighthouse manque, le skill de vitesse propose son installation et s’arrête. Il ne doit pas l’installer silencieusement.

Le skill de données structurées a un autre rôle. Ses étapes 3 à 6 écrivent du code dans le projet local, dans le périmètre autorisé. Avant de publier, il faut examiner le diff, c’est-à-dire les modifications apportées aux fichiers.

Les six méthodes interdisent de publier ou de modifier un site distant sans autorisation.

Commencer par l’indexation des pages importantes

Je commence par vérifier si les pages commerciales peuvent être explorées et indexées. Ce contrôle est utile avant un rendez-vous client, après une refonte ou la publication d’un groupe de pages, après une chute de trafic inexpliquée et avant un projet de production à grande échelle.

L’audit de vitesse intervient notamment avant une refonte, une optimisation ou une migration. La cannibalisation mérite d’être examinée lorsque les positions baissent sans explication ou que le taux de clics stagne malgré les impressions. Ces symptômes orientent les vérifications ; ils ne suffisent pas à établir une cause.

02 · Installer les six skills et préparer les exports Search Console

Copier les dossiers complets et vérifier leur chargement dans Claude Code

Le fichier LIRE-MOI.txt demande de sauvegarder les versions existantes, puis de copier les six dossiers dans ~/.claude/skills/. Il faut conserver leurs sous-dossiers scripts/ et references/ : ils contiennent notamment le script de crawl crawl_graph.py et le modèle de balisage schema-reference.ts.

La procédure décrite dans le pack prévoit la prise en compte d’un skill ajouté ou modifié pendant la session. Si le dossier skills était absent au démarrage, elle indique d’utiliser /reload-skills. Après avoir renommé un dossier ou modifié le champ name, elle demande de redémarrer la session.

Pour vérifier que la méthode est accessible, appelle-la par son nom, par exemple /indexation-check. Claude peut aussi sélectionner un skill lorsqu’il le juge pertinent, mais vérifie qu’il utilise bien les fichiers attendus.

Préparer Python 3, Lighthouse et jq

Le crawl de maillage utilise Python 3. Lighthouse nécessite Node.js et Chrome ; jq sert à lire les résultats de performance.

Sur une installation qui utilise npm et Homebrew, les commandes indiquées sont :

Terminal
npm install -g lighthouse
brew install jq

npx lighthouse permet d’éviter l’installation globale. Le 11 novembre 2026, ma machine utilisait Lighthouse 13.3.0, tandis que PageSpeed Insights exécutait Lighthouse 13.6.0. Ces versions doivent être conservées avec les mesures.

Exporter les requêtes avec leurs URL et leurs périodes

Deux listes globales séparées, l’une de requêtes et l’autre de pages, ne permettent pas de savoir quelle page apparaît sur quelle recherche. Exporte les données par page avec un filtre, ou utilise l’API.

La méthode prévoit trois mois pour la cannibalisation et trois à six mois pour le maillage. Évite d’ouvrir le CSV dans un tableur pour le réenregistrer avant l’analyse.

Le 11 novembre, l’export API d’organikk.co contenait 346 lignes associant une requête à une page, pour 276 requêtes visibles sur 90 jours. Les requêtes anonymisées n’y figurent pas.

Conserver le périmètre du site et les dates de comparaison

J’utilise organikk.co pour cet essai parce qu’il s’agit de mon site et que je peux en publier les mesures.

Du 12 août au 9 novembre 2026, la Search Console comptabilisait 283 clics, 6 092 impressions et 133 pages dans les données de performance. Du 24 juin au 21 septembre, avant l’audit du 22 septembre, elle comptabilisait 105 clics et 1 296 impressions. Cet écart ne permet pas d’attribuer la hausse à une action particulière.

Le site a également évolué : son sitemap est passé de 29 URL le 22 septembre à 48 le 9 novembre, puis à 89 le 11 novembre, dont 36 sous /chaine-youtube-seo/. Les audits successifs ne couvrent donc pas exactement les mêmes pages.

03 · Vérifier les blocages techniques et le statut d’indexation des URL

Séparer les contrôles techniques du statut connu de Google

Le skill d’indexation procède en trois temps : il examine les causes techniques possibles, consulte le statut d’indexation connu de Google, puis rédige le rapport.

Les contrôles techniques portent notamment sur les réponses HTTP, robots.txt, la directive noindex, le sitemap, les liens entrants et la longueur du contenu. Cette séparation corrige une limite de la première version : elle pouvait indiquer « OK 200 » alors qu’une page contenait un noindex accidentel.

Une réponse 200 signifie que la page est accessible. Elle ne prouve pas qu’elle est indexable ou indexée. De plus, Google doit pouvoir explorer une page pour lire sa directive noindex ; un blocage dans robots.txt peut l’en empêcher.

Sur organikk.co, les observations ne permettent pas d’expliquer la non-indexation par le seul maillage : /audit-seo/ et /plan-du-site/ ne reçoivent aucun lien dans le périmètre observé, mais sont indexées. Parmi les 20 URL du sitemap qui ne sont pas reliées à l’accueil par les liens du HTML initial, 10 sont indexées, dont /contact/.

Le rendu dans Chrome a également été vérifié sur 17 pages. Le title, les directives robots et la balise canonique sont restés identiques avant et après rendu. Le nombre de mots, lui, peut varier : /audit/ passe de 240 à 3 239 mots et figure dans l’index.

Le rapport ne retient donc pas de cause générale fondée sur ces seuls constats. Treize pages vidéo sont indexées malgré un maillage comparable à celui de 22 pages vidéo non indexées. Les sept pages de moins de 300 mots sont indexées : leur longueur n’est pas retenue comme cause de blocage.

Lancer les contrôles sur le sitemap ou une liste d’URL

Prompt
/indexation-check Audite l’indexation de [DOMAINE] à partir de [ADRESSE DU SITEMAP].

Travaille en lecture seule. Sépare les contrôles techniques du statut d’indexation connu de Google. Indique les URL réellement contrôlées, les sources, les dates et les limites de collecte.

Classe les contrôles qui échouent comme non testés. Ne conclus pas à une non-indexation sans preuve et ne modifie pas le site.

Remplace les éléments entre crochets par les informations du site.

~/.claude/skills/indexation-check/SKILL.md · 5 225 mots
---
name: indexation-check
description: |
  Audit d'indexation d'un site (B2B / éditorial / pSEO) sans outil tiers payant. Vérifie 9 points sur chaque URL : statut HTTP, blocages techniques, directives noindex, sitemap (présence + lastmod + cohérence), maillage interne entrant, longueur de contenu, statut d'indexation Google estimé. Sortie : rapport markdown avec synthèse, anomalies critiques en tête, anomalies mineures, recommandations priorisées. Distingue strictement "non indexée" et "non testable" (rate-limit Google). Aucune action de forçage, lecture seule sur le web public. Sortie obligatoire en plus du tableau : un rapport de pré-décision (diagnostic, preuves typées, état Critique / À améliorer / Sain, actions P1-P3 avec confiance, effort et risque, jamais de score affiché) ; sans lui le skill n'a pas terminé.

  TOUJOURS utiliser ce skill quand l'utilisateur dit : "audit indexation", "check indexation", "monitoring indexation", "vérifier l'indexation", "mes pages sont-elles indexées", "agent indexation", "routine indexation mensuelle", ou quand il fournit une liste d'URLs / un sitemap / un fichier `urls.txt` / `articles.ts` / `wiki.ts` en demandant un diagnostic d'indexation.

  Ce skill est conçu pour tourner en one-shot (audit ponctuel) ou en récurrent mensuel via `/schedule`. Cible : sites de 30 à 1 000 pages. Au-delà, brancher l'API Google Search Console officielle (voir section "Variante haute fiabilité").
---

# Skill — Audit d'indexation Claude

## Quand déclencher

- Audit ponctuel d'un site (avant call commercial, après une refonte, après un déploiement de cluster)
- Monitoring mensuel récurrent sur un client en accompagnement
- Diagnostic d'une chute de trafic non expliquée
- Pré-flight d'un projet pSEO (vérifier que la base technique est saine avant de scaler)

## Input requis

| Source | Obligatoire |
|--------|-------------|
| Liste des URLs à monitorer (fichier dans le repo : `urls.txt`, `src/data/wiki.ts`, `src/data/articles.ts`) OU URL du sitemap.xml public du site | Oui |
| Domaine cible (ex : `site-client.fr`) | Oui |
| Périmètre du maillage à crawler (pages hubs : `/`, `/glossaire`, `/wiki`, footer, articles) | Recommandé |
| Service account GSC API (upgrade fiabilité) | Optionnel |

Minimum viable : une liste d'URLs et le domaine. Le reste se déduit.

## Architecture (3 couches)

```
1. Charger la liste des URLs (source de vérité humaine)
        ↓
2. COUCHE A — Audit technique (causes potentielles)
        ↓
3. COUCHE B — Statut d'indexation observable
        ↓
4. COUCHE C — Reporting markdown
```

La séparation causes / statut est volontaire. Le check v1 ne regardait que le statut, donc disait "OK 200" même quand la page portait un `noindex` accidentel. Le check v2 sépare strictement les deux.

## Pipeline (9 checks)

### COUCHE A — Audit technique (causes)

**1. HTTP check (404/500, redirects)**
Pour chaque URL :
```bash
curl -sIL -A "Mozilla/5.0" -o /dev/null -w "%{http_code}|%{url_effective}" {URL}
```
Note le code final ET la chaîne de redirects. 200 attendu. Toute redirection 301→200 systématique = dette à signaler (trailing slash, http→https).

**2. robots.txt non bloquant**
```bash
curl -s https://{domaine}/robots.txt
```
Pour chaque path, vérifie qu'aucune directive `Disallow:` ne le bloque pour `User-agent: *` ni `User-agent: Googlebot`.

**3. Pas de balise noindex (HTML + en-tête HTTP)**
```bash
curl -sL -A "Mozilla/5.0" {URL} | grep -i 'name="robots"'
curl -sIL {URL} | grep -i 'x-robots-tag'
```
Signaler toute présence de `noindex` ou `none`.

**4. Sitemap : présence + fraîcheur**
```bash
curl -s https://{domaine}/sitemap.xml
```
Pour chaque slug attendu, vérifie présence d'une `<loc>` et lis le `<lastmod>` associé. Flagger tout `lastmod` > 6 mois.

**5. Cohérence sitemap ↔ source de vérité**
Diff entre les slugs de la SOT (fichier humain) et les `<loc>` du sitemap :
- Slugs en source mais absents du sitemap → à ajouter au build
- `<loc>` en sitemap mais absente de la source → orpheline sitemap

**6. Maillage interne entrant**
Crawl les pages hubs (`/`, `/glossaire`, `/wiki`, footer, sample d'articles) et compte les liens internes entrants par URL cible.
- 0 lien entrant = orpheline (critique)
- 1 seul lien entrant = sous-maillée (à signaler)

**7. Longueur de contenu (proxy thin content)**
Pour chaque URL, extrais le texte du `<main>` ou `<article>` (à défaut du `<body>` moins `<nav>` et `<footer>`) et compte les mots.
- < 300 mots = thin (à creuser)
- 300-800 = court mais acceptable pour fiche atomique
- > 800 = OK

### COUCHE B — Statut d'indexation (sortie)

**8. Indexation Google estimée (scraping `site:`)**
```bash
curl -sL -A "Mozilla/5.0 (Macintosh...)" "https://www.google.com/search?q=site:{URL}&hl=fr"
```
**Garde-fous obligatoires :**
- Espacer les requêtes de 3 à 5 secondes (`sleep 4`)
- Détecter le blocage : `grep -E 'sorry/index|recaptcha|unusual traffic'`
- Si bloqué : marquer "non testable — rate limit", **pas** "non indexée"
- Retry une fois si réponse vide avant de conclure
- Marquer "indexée" si l'URL apparaît dans le HTML de réponse

Ce que vaut ce signal (Tim, 28/09/2026, remplace les pourcentages de fiabilité non calibrés) : `site:` est un **indice non exhaustif**. Google indique qu'une URL indexée peut ne pas apparaître dans ces résultats. Une absence ne prouve donc pas une non-indexation ; une présence prouve une indexation à la date du test. Le rapport écrit la source (`site:`), la date et la portée (« N URL testées, M bloquées par le rate-limit »), jamais un pourcentage de fiabilité.

### COUCHE C — Reporting

**9. Rapport markdown**
Structure obligatoire :
- Synthèse en tête (X/N par dimension, `✅` pour validé, `⚠️` pour anomalie)
- Anomalies CRITIQUES (action immédiate) — `noindex` accidentel, page orpheline, 404 sur page business
- Anomalies mineures — `lastmod` > 6 mois, sous-maillage, thin content
- Recommandations priorisées (2-5 actions, classées par impact estimé)
- Section "Limites du rapport" (ce qui n'a pas pu être testé et pourquoi)

## Sortie de pré-décision (obligatoire)

Ce skill n'a pas terminé tant que le rapport de pré-décision n'est pas écrit. Il fait partie de la sortie, au même titre que le tableau, et applique le format de restitution décrit ci-dessous. Fichier : `wiki/audit/YYYY-MM-DD-slug-indexation-decision.md`.

Ce qu'il contient, dans cet ordre :

1. Diagnostic principal : une phrase, la cause structurante, pas une liste d'erreurs
2. Les chiffres à retenir : 3 à 5, ceux qui illustrent le diagnostic
3. État : Critique, À améliorer ou Sain, calculé sur l'impact SEO réel et le type de page, jamais sur le nombre d'erreurs ; jamais de score sur 10
4. Problèmes (3 maximum) et opportunités (5 maximum), séparés : chacun avec Preuve (2 à 4 données), Pourquoi c'est important, Action, Confiance (forte / moyenne / faible) ; chaque problème s'écrit en trois temps : observation prouvée → conséquence ou risque justifié → bénéfice attendu de la correction (l'observation seule n'est pas un frein SEO démontré)
5. Actions P1 / P2 / P3, 3 P1 maximum : pourquoi, preuve, signal attendu (jamais un résultat chiffré promis), dépendance préalable, test de validation (ce qui distingue « correction appliquée » de « résultat SEO observé »), effort faible / moyen / élevé (jamais en heures), confiance, risque low / medium / high ; toute action high (suppression, 301, fusion, changement d'URL) porte « À valider avant déploiement » et sa checklist
6. Ce que les données ne permettent pas de conclure, et « données insuffisantes » ou « ne rien faire » quand c'est le cas

Sur le périmètre de ce skill, le rapport tranche l'indexation : URLs vues par Google mais en 404 ou redirigées (règle 404 URL par URL : 301 seulement si une page équivalente existe, 410 ou 404 conservée, restaurer, ou à vérifier ; jamais un 301 de dossier à dossier), sitemap, canonicals ; « non indexée » et « non testable » séparés.

Règles : chaque information est typée FACT, HYPOTHESIS ou ACTION, jamais une hypothèse écrite comme un fait ; un problème existe une seule fois (ID), les observations qui parlent du même problème fusionnent ; une anomalie n'est pas une priorité par défaut ; les pages business et les tendances GSC passent avant les anomalies techniques secondaires ; jamais de recommandation automatique de fusion, 301, suppression, réécriture ou création de page ; Google n'est jamais anthropomorphisé. Phrases courtes, une donnée par diagnostic, aucune des phrases « Il est important de », « Il convient de », « Cela peut potentiellement », « Il est intéressant de noter », « Dans le cadre de ».

Restitution (corrections V2 du 23 septembre) : aucun ID technique ni mot anglais (low / medium / high) dans le rapport ; Faible / Moyen / Élevé partout ; la certitude affichée ne dépasse jamais la couverture des données (« aucun problème majeur détecté sur les URL inspectées », pas « Sain ») ; formulations précises (« URL en 404 avec encore des impressions ») ; aucune action proposée sur une page dont les requêtes ne sont pas connues (« à vérifier ») ; le nombre de mots seul n'est jamais un problème ; limites de longueur : diagnostic 70 mots, 4 chiffres, 3 problèmes de 40 mots, 6 actions, 3 opportunités de 35 mots, le reste dans les détails repliés.

Onglet Analyse technique, structure validée le 23 septembre 2026 : chaque priorité = une phrase de cadrage, « Ce qu'on observe » (faits chiffrés en liste, pages en code), « Pourquoi c'est prioritaire » (deux phrases), « Action » (liste numérotée courte), « Impact attendu » et « Risque » en gras ; puis le plan des 30 jours en trois paliers (Priorité immédiate, Deuxième étape, Priorité secondaire), une action par paragraphe en gras suivie d'une phrase ; puis « à surveiller avant d'agir » pour la page dont la cause n'est pas isolée ; puis « Autres pages à surveiller » : chiffres séparés par « · », une phrase, verdict en gras (« Aucune action recommandée », « À vérifier avant toute modification »).

## Sortie obligatoire

Gabarit de l'onglet Indexation (Tim, 26 septembre 2026). Chaque placeholder `[...]` vient d'une mesure réelle ou n'apparaît pas.

```markdown
# Indexation

[Nombre] pages testées sur [nombre total].

**Sources utilisées :** crawl, sitemap, robots.txt, Search Console, inspection d'URL Google, tests HTTP directs.

**Pages sans défaut d'indexation confirmé :** [XX %]

> Ce pourcentage ne doit compter que les défauts réellement démontrés. Une anomalie potentielle ou extrapolée ne doit pas faire baisser ce chiffre.

---

## Chiffres à retenir

| Mesure | Résultat |
|---|---:|
| **Pages testées** | [XX] |
| **Pages répondant en 200** | [XX / XX] |
| **Pages en noindex** | [XX] |
| **Pages bloquées par robots.txt** | [XX] |
| **Redirections non souhaitées** | [XX] |
| **URL importantes absentes du sitemap** | [XX] |
| **URL du sitemap redirigées** | [XX] |
| **Soft 404 / fallback détectés** | [XX] |
| **URL inspectées individuellement dans Google** | [XX] |

---

# Ce qui bloque réellement

## 1. [Nom précis du problème]

### État constaté

[Décrire uniquement ce qui est objectivement mesuré.]

Exemple :

> 49 URL déclarées au sitemap sans slash final redirigent vers leur version canonique avec slash.

### Preuve

- [crawl]
- [curl / requête HTTP]
- [sitemap]
- [Search Console]
- [inspection Google]

### Impact

[Expliquer la conséquence réellement défendable.]

Exemple :

> Le sitemap ne pointe pas directement vers les URL finales. Google et les autres crawlers doivent donc suivre une redirection avant d'atteindre la version canonique.

Ne pas ajouter de conséquence non démontrée sur le ranking ou le crawl budget.

### Action

[Action précise.]

Exemple :

> Générer le sitemap avec les URL finales réellement servies et canonicalisées.

**Priorité :** [Haute / Moyenne / Faible]
**Effort :** [Faible / Moyen / Fort]
**Confiance :** [Forte / Moyenne / Faible]

---

## 2. [Deuxième problème]

### État constaté

[...]

### Preuve

[...]

### Impact

[...]

### Action

[...]

**Priorité :** [...]
**Effort :** [...]
**Confiance :** [...]

---

## 3. [Troisième problème]

Même structure.

---

# Ce qui va bien

| Contrôle | Résultat | Lecture |
|---|---:|---|
| **HTTP** | [XX / XX] pages répondent en 200 | [sain / réserve] |
| **noindex** | [XX] | [lecture] |
| **robots.txt** | [XX] | [lecture] |
| **canonical** | [XX] | [lecture] |
| **pages business inspectées** | [XX] | [lecture] |

Ce bloc doit éviter de présenter l'audit uniquement sous l'angle des problèmes.

---

# Inspection Google

## URL inspectées individuellement

| URL | Verdict Google | Dernier crawl | Source |
|---|---|---|---|
| `[URL]` | [Indexée / Inconnue / Page avec redirection / Explorée non indexée / etc.] | [date] | Inspection Google |
| `[URL]` | [...] | [...] | [...] |

Ne jamais extrapoler automatiquement le statut d'un cluster entier à partir de quelques URL.

---

## Ce que l'échantillon permet de dire

Exemple :

> 4 pages sur 22 du cluster ont été inspectées individuellement. Les 4 renvoient « URL inconnue de Google ».

Ce qui peut être dit :

> **Le problème est confirmé sur les 4 URL testées.**

Ce qui ne peut pas être dit :

> **Les 22 pages n'ont jamais été vues par Google.**

Pour les autres URL :

> Le même comportement est possible compte tenu de leur architecture commune, mais il n'est pas mesuré individuellement.

---

# Sitemap

## Cohérence du sitemap

Vérifier :

- URL finale ou URL redirigée ;
- statut HTTP ;
- canonical ;
- présence des pages réellement destinées à l'indexation ;
- absence des URL techniques ou non canoniques ;
- date de dernière lecture du sitemap dans Search Console.

| Contrôle | Résultat |
|---|---|
| URL finales déclarées | [XX / XX] |
| URL du sitemap qui redirigent | [XX] |
| pages stratégiques absentes | [XX] |
| URL non destinées à l'indexation présentes | [XX] |
| dernière lecture Search Console | [date] |

---

# Soft 404 et fallback

## Test d'URL inexistantes

Tester au minimum :

- une route racine inventée ;
- une route dans une section existante ;
- une route proche d'une vraie page.

Exemple :

`/page-qui-nexiste-pas-12345`
`/blog/inexistant-999`
`/xyzabc`

Pour chacune, relever :

- statut HTTP ;
- title ;
- canonical ;
- taille HTML ;
- contenu principal ;
- similitude avec la home.

### Conclusion possible

> Les URL inexistantes retournent HTTP 200 et servent le contenu de la page d'accueil.

### Action

> Retourner un vrai 404 pour les routes inconnues avec une page d'erreur dédiée.

Ne pas utiliser automatiquement 410 : réserver le 410 aux ressources connues volontairement supprimées.

---

# Redirections

## Redirections observées

| Type | Nombre | Exemple | Action |
|---|---:|---|---|
| HTTP → HTTPS | [XX] | [...] | [rien / corriger] |
| www → non-www | [XX] | [...] | [...] |
| slash → sans slash | [XX] | [...] | [...] |
| sans slash → slash | [XX] | [...] | [...] |
| ancienne URL → nouvelle | [XX] | [...] | [...] |

Toutes les redirections ne sont pas des problèmes.

Une redirection devient un finding si elle :

- apparaît systématiquement dans le sitemap ;
- crée une chaîne ;
- envoie vers une mauvaise destination ;
- concerne une URL destinée à être canonique ;
- empêche d'accéder au contenu attendu.

---

# Canonicalisation

Vérifier :

- canonical présent ;
- canonical auto-référent lorsque pertinent ;
- canonical vers une URL en 200 ;
- absence de contradiction sitemap / canonical / redirection ;
- absence de canonical vers une page sans rapport.

| Contrôle | Résultat |
|---|---:|
| canonical manquant | [XX] |
| canonical vers autre URL | [XX] |
| canonical vers URL redirigée | [XX] |
| contradiction sitemap / canonical | [XX] |

---

# Pages hors sitemap

Une URL hors sitemap n'est pas automatiquement un défaut.

Pour chaque page :

| URL | Doit être indexée ? | Business ? | Dans sitemap ? | Action |
|---|---|---|---|---|
| `[URL]` | Oui | Oui | Non | Ajouter |
| `[URL]` | Non | Non | Non | Rien |
| `[URL]` | À confirmer | Moyen | Non | Vérifier |

Question centrale :

> **Cette URL fait-elle partie des pages que l'on veut réellement faire découvrir et indexer ?**

---

# Pages à examiner en priorité

| URL | Rôle | État Google | Problème | Priorité |
|---|---|---|---|---|
| `[URL]` | Business | [état] | [problème] | Haute |
| `[URL]` | Cluster | [état] | [problème] | Moyenne |
| `[URL]` | Secondaire | [état] | [problème] | Faible |

La priorité dépend de :

**importance business × gravité technique × niveau de preuve**

Pas uniquement du nombre de pages touchées.

---

# Ce qui a été détecté mais n'est pas retenu

## [Signal]

**Mesure :** [...]

**Pourquoi ce n'est pas retenu :**

[...]

Exemples :

### `lastmod` ancien

> Un `lastmod` de plus de six mois n'est pas un défaut si le contenu n'a pas été modifié.

### Page sous 300 mots

> La longueur du contenu ne détermine pas son indexabilité.

### Absence de Schema.org

> L'absence de données structurées n'empêche pas l'indexation et doit être auditée séparément.

---

# Ce que les données ne permettent pas de conclure

- le statut d'indexation des URL non inspectées individuellement ;
- la cause exacte d'une URL « explorée mais non indexée » sans données complémentaires ;
- qu'un manque de liens internes explique à lui seul une absence d'indexation ;
- qu'un sitemap ancien signifie que Google n'a pas découvert les URL par d'autres moyens ;
- qu'une page hors sitemap est problématique sans connaître son rôle ;
- qu'une URL inconnue de Google l'est uniquement à cause du maillage.

---

# Priorités

## Priorité 1 — [Action]

**État constaté :**
[...]

**Pourquoi maintenant :**
[...]

**Action précise :**
[...]

**Résultat attendu :**
[Résultat technique recherché.]

**Effort :** [...]
**Confiance :** [...]

---

## Priorité 2 — [Action]

[...]

---

## Priorité 3 — [Action]

[...]
```

## Contrôle de cohérence avant publication

JEV doit bloquer la restitution si :

- le nombre de pages annoncé ne correspond pas aux pages réellement inspectées ;
- une extrapolation est présentée comme une mesure ;
- une URL « inconnue de Google » est automatiquement attribuée au maillage ;
- un statut 200 est interprété comme preuve d'indexation ;
- une URL hors sitemap est automatiquement classée comme défaut ;
- un vieux `lastmod` est automatiquement classé comme problème ;
- absence de données structurées ou faible nombre de mots influencent le score d'indexation ;
- une redirection normale est traitée comme anomalie sans expliquer pourquoi ;
- sitemap, canonical et URL finale sont analysés séparément alors qu'ils se contredisent.

## Règles à interdire

Ne jamais conclure automatiquement :

- `HTTP 200 = indexée` ;
- `hors sitemap = problème` ;
- `1 lien entrant = Google ne découvre pas la page` ;
- `URL inconnue = manque de maillage` ;
- `lastmod ancien = sitemap mauvais` ;
- `moins de 300 mots = problème d'indexation` ;
- `pas de Schema = problème d'indexation` ;
- `quelques URL testées = cluster entier dans le même état` ;
- `HTML initial identique ou vide = pré-rendu cassé` (c'est une suspicion, le protocole de rendu tranche) ;
- `inspection d'URL correcte = pas d'action manuelle ni de problème de sécurité` (l'inspection ne les couvre pas).

La logique doit toujours être :

**URL destinée à Search → accessibilité → statut HTTP → robots → canonical → sitemap → état Google → preuve → action**

## Garde-fous (NON-NÉGOCIABLES)

- **Lecture seule** sur le web public. Aucune requête authentifiée non explicitement autorisée.
- **Aucune action de forçage d'indexation.** Pas de soumission GSC, pas de force-crawl.
- **Pas de modification du site.** Pas de PR sur les fichiers source. Sortie limitée à `reports/` ou directement dans la conversation.
- **Distinction stricte** "non indexée" vs "non testable" dans le rapport.
- **Priorité au signalement** : un `noindex` accidentel sur une page business doit remonter en TOP du rapport, pas en ligne 47 du tableau.
- Si un check échoue, continuer les autres et signaler dans la section "Limites".

> Discipline : observation côté agent, décision côté humain. Un agent qui peut "réparer" peut aussi tout casser un dimanche à 3 h du matin.

## Variante haute fiabilité — GSC URL Inspection API

Si l'utilisateur dispose d'un service account Google Cloud + propriété GSC :
1. Lire la clé JSON via secret stocké côté projet
2. Signer un JWT, échanger contre access token
3. POST sur `https://searchconsole.googleapis.com/v1/urlInspection/index:inspect`
4. Statuts officiels disponibles : `INDEXED`, `DISCOVERED_NOT_INDEXED`, `CRAWLED_NOT_INDEXED`, `URL_IS_UNKNOWN_TO_GOOGLE`

Ce que l'API donne, et ce qu'elle ne donne pas : l'état de la **version connue dans l'index** de Google, avec la date du dernier crawl, pas un test en direct de la version actuellement servie. Une URL modifiée hier peut afficher l'état d'avant-hier. Le rapport écrit donc la date de crawl relevée à côté de chaque verdict, et ne présente jamais ce résultat comme une vérification en temps réel. Setup ~30 minutes. Lève le rate-limit de `site:` (limite officielle 2 000 inspections / jour / propriété).

## La preuve, la conclusion et la priorité doivent correspondre (Tim, 28 septembre 2026, relecture de l'onglet sur organikk.co)

- **« Ce qui bloque réellement » a le droit de répondre « rien de confirmé ».** La rubrique ne transforme pas un écart de configuration en problème pour avoir quelque chose à afficher. Quand rien n'est démontré, l'onglet s'ouvre sur « Aucun défaut d'indexation confirmé sur les N pages inspectées », puis « Vérifications à terminer ». « Confiance forte » porte sur le décompte, jamais sur un impact non établi.
- **Hors sitemap = constat, pas blocage.** Le sitemap signale à Google les URL qu'on souhaite lui montrer ; ce n'est pas la liste des pages autorisées à apparaître, Google découvre aussi par les liens. Une URL absente du sitemap ne prouve pas que son indexation n'a pas été décidée : écrire « l'audit n'a pas encore confirmé le choix du propriétaire pour ces familles », jamais « la question n'a pas de réponse ». Formulation : « N URL ayant reçu des impressions ne figurent pas dans le sitemap actuel. Cet écart ne démontre pas de problème d'indexation. Vérifier quelles familles doivent y figurer, puis y ajouter leurs URL canoniques. Impact négatif non démontré, choix de configuration à confirmer. » Aucun point retiré pour ce seul écart.
- **Le rapport Performance décrit une activité sur une période**, pas l'inventaire des URL indexées aujourd'hui : « 125 URL ont enregistré des impressions entre le 30 juin et le 27 septembre », jamais « Search Console en sert 125 ». Des impressions passées ne confirment pas un statut au jour de l'audit, et comparer des impressions passées au sitemap actuel ne prouve pas une découverte « par d'autres chemins » si l'ancien sitemap n'est pas connu. Contrôler l'état HTTP actuel de ces URL avant toute lecture : sur organikk.co, 95 des 103 URL hors sitemap étaient déjà redirigées ou en 404.
- **Le champ `contents[].indexed` de l'API Sitemaps est obsolète** (Google demande de ne pas l'utiliser). Ne jamais le lire, ne jamais en tirer « compteur non fiable ». Si un chiffre vient de l'interface, donner le nom exact du rapport, son filtre et sa date ; le rapport Sitemaps montre des pages découvertes, l'indexation se lit dans le rapport d'indexation des pages filtré par sitemap. En attendant : « écart entre les données affichées et les inspections individuelles, origine à vérifier, non utilisé pour conclure ».
- **Le rendu compare deux versions**, HTML initial et DOM après rendu, sur le texte normalisé du contenu principal et sur l'ensemble des destinations des liens du corps, jamais sur un nombre de mots ou de liens (884 = 884 prouve une quantité, pas un texte). L'inspection d'URL ne fournit pas le HTML de la version connue de Google : le statut et la canonical sélectionnée se vérifient séparément par elle. N'écrire « trois versions » que si le HTML exploré a été récupéré dans l'interface. Conclusion : « sur les N pages testées, le contenu principal et les liens utiles sont présents dans le HTML initial, aucun écart observé après rendu », jamais « aucune dépendance au rendu » pour tout le site.
- **Les URL référentes de l'inspection ne mesurent pas le maillage.** Champ `referringUrls` vide = « aucune page référente renseignée », pas « aucune » ; une référente peut être indirecte. `sitemap` et `referringUrls` sont deux champs : deux colonnes, « sitemap signalé » et « pages référentes renseignées ». Le nombre de liens entrants se conclut dans l'onglet Maillage, depuis le crawl.
- **robots.txt : afficher l'évaluation, pas la présence d'un `Allow`.** Groupes présents, règles `Disallow`, règle la plus spécifique applicable à Googlebot, résultat par URL.
- **Terminer les vérifications ouvertes par ses propres mesures** avant d'élargir : inspecter les URL du sitemap non inspectées (au moins celles citées), contrôler les paires avec et sans slash (HTTP, redirections, canonicals déclarées et sélectionnées, période des impressions), inspecter les URL hors sitemap importantes une par une plutôt que traiter le lot comme homogène. Si le périmètre est volontairement limité, le titre l'assume : « diagnostic des N pages prioritaires avec contrôles complémentaires », pas « validation de l'indexation du site ».
- **Une redirection vers une page sans rapport est un finding** : 301 seulement vers la page qui remplace réellement le contenu, sinon 404 ou 410. Un lot d'anciennes URL redirigé vers une page d'offre se relève, se chiffre et se propose en correction « à valider avant déploiement ».
- **Le titre de l'onglet est le diagnostic**, pas un relevé : « Indexation : 3 pages d'offre ne sont pas indexées », puis la ligne des comptes (URL au sitemap · indexées · découvertes non indexées · inconnues · URL avec au moins une impression sur la période). « N URL ont généré au moins une impression sur 90 jours », jamais « servies par Google ». L'onglet répond à une seule question : Google peut-il découvrir, explorer, comprendre et indexer les URL qu'on veut rendre visibles ? Ce qu'obtiennent ces pages une fois indexées relève d'un autre onglet.
- **Dissocier les cas page par page** quand les données le permettent : un tableau page / rôle / signal principal / action prioritaire. 0 lien entrant → liens et sitemap ; 1 lien → découverte ; N liens et non indexée → le maillage n'est pas la cause, examiner contenu, doublon, canonical, rendu, valeur distinctive. Une recommandation générique là où une hypothèse est déjà éliminée est une faute.
- **Tester la réponse selon la langue du navigateur** sur tout site à plusieurs versions : la même URL demandée en `fr-FR` et en `en-US` doit répondre 200 avec le même canonical ; un 302 conditionnel vers l'autre version est un finding (Google déconseille la redirection automatique selon la langue, chaque version doit rester accessible et reliée par `hreflang`). C'est une cause à rattacher au finding de non-indexation quand les URL concernées coïncident, pas un second finding.
- **Restitution courte** : synthèse visible (verdict, findings établis, ce qui ne bloque pas, conclusion), preuves détaillées dans des blocs repliés, sans répéter un même chiffre dans trois tableaux. Les paragraphes « pourquoi le corriger » concluent le diagnostic, ils ne réexpliquent pas le SEO. « 5 inspections Google et contrôles du rendu ; 30 contrôles HTTP et directives » plutôt que « pages testées : 5 ». « Les 3 URL inexistantes testées renvoient une 404 ; ce test ne couvre pas toutes les pages » plutôt que « soft 404 : 0 ». Pas d'octets dans la synthèse client.

## Contrôle du rendu (Tim, 28 septembre 2026 — protocole obligatoire avant de noter un contenu)

Remplace l'ancienne « variante SPA » réservée aux cas extrêmes. Le contrôle tourne sur **les pages importantes et les principaux gabarits** (un exemplaire par famille de pages), pas seulement quand un site a l'air d'une SPA.

Trois versions de la même page, comparées dans cet ordre :

1. **HTML initial** : ce que le serveur sert (`curl -sL -A "Mozilla/5.0" {URL}`).
2. **DOM après rendu** : Playwright ou Chrome headless, chargement complet, attente `networkidle`.
3. **Version observée par Google**, quand l'accès le permet : URL Inspection API (HTML rendu et capture d'écran du dernier crawl) ou l'outil d'inspection dans l'interface Search Console.

Sur chacune des trois, relever les mêmes cinq éléments : **contenu principal** (présent, absent, différent), **liens utiles** (les liens éditoriaux du corps, pas la nav), **title**, **directives robots** (meta et en-tête), **canonical**. Le résultat est un tableau 5 lignes × 3 colonnes par page contrôlée, avec les écarts marqués.

**Ce que le contrôle a le droit de conclure.** Un HTML initial sans contenu principal, ou identique entre plusieurs URL, ne démontre pas un rendu cassé : certaines applications génèrent le contenu principal en JavaScript, et Google utilise le HTML rendu pour l'indexation. La sortie autorisée est :

> Suspicion de dépendance au rendu ou de problème de pré-rendu : vérifier avant de conclure.

Jamais, automatiquement :

> Pré-rendu cassé.

Le finding ne devient un défaut confirmé que si la version 2 ou la version 3 manque effectivement le contenu principal, un lien utile, le title, une directive ou la canonical présents ailleurs, ou porte une valeur différente (canonical qui change entre initial et rendu, noindex injecté en JS, contenu de la home servi sous une autre URL après rendu).

Tant que ce contrôle n'a pas tourné sur une page, son contenu ne se note pas (`seo-contenu-pertinence`, `seo-structure-hn`) : on ne juge pas une réponse dont on ne sait pas quelle version on a lue.

## Actions manuelles et problèmes de sécurité (quand l'accès GSC le permet)

L'inspection d'URL ne couvre ni les actions manuelles ni les problèmes de sécurité : un résultat d'inspection correct ne suffit pas à les exclure. Quand la propriété Search Console est accessible, ouvrir les deux rapports dédiés de l'interface (Sécurité et actions manuelles) et relever ce qu'ils affichent, date comprise. Sans accès : écrire « actions manuelles et problèmes de sécurité non vérifiés, accès Search Console requis », jamais « aucun ».

## Récurrence — programmation via `/schedule`

Pour transformer l'audit ponctuel en monitoring continu :
```
/schedule
```
Choix structurants :
- **Récurrence** : `cron_expression: "0 1 1 * *"` (1er de chaque mois, 01h UTC)
- **Alternative one-shot** : `run_once_at` à J+14 après un déploiement de cluster
- **Modèle** : `claude-sonnet-4-6` (Opus inutile pour ce job)
- **Tools** : `Bash, Read, Write, Edit, Glob, Grep`
- **Environment** : Default Anthropic Cloud

À chaque exécution : 5 à 10 min de tourner-en-fond, rapport posté dans la conversation (ou push d'une PR si configuré côté repo).

## Réutilisation client

Pour appliquer ce skill à un client en accompagnement :
1. Créer un fichier `urls-prio.txt` dans son repo (top 30 pages business) OU pointer le sitemap public
2. Adapter le périmètre du maillage (hubs spécifiques au site)
3. Schedule cron mensuel
4. Inclure le rapport mensuel dans la note de suivi

Coût marginal par client : ~15 min de setup, 0 € récurrent. À facturer dans la rétro mensuelle ou comme bonus différenciant en pitch.

## Concepts liés

`grounding-score` · `passage-ranking`




## Contrôle avant livraison
Vérifier la demande, les données réellement consultées, les fichiers produits, les sources, les limites et le périmètre autorisé. Chaque fait doit être traçable. Indiquer les contrôles non exécutés. Ne publier ni modifier un site distant sans autorisation.

Le 11 novembre, le contrôle technique a examiné 251 URL en 71 secondes : 89 dans le sitemap et 162 hors sitemap. Les 89 URL du sitemap répondaient 200, sans redirection, avec une balise canonique pointant vers elles-mêmes et sans noindex. Le fichier robots.txt ne contenait aucune règle Disallow.

Une URL absente du sitemap reste un constat à interpréter, pas un blocage confirmé. De même, le rapport Performance de Search Console décrit une activité sur une période ; il ne constitue pas un inventaire des pages indexées.

Examiner les dates du sitemap et tester des URL inexistantes

Le champ <lastmod> doit correspondre à une date de modification exacte et vérifiable. Les champs <priority> et <changefreq> ne sont pas utilisés par Google selon la documentation citée dans le relevé.

Le 11 novembre, les 89 URL du sitemap portaient la même date, à la milliseconde près. Le rapport a conservé ce constat dans la rubrique des anomalies détectées mais non retenues comme blocages. Aucune date n’avait plus de six mois et, sans les dates réelles de modification, leur exactitude ne pouvait pas être vérifiée. La routine du lundi continue de signaler cette anomalie récurrente.

Le gabarit prévoit aussi de tester des URL inexistantes pour repérer d’éventuelles soft 404, des pages d’erreur qui renvoient une réponse de succès. Les six adresses inventées pour l’essai ont répondu 404, avec une page d’erreur en noindex. Ce test ne couvre pas toutes les pages du site.

Inspecter les URL prioritaires dans Search Console

L’inspection d’URL renseigne sur la version connue de Google et sur la date de sa dernière exploration. Elle ne teste pas en direct la version actuellement accessible sur le site.

Cette différence compte : le 11 novembre, dix URL répondaient 404 tout en restant classées « Envoyée et indexée ». Google les avait explorées entre le 20 juillet et le 5 novembre.

Le relevé mentionne des limites de 2 000 inspections par jour et 600 par minute, par site. L’essai a inspecté 135 URL en six minutes : les 89 du sitemap et 46 hors sitemap.

L’API fournit la date de dernière exploration, la balise canonique déclarée et celle retenue par Google. Elle ne renvoie ni le HTML rendu ni une capture d’écran. Les actions manuelles et les problèmes de sécurité doivent être consultés dans l’interface Search Console. Sans cet accès, le rapport les indique comme non vérifiés.

Marquer les inspections interrompues comme non testées

La routine cloud du lundi n’a accès ni à l’inspection d’URL ni aux données Search Console. Son rapport du 9 novembre signalait que cette partie du contrôle avait échoué lors de 13 exécutions consécutives.

Le 11 novembre, une première série de 248 inspections a commencé à 15 h 02 et s’est arrêtée à 17 h 01 après une coupure de connexion. Le script utilisé pour cette relance, distinct du skill fourni, n’enregistrait ses résultats qu’à la fin. Aucun résultat n’a été conservé et le quota consommé reste inconnu.

Ces 248 inspections sont donc marquées « non testé ». Dans le bilan final, les 116 URL hors sitemap non inspectées restent classées « non inspectée », sans être déclarées non indexées.

Lire les 34 cas de non-indexation parmi les 89 URL du sitemap

Le 11 novembre, 55 des 89 URL du sitemap étaient indexées, soit 62 %. Les 34 autres se répartissaient ainsi :

Statut relevéNombre d’URL
Inconnue de Google16
Détectée, mais non indexée16
Explorée, mais non indexée1
En double1

Ces 34 URL correspondent à 22 pages vidéo, cinq guides, deux versions anglaises, deux articles, deux pages du bootcamp et /systeme-ia/. Aucune n’a enregistré d’impression sur les 90 jours étudiés. Les 17 pages d’offre, de contact et de prix étaient toutes indexées.

Le cas de /systeme-seo/ est distinct. Cette page porte un noindex et ne figure pas dans le sitemap. Sur 104 pages explorées, 86 contiennent un lien vers elle ; 99 URL y redirigent en 301. Parmi ces URL redirigées, 61 avaient reçu 515 impressions sur 90 jours.

Onze des 99 URL ont été inspectées. Deux, explorées les 27 et 28 octobre, sont exclues de l’index en raison du noindex de leur destination. Sept, explorées avant le 7 octobre, restent indexées. Ces observations ne permettent pas d’affirmer que les 99 URL sont sorties de l’index.

Décider quelles URL en erreur restaurer, rediriger ou conserver

La méthode réserve une redirection 301 à une page qui remplace réellement le contenu supprimé. Sinon, elle prévoit de conserver une réponse 404 ou 410, selon la décision prise.

La documentation Google citée dans le relevé regroupe les erreurs 4xx, à l’exception de la 429, dans un même traitement général. Les redirections permanentes 301 et 308 signalent une destination durable ; les 302 et 307 sont temporaires. Le choix de l’URL affichée par Google ne doit pas être présenté comme une conséquence automatique de ce seul code HTTP.

Sur organikk.co, 21 URL en erreur avaient reçu 470 impressions sur 90 jours : 334 impressions pour 19 URL en 404 et 136 pour deux URL en 410. Parmi les 19 URL en 404, 16 l’étaient déjà le 22 septembre.

Les deux pages en 410, /methode/ et /bootcamp/, apparaissent comme « Introuvable (404) » dans l’inspection. Le rapport conserve leur suppression, qui est volontaire et annoncée sur la page.

Les 19 autres URL restent à vérifier, faute de page de remplacement confirmée ou de requêtes suffisamment documentées. Par exemple, /outils/analyse-geo/ a reçu 48 impressions, dont 21 sur « analyse geo » et six sur « audit geo ». La page /pre-audit-seo-geo/ a été envisagée comme destination, mais son équivalence n’a pas été établie. La restauration ou la redirection reste donc à valider avant déploiement.

Le rapport de la routine du 9 novembre signalait aussi /manifeste en 404 pour la 21e fois. La recommandation datait du 10 juin, soit 152 jours plus tôt : une anomalie répétée dans un rapport n’est pas nécessairement une anomalie corrigée.

04 · Mesurer la vitesse sur mobile en séparant tests et données de visiteurs

Tester un échantillon du sitemap avec Lighthouse mobile

Le skill lance Lighthouse en mode mobile sur 50 URL du sitemap par défaut, avec trois tests en parallèle. Le mode all permet de mesurer tout le sitemap.

Prompt
/seo-core-web-vitals Mesure la vitesse de [DOMAINE] à partir de [ADRESSE DU SITEMAP].

Sépare les mesures Lighthouse des données terrain. Pour chaque mesure, précise l’URL ou l’origine, l’appareil, la période, la version de l’outil et les éventuels contrôles non exécutés.

Si un outil manque, signale-le avant de l’installer. Ne modifie pas le site.
~/.claude/skills/seo-core-web-vitals/SKILL.md · 3 502 mots
---
name: seo-core-web-vitals
description: |
  Audit Core Web Vitals (LCP, CLS, TBT) d'un site via Lighthouse local sur un échantillon d'URLs depuis sitemap.xml. Mobile-first. Produit un tableau de scores par URL + problèmes récurrents site-wide + plan de correction priorisé pour les 5 pires pages. Sortie obligatoire en plus du tableau : un rapport de pré-décision (diagnostic, preuves typées, état Critique / À améliorer / Sain, actions P1-P3 avec confiance, effort et risque, jamais de score affiché) ; sans lui le skill n'a pas terminé.

  TOUJOURS utiliser ce skill quand l'utilisateur dit : "audit Core Web Vitals", "audit CWV", "perf SEO", "LCP CLS TBT", "Lighthouse audit", "vitesse de chargement", "audit performance site", "pourquoi mon site est lent en SEO", "PageSpeed score", "audit perf mobile", "score Lighthouse", "audit Web Vitals".

  Skill du périmètre SEO technique. Complémentaire de `indexation-check`, `seo-donnees-structurees`, `seo-cannibalisation`, `maillage-systeme`.
---

# Skill — Audit Core Web Vitals (Lighthouse local)

## Quand déclencher

Diagnostic de performance SEO d'un site complet, ou avant intervention technique (refonte, optimisation perf, migration). Toujours mobile (Google = mobile-first indexing).

## Pré-requis (à vérifier en début de skill)

```bash
which lighthouse || echo "MANQUANT — installer : npm install -g lighthouse"
which jq || echo "MANQUANT — installer : brew install jq"
```

Si Lighthouse manque, proposer `npm install -g lighthouse` à l'utilisateur et stopper. Ne pas installer silencieusement.

Alternative sans install globale : remplacer `lighthouse` par `npx lighthouse` dans toutes les commandes (premier lancement plus lent).

## Input requis

| Source | Obligatoire | Défaut |
|--------|-------------|--------|
| URL du sitemap.xml (ex. `https://site.com/sitemap.xml`) | Oui | — |
| Échantillon | Non | 50 URLs |
| Mode `all` (audit toutes les URLs du sitemap) | Non | off |

## Pipeline (5 étapes)

### Étape 1 — Récupérer le sitemap

```bash
SITEMAP_URL="<url>"
curl -sL "$SITEMAP_URL" | grep -oE '<loc>[^<]+</loc>' | sed -E 's|</?loc>||g' > /tmp/cwv-urls.txt
wc -l /tmp/cwv-urls.txt
```

**IMPORTANT (compat BSD/macOS)** : utiliser `sed -E 's|</?loc>||g'` et **PAS** `sed 's|</\?loc>||g'` — le `\?` ne marche pas en sed BSD (macOS) et laisse les balises intactes silencieusement.

**Si le sitemap est un index** (contient `<sitemapindex>` au lieu de `<urlset>`), récupérer le premier sitemap enfant et l'utiliser :

```bash
FIRST_CHILD=$(curl -sL "$SITEMAP_URL" | grep -oE '<loc>[^<]+</loc>' | sed -E 's|</?loc>||g' | head -1)
curl -sL "$FIRST_CHILD" | grep -oE '<loc>[^<]+</loc>' | sed -E 's|</?loc>||g' > /tmp/cwv-urls.txt
```

### Étape 2 — Échantillonner

```bash
TOTAL=$(wc -l < /tmp/cwv-urls.txt | tr -d ' ')
if [ "$TOTAL" -gt 50 ] && [ "$MODE" != "all" ]; then
  head -50 /tmp/cwv-urls.txt > /tmp/cwv-sample.txt
else
  cp /tmp/cwv-urls.txt /tmp/cwv-sample.txt
fi
wc -l /tmp/cwv-sample.txt
```

Les 50 premières URLs du sitemap sont généralement les plus prioritaires (homepage, hubs, top articles). Si l'utilisateur demande `all`, auditer toutes les URLs.

### Étape 3 — Lancer Lighthouse mobile en parallèle (3 workers)

```bash
rm -rf /tmp/cwv-results /tmp/cwv-errors.log
mkdir -p /tmp/cwv-results
cat /tmp/cwv-sample.txt | xargs -I {} -P 3 sh -c '
  url="$1"
  hash=$(echo -n "$url" | md5)
  lighthouse "$url" \
    --output=json \
    --output-path="/tmp/cwv-results/${hash}.json" \
    --only-categories=performance \
    --form-factor=mobile \
    --screenEmulation.mobile=true \
    --chrome-flags="--headless=new --no-sandbox" \
    --quiet 2>/dev/null || echo "FAIL: $url" >> /tmp/cwv-errors.log
' _ {}
echo "Results: $(ls /tmp/cwv-results/ 2>/dev/null | wc -l | tr -d ' ')"
[ -f /tmp/cwv-errors.log ] && echo "Errors:" && cat /tmp/cwv-errors.log
```

**IMPORTANT (zsh-safe)** : utiliser `rm -rf /tmp/cwv-results && mkdir -p /tmp/cwv-results` et **PAS** `rm -f /tmp/cwv-results/*` — le glob vide fait gueuler zsh (`no matches found`) et l'exit code 1 peut interrompre la suite.

**`--headless=new`** (et pas `--headless` legacy) — plus stable depuis Chrome 109+, requis pour Lighthouse 13.

**Compter** : ~15-30 secondes par URL avec 3 workers parallèles. 50 URLs ≈ 5-10 min.

### Étape 4 — Parser les résultats

Pour chaque JSON dans `/tmp/cwv-results/`, extraire avec jq (chemin Lighthouse 13) :

```bash
for f in /tmp/cwv-results/*.json; do
  jq '{
    url: .finalDisplayedUrl,
    lcp_ms: (.audits."largest-contentful-paint".numericValue // 0),
    cls: (.audits."cumulative-layout-shift".numericValue // 0),
    tbt_ms: (.audits."total-blocking-time".numericValue // 0),
    score: ((.categories.performance.score // 0) * 100),
    lcp_element: [.audits."lcp-breakdown-insight".details.items[]? | select(.type == "node") | {selector, snippet, nodeLabel}] | .[0],
    lcp_breakdown: [.audits."lcp-breakdown-insight".details.items[]? | select(.type == "table") | .items[]? | {subpart, label, duration_ms: .duration}],
    opportunities: [.audits | to_entries[] | select(.value.details.type == "opportunity" and (.value.details.overallSavingsMs // 0) > 100) | {id: .key, title: .value.title, savings_ms: .value.details.overallSavingsMs}] | sort_by(-.savings_ms) | .[0:5]
  }' "$f"
done | jq -s '.' > /tmp/cwv-parsed.json
echo "Parsed: $(jq 'length' /tmp/cwv-parsed.json) URLs"
```

**Chemins clés Lighthouse 13** :
- URL finale : `.finalDisplayedUrl` (et **PAS** `.finalUrl` qui peut être null)
- LCP element : `.audits."lcp-breakdown-insight".details.items[] | select(.type == "node")` (et **PAS** `.audits."largest-contentful-paint-element"` qui est null depuis LH 13)
- LCP breakdown (TTFB / render delay / load delay) : `.audits."lcp-breakdown-insight".details.items[] | select(.type == "table") | .items[]` — utile pour diagnostiquer **où** se passe le temps LCP

**Seuils Google (à appliquer pour le verdict)** :

| Métrique | Good | Needs Improvement | Poor |
|----------|------|-------------------|------|
| LCP | < 2500 ms | 2500-4000 ms | > 4000 ms |
| CLS | < 0.1 | 0.1-0.25 | > 0.25 |
| TBT (proxy INP) | < 200 ms | 200-600 ms | > 600 ms |
| Score perf | ≥ 90 | 50-89 | < 50 |

### Étape 5 — Produire le rapport markdown

Voir section "Output obligatoire" ci-dessous.

### Étape 4bis — Détection automatique du pattern "redirect sitemap"

Si l'opportunity `redirects` apparaît sur **>50% des pages auditées** avec un gain moyen >300ms : c'est quasi-certainement un mismatch de trailing slash entre le sitemap et le serveur.

```bash
REDIRECT_COUNT=$(jq -r '.[] | .opportunities[] | select(.id == "redirects") | .id' /tmp/cwv-parsed.json | wc -l | tr -d ' ')
TOTAL=$(jq 'length' /tmp/cwv-parsed.json)
if [ "$REDIRECT_COUNT" -gt $((TOTAL / 2)) ]; then
  echo "⚠️ ALERTE : $REDIRECT_COUNT/$TOTAL pages ont une redirection. Vérifier le trailing slash du sitemap vs serveur."
fi
```

Ce pattern doit être mis EN TÊTE du rapport — c'est le quick win le plus rentable quand il est présent.

### Étape 4ter — Données terrain, LCP / INP / CLS au 75e percentile (Tim, 28 septembre 2026)

Lighthouse reste pour le diagnostic. L'évaluation des Core Web Vitals, elle, repose sur les données terrain : les ajouter chaque fois qu'elles existent, pour les pages business prioritaires et l'origine.

Source gratuite : l'API PageSpeed Insights, qui renvoie le champ terrain CrUX en plus du test.

```bash
# clé API Google gratuite dans $PSI_KEY ; strategy = mobile, puis desktop si justifié
curl -s "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=${URL}&strategy=mobile&key=${PSI_KEY}" \
| jq '{
    url_scope:    .loadingExperience.id,
    url_lcp_p75:  .loadingExperience.metrics.LARGEST_CONTENTFUL_PAINT_MS.percentile,
    url_inp_p75:  .loadingExperience.metrics.INTERACTION_TO_NEXT_PAINT.percentile,
    url_cls_p75:  .loadingExperience.metrics.CUMULATIVE_LAYOUT_SHIFT_SCORE.percentile,
    url_verdict:  .loadingExperience.overall_category,
    origin_scope: .originLoadingExperience.id,
    origin_lcp_p75: .originLoadingExperience.metrics.LARGEST_CONTENTFUL_PAINT_MS.percentile,
    origin_inp_p75: .originLoadingExperience.metrics.INTERACTION_TO_NEXT_PAINT.percentile,
    origin_cls_p75: .originLoadingExperience.metrics.CUMULATIVE_LAYOUT_SHIFT_SCORE.percentile,
    origin_verdict: .originLoadingExperience.overall_category
  }'
```

Règles de lecture :

- **Le périmètre précède le chiffre** : URL ou origine, mobile ou desktop, 75e percentile, 28 jours. Quand `loadingExperience` est absent et que seul `originLoadingExperience` répond, PageSpeed est retombé sur l'origine : la valeur décrit le site, pas la page, et le rapport l'écrit.
- **Mobile par défaut, desktop aussi** quand l'usage du site ou un écart entre les deux appareils justifie l'analyse.
- **L'INP ne vient que d'ici.** Le TBT du test ne le remplace pas.
- **Sans données terrain** (site trop peu visité, URL sans échantillon) : « Expérience réelle non évaluée ; les mesures de test, elles, sont disponibles. » Ni échec ni validation des Core Web Vitals.
- Ne jamais présenter un écart terrain / test comme une contradiction : les deux répondent à des questions différentes.

## Sortie de pré-décision (obligatoire)

Ce skill n'a pas terminé tant que le rapport de pré-décision n'est pas écrit. Il fait partie de la sortie, au même titre que le tableau, et applique le format de restitution décrit ci-dessous. Fichier : `wiki/audit/YYYY-MM-DD-slug-performance-decision.md`.

Ce qu'il contient, dans cet ordre :

1. Diagnostic principal : une phrase, la cause structurante, pas une liste d'erreurs
2. Les chiffres à retenir : 3 à 5, ceux qui illustrent le diagnostic
3. État : Critique, À améliorer ou Sain, calculé sur l'impact SEO réel et le type de page, jamais sur le nombre d'erreurs ; jamais de score sur 10
4. Problèmes (3 maximum) et opportunités (5 maximum), séparés : chacun avec Preuve (2 à 4 données), Pourquoi c'est important, Action, Confiance (forte / moyenne / faible) ; chaque problème s'écrit en trois temps : observation prouvée → conséquence ou risque justifié → bénéfice attendu de la correction (l'observation seule n'est pas un frein SEO démontré)
5. Actions P1 / P2 / P3, 3 P1 maximum : pourquoi, preuve, signal attendu (jamais un résultat chiffré promis), dépendance préalable, test de validation (ce qui distingue « correction appliquée » de « résultat SEO observé »), effort faible / moyen / élevé (jamais en heures), confiance, risque low / medium / high ; toute action high (suppression, 301, fusion, changement d'URL) porte « À valider avant déploiement » et sa checklist
6. Ce que les données ne permettent pas de conclure, et « données insuffisantes » ou « ne rien faire » quand c'est le cas

Sur le périmètre de ce skill, le rapport tranche la performance Lighthouse mobile (jamais « Core Web Vitals » sans CrUX ; INP « non mesuré », TBT proxy technique) : une phrase globale puis Page / LCP / Importance, performance × importance de la page, les pages stratégiques seulement.

Règles : chaque information est typée FACT, HYPOTHESIS ou ACTION, jamais une hypothèse écrite comme un fait ; un problème existe une seule fois (ID), les observations qui parlent du même problème fusionnent ; une anomalie n'est pas une priorité par défaut ; les pages business et les tendances GSC passent avant les anomalies techniques secondaires ; jamais de recommandation automatique de fusion, 301, suppression, réécriture ou création de page ; Google n'est jamais anthropomorphisé. Phrases courtes, une donnée par diagnostic, aucune des phrases « Il est important de », « Il convient de », « Cela peut potentiellement », « Il est intéressant de noter », « Dans le cadre de ».

Restitution (corrections V2 du 23 septembre) : aucun ID technique ni mot anglais (low / medium / high) dans le rapport ; Faible / Moyen / Élevé partout ; la certitude affichée ne dépasse jamais la couverture des données (« aucun problème majeur détecté sur les URL inspectées », pas « Sain ») ; formulations précises (« URL en 404 avec encore des impressions ») ; aucune action proposée sur une page dont les requêtes ne sont pas connues (« à vérifier ») ; le nombre de mots seul n'est jamais un problème ; limites de longueur : diagnostic 70 mots, 4 chiffres, 3 problèmes de 40 mots, 6 actions, 3 opportunités de 35 mots, le reste dans les détails repliés.

Onglet Analyse technique, structure validée le 23 septembre 2026 : chaque priorité = une phrase de cadrage, « Ce qu'on observe » (faits chiffrés en liste, pages en code), « Pourquoi c'est prioritaire » (deux phrases), « Action » (liste numérotée courte), « Impact attendu » et « Risque » en gras ; puis le plan des 30 jours en trois paliers (Priorité immédiate, Deuxième étape, Priorité secondaire), une action par paragraphe en gras suivie d'une phrase ; puis « à surveiller avant d'agir » pour la page dont la cause n'est pas isolée ; puis « Autres pages à surveiller » : chiffres séparés par « · », une phrase, verdict en gras (« Aucune action recommandée », « À vérifier avant toute modification »).

## Output obligatoire

Gabarit de l'onglet Vitesse (Tim, 26 septembre 2026). Chaque placeholder `[...]` vient d'une mesure réelle ou n'apparaît pas.

```markdown
# Vitesse

[Nombre] pages mesurées sur [nombre total], uniquement sur leur URL canonique.

**Source principale :** [Lighthouse mobile / PageSpeed Insights / CrUX]
**Type de mesure :** [test / terrain]
**Score Lighthouse médian :** [XX]/100

## Chiffres à retenir

| Mesure | Résultat |
|---|---:|
| **Score Lighthouse médian** | [XX]/100 |
| **LCP médian** | [X,XX s] |
| **Pages avec LCP > 4 s** | [XX / XX] |
| **CLS médian** | [X,XXX] |
| **Pages avec CLS > 0,25** | [XX / XX] |
| **TBT médian** | [XX ms] |
| **TTFB médian** | [XXX ms] |
| **Page business la plus exposée** | `[URL]` · [impressions] impressions · LCP [X,XX s] |

---

## Ce que les mesures montrent

### LCP

**[XX sur XX] pages dépassent [seuil].**

LCP médian : **[X,XX s]**
Fourchette observée : **[X,XX s à X,XX s]**

[Interprétation courte.]

Exemple :

> Le problème n'est pas limité à quelques URL : il apparaît sur l'ensemble du gabarit testé. Cela oriente davantage vers une cause commune qu'un problème propre à une seule page.

Ne pas conclure à la cause à ce stade.

---

### CLS

CLS médian : **[X,XXX]**

- [XX] pages dans la zone correcte ;
- [XX] pages à surveiller ;
- [XX] pages dégradées.

[Interprétation.]

Si aucun problème :

> Aucun problème généralisé de stabilité visuelle n'est détecté.

---

### Interactivité

**TBT test :** [XX ms]

Le TBT sert uniquement d'indicateur test. Il ne doit pas être présenté comme une mesure INP réelle.

Si aucune donnée terrain n'est disponible :

> L'INP réel des visiteurs n'est pas mesurable avec ce relevé.

---

## Terrain et test

### Données test

- Lighthouse : [version]
- appareil simulé : [mobile]
- réseau / CPU : [conditions]
- nombre de pages : [XX]
- nombre de passages par page : [X]

### Données terrain

[CrUX disponible / CrUX indisponible]

Si disponible, le périmètre d'abord, sans lui le chiffre ne se lit pas : **[URL / origine] · [mobile / desktop] · 75e percentile · 28 derniers jours**. Une valeur d'origine ne décrit pas la page : le dire quand PageSpeed est retombé sur l'origine faute de données pour l'URL.

| Mesure terrain (p75) | Résultat |
|---|---:|
| LCP | [X,XX s] |
| INP | [XXX ms] |
| CLS | [X,XXX] |
| TTFB | [XXX ms] |

Si indisponible :

> Expérience réelle non évaluée ; les mesures de test, elles, sont disponibles.

Ce n'est ni un échec des Core Web Vitals ni une validation de ceux-ci : l'évaluation des Core Web Vitals repose sur les mesures terrain, et elles manquent.

Ne jamais présenter une différence terrain / test comme une contradiction : les deux mesures répondent à des questions différentes.

---

## Qualité de la mesure

### Variance observée

Une même URL mesurée plusieurs fois donne :

- run 1 : [score / LCP]
- run 2 : [score / LCP]
- run 3 : [score / LCP]

**Lecture :**

> Un score Lighthouse isolé ne doit pas être interprété au point près. La tendance globale, la médiane et les problèmes répétés entre plusieurs pages sont plus fiables que le classement individuel d'une URL.

---

### Mesures écartées

[Décrire ici toute première passe faussée.]

Exemples :

- URL redirigées ;
- mauvaise variante canonique ;
- pages inexistantes servant un fallback ;
- cache différent ;
- timeout ;
- mesure interrompue.

**Pourquoi elles sont écartées :**

[Explication.]

Ne jamais mélanger ces mesures avec le relevé final.

---

## Décomposition du problème

### TTFB

**TTFB médian : [XXX ms]**

Fourchette : [XXX à XXX ms]

**Lecture :**

[correct / à surveiller / dégradé]

Ne conclure à un problème d'hébergement que si les données le permettent.

---

### Temps restant jusqu'au LCP

LCP médian : [X,XX s]
TTFB médian : [X,XX s]

Temps après réponse serveur : **≈ [X,XX s]**

Cela indique que la majeure partie du délai intervient [avant / après] la réponse serveur.

Ne pas attribuer automatiquement ce temps à une cause précise.

Les causes possibles peuvent inclure :

- délai de découverte de la ressource LCP ;
- téléchargement de l'image ou de la police ;
- CSS bloquant ;
- JavaScript ;
- délai de rendu ;
- élément LCP injecté tardivement.

Ces causes restent des hypothèses tant qu'elles ne sont pas mesurées.

---

## Pages à regarder en priorité

| Page | Importance business | Impressions / trafic | LCP | Score | Pourquoi la regarder |
|---|---|---:|---:|---:|---|
| `[URL]` | Forte | [XXX] | [X,XX s] | [XX] | page business exposée |
| `[URL]` | Forte | [XXX] | [X,XX s] | [XX] | même problème |
| `[URL]` | Moyenne | [XXX] | [X,XX s] | [XX] | contrôle du gabarit |

La priorité ne dépend pas uniquement de la page la plus lente.

Croiser :

**gravité technique × importance business × exposition réelle**

---

# Priorités

## 1. [Nom précis du problème]

**État constaté**

[Uniquement les faits mesurés.]

**Preuve**

[Valeurs et pages concernées.]

**Action**

[Action technique précise.]

**Pourquoi le corriger**

[Conséquence défendable.]

**Impact :** [fort / moyen / faible]
**Confiance :** [forte / moyenne / faible]
**Effort :** [faible / moyen / fort]

---

## 2. [Deuxième problème]

Même structure.

---

## 3. [Troisième problème]

Même structure.

---

# Ce qui n'est pas retenu comme problème

### [Signal]

**Mesure :** [valeur]

**Pourquoi il n'est pas retenu :**

[Expliquer pourquoi le signal ne suffit pas.]

Exemples :

> Un score Lighthouse de 68 au lieu de 74 n'est pas en soi une anomalie.

> Une différence entre deux runs ne prouve pas une régression.

> Un TTFB correct n'exclut pas un problème de rendu.

---

# Ce que cette mesure ne permet pas de conclure

- Lighthouse ne mesure pas directement l'expérience réelle de tous les visiteurs.
- TBT n'est pas INP.
- Une corrélation entre une métrique et un composant ne démontre pas sa causalité.
- Une seule passe par URL ne permet pas une comparaison au point près.
- Sans décomposition du LCP, la cause précise ne doit pas être affirmée.
- Sans données CrUX, aucune conclusion sur les Core Web Vitals réels du site ne doit être présentée comme mesurée.
```

## Règles de validation

Un finding de vitesse ne peut être publié que si :

1. la mesure provient de la bonne URL canonique ;
2. les erreurs et redirections parasites ont été écartées ;
3. le problème est reproductible ou visible sur plusieurs pages ;
4. test et terrain ne sont pas mélangés ;
5. la cause n'est pas affirmée sans preuve ;
6. l'impact est distingué du simple score Lighthouse ;
7. les pages business sont prioritaires sur les pages secondaires.

## Règles à interdire

Ne jamais conclure automatiquement :

- `score Lighthouse < 90 = problème` ;
- `TTFB élevé = hébergement mauvais` ;
- `LCP élevé = image trop lourde` ;
- `terrain ≠ test = contradiction` ;
- `une redirection = cause du mauvais score` ;
- `une seule mesure = vérité de la page` ;
- `TBT = INP` ;
- `page la plus lente = priorité SEO n°1`.

Le diagnostic doit toujours suivre :

**mesure → validation de la mesure → localisation du problème → hypothèse de cause → preuve → action**

## Règles absolues

- **Mobile par défaut ; desktop également lorsque son usage ou ses résultats justifient l'analyse** (reformulé le 28/09/2026, remplace « jamais desktop »). Un site B2B lu majoritairement au bureau, ou un écart terrain net entre les deux appareils, justifie la mesure desktop, avec son périmètre écrit.
- **TBT ne remplace pas l'INP.** Le TBT est un indicateur test qui aide à repérer des problèmes de réactivité ; il peut manquer des problèmes d'interaction réels et signaler des blocages que les visiteurs ne rencontrent pas. L'INP ne se lit que dans les données terrain (étape 4ter). Toujours l'écrire dans le rapport.
- **Sans données terrain**, la phrase fixe : « Expérience réelle non évaluée ; les mesures de test, elles, sont disponibles. » Ce n'est ni un échec des Core Web Vitals ni une validation de ceux-ci.
- **Pas de score halluciné** — si une URL échoue (timeout, 404, JS error), la marquer `ERROR` dans le tableau, pas `0` ou un placeholder.
- **Pas de reco sans opportunity Lighthouse correspondante** — ne pas inventer "il faudrait optimiser X" si Lighthouse ne l'a pas remonté pour cette page.
- **Pas d'installation silencieuse** — si Lighthouse manque, demander à l'utilisateur de l'installer.
- **Échantillon honnête** — si l'échantillon est de 50/2000 URLs, le dire clairement, ne pas extrapoler "tout le site" à partir de 2,5% du contenu.

## Edge cases

- **Sitemap index** (sitemapindex au lieu d'urlset) → récupérer le premier child + l'utiliser, signaler à l'utilisateur qu'il peut spécifier un sitemap enfant précis pour cibler.
- **Sitemap protégé** (auth, 403) → demander à l'utilisateur un export local des URLs.
- **Plus de 500 URLs avec mode `all`** → confirmer avec l'utilisateur (sera lent : 500 URLs × ~10s/3 workers ≈ 30 min).
- **Site en SPA ou auth-walled** → certaines pages peuvent timeout, c'est normal, les marquer ERROR.
- **Sitemap multi-langues** → garder tel quel, le rapport montrera les écarts par locale.


## Contrôle avant livraison
Vérifier la demande, les données réellement consultées, les fichiers produits, les sources, les limites et le périmètre autorisé. Chaque fait doit être traçable. Indiquer les contrôles non exécutés. Ne publier ni modifier un site distant sans autorisation.

La méthode annonce cinq à dix minutes pour 50 URL. L’essai du 11 novembre a pris 4 min 48 s. Il a retenu les 50 premières URL du sitemap, ce qui a laissé hors échantillon /a-propos/, avec 17 clics en 28 jours, et /coaching-seo-lyon/.

Les exécutions simultanées chargent aussi la machine. Sur l’accueil, trois passages parallèles ont produit des scores de 60, 52 et 45, contre 66, 67 et 66 pour trois passages successifs. Il faut conserver les conditions de test pour interpréter ces écarts.

Lire les Core Web Vitals sur 28 jours et au bon périmètre

Lighthouse mesure un chargement simulé. Les Core Web Vitals terrain reposent sur les visites réelles, au 75e percentile : pour un indicateur donné, 75 % des observations ont une valeur inférieure ou égale à celle présentée.

Les seuils utilisés dans le relevé sont de 2,5 secondes pour le LCP, 200 millisecondes pour l’INP et 0,1 pour le CLS. Le LCP décrit le chargement du principal élément visible, l’INP la réactivité aux interactions et le CLS les décalages de mise en page.

Le skill consulte les données terrain dans l’API PageSpeed Insights sur les 28 jours précédents. Depuis le 28 septembre 2026, il doit préciser le périmètre avant de présenter une valeur : URL ou origine, appareil, percentile et période. L’origine regroupe les pages d’un même protocole et domaine ; une mesure à ce niveau ne décrit pas nécessairement chaque page.

Dans la réponse API exploitée par l’essai, l’absence de données suffisantes pour une page pouvait conduire à utiliser celles de l’origine. Sans données suffisantes à ce niveau non plus, aucune mesure terrain n’était disponible. Il faut vérifier l’identifiant renvoyé avant d’attribuer une valeur à une URL.

Le 11 novembre, organikk.co n’avait aucune donnée terrain mobile, ni pour les 14 pages d’offre ni pour l’origine. Sur ordinateur, seule l’origine disposait de mesures : LCP de 1,92 s, INP de 105 ms et CLS de 0,08, sous les trois seuils. La même méthode a bien renvoyé des données terrain sur un site plus fréquenté.

Le relevé précise aussi que le champ CLS reçu dans cette réponse API était exprimé sur une échelle multipliée par 100 : une valeur de 8 correspondait à 0,08. La conversion doit être vérifiée dans le champ exploité avant de présenter le chiffre.

Conserver l’INP terrain distinct du TBT mesuré en laboratoire

L’INP a remplacé le FID dans les Core Web Vitals en 2024. Le TBT, qui mesure le blocage du thread principal pendant un test de chargement, ne le remplace pas.

L’audit du 22 septembre avait utilisé le TBT à la place de l’INP. La consultation des données terrain a été ajoutée au skill le 28 septembre pour corriger cette confusion.

Le 11 novembre, le TBT médian local était de 37 ms. Dans les tests mobiles de PageSpeed, exécutés sur les serveurs de Google, il atteignait 8,8 à 31,2 secondes sur huit des 14 pages d’offre : les sept qui chargent da.js, ainsi que /audit-seo/.

Ces écarts décrivent des conditions de laboratoire différentes. Ils ne mesurent pas directement l’expérience des visiteurs.

Interpréter les mesures obtenues sur 49 pages

Lighthouse 13.3.0 a fourni des mesures mobiles pour 49 pages, avec un score médian de 73. Le relevé ne précise pas ici pourquoi l’échantillon initial de 50 URL n’a produit que 49 mesures.

Mesure de laboratoireConstat du 11 novembre
LCP médian4,26 s
Pages avec un LCP supérieur à 2,5 s48 sur 49
Pages avec un LCP supérieur à 4 s31, dont neuf des 14 pages d’offre
CLS médian0
CLS de /skills/0,403

L’accueil est la page commerciale la plus exposée dans ce relevé : elle concentre 21 des 86 clics des 28 derniers jours. Son LCP atteint 8,99 s en local, contre 3,78 s dans le test PageSpeed. Ces valeurs proviennent de deux environnements de test, pas de visites réelles.

Le rapport propose plusieurs pistes de correction :

  • des feuilles de style bloquent le premier affichage sur 44 pages, dont Google Fonts sur 36 ; le gain potentiel est estimé autour de 0,85 s par page, sans avoir été mesuré après correction ;
  • le script da.js, chargé sur 27 pages, contient environ 106 Ko inutilisés dans les tests ;
  • le chargement des polices provoque des décalages de mise en page sur six pages.

Sur les 16 URL communes aux audits de septembre et novembre, le LCP médian passe de 2,73 s à 3,99 s. Le rapport ne conclut pas à une régression : les deux campagnes utilisaient Lighthouse 12 puis Lighthouse 13, et leur comparabilité n’était pas établie.

Ne pas conclure à un échec des Core Web Vitals sans données terrain

En l’absence de données terrain mobiles, le rapport ne peut pas dire qu’organikk.co réussit ou échoue aux Core Web Vitals sur mobile. Il peut seulement décrire les tests disponibles.

Sur ordinateur, les mesures de l’origine ne prouvent pas que chaque page d’offre respecte les seuils. Les priorités tiennent également compte du rôle commercial des pages : les pages vidéo avec un LCP de 13 secondes ne passent pas automatiquement avant les pages d’offre.

Enfin, les pages d’offre lentes occupent des positions moyennes de 25 à 64 sur leur requête la plus visible. L’audit ne permet pas d’attribuer ces positions à leur vitesse.

05 · Comparer les données structurées au contenu réellement affiché

Vérifier que le projet correspond au périmètre Next.js du skill

seo-donnees-structurees a été conçu pour générer du JSON-LD sur un site Next.js utilisant l’App Router. Le JSON-LD décrit les entités et le contenu d’une page sous une forme exploitable par les moteurs.

La méthode injecte ce balisage depuis un Server Component avec dangerouslySetInnerHTML. Elle a été généralisée à partir du système en production sur organikk-next.

Le site a toutefois évolué depuis : ses FAQ sont extraites du HTML affiché, ses identifiants @id utilisent notamment le préfixe urn:organikk:, et des extraits vidéo sont balisés. Ces particularités ne sont pas toutes décrites dans le skill.

La méthode ne propose ni mode audit ni format de rapport. Elle ne couvre pas les fichiers statiques hors du framework, soit dix pages dans ce périmètre d’organikk.co, et ne prévoit pas plusieurs layouts racines.

Ses étapes 3 à 6 modifient le code ; l’étape 7 demande de corriger les erreurs de validation. Pour mon essai, j’ai utilisé ces étapes comme points de comparaison en imposant la lecture seule :

Prompt
/seo-donnees-structurees Compare le JSON-LD de [DOMAINE] au contenu affiché de chaque page, sans modifier le code.

Précise les pages couvertes et celles qui restent hors du périmètre de la méthode. Distingue les erreurs de syntaxe, les valeurs qui ne correspondent pas au contenu et les validations non exécutées.

Présente les corrections proposées pour validation. N’écris aucun fichier et ne déploie rien.
~/.claude/skills/seo-donnees-structurees/SKILL.md · 1 193 mots
---
name: seo-donnees-structurees
description: >
  Mise en place de données structurées JSON-LD automatiques sur un site Next.js
  (App Router) : graphe d'entité site-wide unique référencé par @id, et schémas
  par page DÉRIVÉS du contenu (Article, FAQPage, HowTo, VideoObject,
  BreadcrumbList) sans saisie manuelle. Généralisé à partir du système en
  production sur organikk-next (src/lib/schema.ts).

  TOUJOURS utiliser ce skill quand l'utilisateur dit : "données structurées",
  "schema.org", "JSON-LD", "rich results", "rich snippets", "balisage",
  "FAQPage", "HowTo schema", "BreadcrumbList", "VideoObject", "entité Google",
  "knowledge graph du site", "@id graph", ou demande d'ajouter, refondre ou
  auditer le balisage structuré d'un site (en priorité Next.js App Router).
---

# Skill — Données structurées JSON-LD automatiques

## Quand déclencher

Ajouter, refondre ou auditer le balisage structuré d'un site. Objectif : éligibilité aux rich results Google ET consolidation d'une entité unique exploitable par les moteurs de réponse (AEO). Pas du schema décoratif, du schema qui sert le Grounding et la citation.

## Principe non-négociable

Trois règles, dans cet ordre. Si l'une saute, le skill a échoué.

1. **Source unique.** Tout le JSON-LD vient d'un seul module (`lib/schema.ts`). Aucun bloc schema écrit en dur dans une page.
2. **Une entité, référencée par `@id`.** Le graphe site-wide (Organization, WebSite, Person) est émis une seule fois dans le layout racine. Chaque page de contenu pointe vers ces nœuds par `@id` (author / publisher / isPartOf), elle ne redéclare jamais l'auteur ni l'éditeur. Google fusionne tous les blocs d'une page et consolide une seule entité. C'est ça qui construit le knowledge graph du site, pas la répétition.
3. **Le schema est dérivé du contenu, jamais saisi à la main.** Un champ schema qui n'est pas calculé depuis la donnée de la page est une dette : il se désynchronise au premier edit. Si on doit le taper deux fois, c'est cassé.

## Architecture de référence

Graphe site-wide (`siteGraph()`, émis dans le layout racine) :

- `Organization` (+ `ProfessionalService` si activité de service) avec `@id = {SITE_URL}/#organization`
- `WebSite` avec `@id = {SITE_URL}/#website`, `publisher` -> ref Organization
- `Person` (fondateur / auteur) avec `@id = {SITE_URL}/#person-...`, `worksFor` -> ref Organization
- `ImageObject` logo avec `@id = {SITE_URL}/#logo`, partagé par `logo` et `image`
- `sameAs` : profils sociaux réels (LinkedIn, YouTube, X, Substack). Pas d'URL inventée.

Refs légères exportées et réutilisées partout : `AUTHOR_REF = {'@id': PERSON_ID}`, `PUBLISHER_REF = {'@id': ORG_ID}`, `WEBSITE_REF = {'@id': WEBSITE_ID}`.

## Règle de dérivation automatique (le cœur du skill)

Chaque type de schema se déduit d'un signal présent dans la donnée de la page. Tableau de correspondance à appliquer :

| Signal dans le contenu | Schema émis | Dérivation |
|---|---|---|
| Toute page article / post | `Article` ou `BlogPosting` | titre, excerpt, date, section ; `wordCount` calculé par `countWords()` ; `keywords` depuis les highlights ; author/publisher/isPartOf = refs |
| Toute page (toujours) | `BreadcrumbList` | `breadcrumb()` à partir du chemin (Accueil > rubrique > titre) |
| Bloc `faq` présent dans les sections | `FAQPage` | `mainEntity` = map des items q/a en Question/Answer. Zéro saisie |
| Section `video` présente | `VideoObject` | ID YouTube extrait par regex de l'URL ; thumbnail + embedUrl déduits |
| H2 dont le titre matche un prédicat (ex. contient "prompt", "étapes", "tutoriel") | `HowTo` | collecte les H3 numérotés suivants + leur contenu (p / code / listes) en `HowToStep` |
| Page produit / offre avec prix | `Product` / `Offer` | depuis les champs prix/dispo de la donnée. Jamais de prix inventé |

Principe : on ne demande jamais à l'utilisateur "quel schema veux-tu". On lit la structure de la page et on émet ce que la structure prouve. Un schema sans preuve dans le contenu = suppression.

## Procédure

1. **Détecter le terrain.** Framework et version. Si Next.js : App Router ou Pages ? Lire la doc du projet (sur organikk-next : `node_modules/next/dist/docs/`, conventions imposées par AGENTS.md) avant d'écrire une ligne. Ne jamais présumer l'API metadata.
2. **Cartographier le modèle de données.** Où vivent les articles, pages, FAQ, vidéos (ex. `src/data/*.ts`). Identifier la forme des sections (le schema se dérive de là).
3. **Créer / refondre `lib/schema.ts`** : config d'identité en tête (SITE_URL, identité Organization/Person/sociaux), les nœuds, `siteGraph()`, les refs `@id`, les helpers `breadcrumb()` et `countWords()`. Partir de `references/schema-reference.ts`.
4. **Câbler le layout racine** : un seul `<script type="application/ld+json">` avec `siteGraph()`.
5. **Câbler chaque template de contenu** : construire un tableau `jsonLd[]` (Article + breadcrumb toujours, puis FAQ / Video / HowTo conditionnels selon les signaux), sérialisé dans UN script en tête de page.
6. **Dédupliquer.** Supprimer tout ancien bloc Organization/Person redéclaré dans les pages : tout passe par les refs `@id`.
7. **Valider** (voir checklist). Corriger jusqu'à zéro erreur.

## Émission

- Site-wide : un `<script type="application/ld+json">` dans le layout racine, contenu = `siteGraph()`.
- Par page : un seul `<script type="application/ld+json">` en tête, contenu = `JSON.stringify(jsonLd)` où `jsonLd` est le tableau des nœuds de la page.
- App Router : injection via `dangerouslySetInnerHTML` dans un Server Component. Ne pas utiliser de lib tierce, ce sont des objets JS purs.

## Validation (checklist, zéro erreur tolérée)

- [ ] Chaque `@id` site-wide est unique et stable, réutilisé par ref dans les pages
- [ ] Aucune page ne redéclare un nœud Organization ou Person en entier
- [ ] `Article` : headline non vide, `datePublished` valide, `wordCount` calculé (pas codé en dur), author/publisher en ref
- [ ] `FAQPage` émis seulement si un vrai bloc FAQ existe, et chaque réponse est du texte réel
- [ ] `HowTo` émis seulement si des étapes ordonnées existent réellement
- [ ] `VideoObject` : `contentUrl`/`embedUrl` résolus, thumbnail valide
- [ ] `BreadcrumbList` cohérent avec l'URL réelle
- [ ] JSON-LD valide et passe le test Rich Results de Google + le validateur schema.org
- [ ] Aucun champ inventé (prix, note, avis, premier sur X) sans preuve : un faux signal dégrade la note Google de la page

## Anti-patterns (à ne jamais faire)

- Redéclarer l'auteur et l'éditeur sur chaque page au lieu de référencer par `@id`
- Écrire du JSON-LD en dur dans le JSX d'une page
- Émettre un `FAQPage` ou `HowTo` "au cas où" sans contenu correspondant visible sur la page (risque de pénalité, et c'est du mensonge à Google)
- Mettre `aggregateRating` / `Review` / prix non vérifiables
- Multiplier les `<script ld+json>` redondants au lieu d'un tableau unique par page
- Hardcoder `wordCount`, des dates ou des compteurs au lieu de les dériver de la donnée
- Présumer l'API Next.js sans lire la doc de la version du projet

## Référence d'implémentation

`references/schema-reference.ts` : module généralisé prêt à adapter (config d'identité en tête, nœuds, `siteGraph`, refs `@id`, `breadcrumb`, `countWords`, builders `articleSchema` / `faqSchema` / `videoSchema` / `howToFromSections`). C'est la version dé-Organikk-isée du système en production sur `organikk-next/src/lib/schema.ts`. L'adapter au modèle de données du site cible, ne pas le copier tel quel.

## Concepts liés

`aeo` · `grounding-score` · `entites-vectorielles` · `passage-ranking` · `knowledge-graph` · `e-e-a-t`


## Contrôle avant livraison
Vérifier la demande, les données réellement consultées, les fichiers produits, les sources, les limites et le périmètre autorisé. Chaque fait doit être traçable. Indiquer les contrôles non exécutés. Ne publier ni modifier un site distant sans autorisation.
~/.claude/skills/seo-donnees-structurees/references/schema-reference.ts · 329 lignes
/**
 * RÉFÉRENCE — Données structurées JSON-LD automatiques (Next.js App Router)
 *
 * Version généralisée du système en production sur organikk-next
 * (src/lib/schema.ts). À ADAPTER au modèle de données du site cible,
 * pas à copier tel quel.
 *
 * Principe : source unique, une entité référencée par @id, schema dérivé
 * du contenu. Ces fonctions ne renvoient que des objets JS purs : c'est
 * le consumer (layout / page, Server Component) qui les sérialise dans
 * un <script type="application/ld+json">.
 *
 * Câblage type :
 *
 *   // app/layout.tsx (Server Component)
 *   import { siteGraph } from '@/lib/schema'
 *   <script type="application/ld+json"
 *     dangerouslySetInnerHTML={{ __html: JSON.stringify(siteGraph()) }} />
 *
 *   // app/blog/[slug]/page.tsx
 *   const jsonLd = [
 *     articleSchema(article, url),
 *     breadcrumb([...]),
 *     ...(faqBlock ? [faqSchema(faqBlock.items)] : []),
 *     ...(video ? [videoSchema(video, article)] : []),
 *     ...howToFromSections(article.sections),
 *   ]
 *   <script type="application/ld+json"
 *     dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }} />
 */

// ─────────────────────────────────────────────────────────────────────────
// 1. CONFIG D'IDENTITÉ — la seule zone à éditer par site
// ─────────────────────────────────────────────────────────────────────────

export const SITE_URL = 'https://example.com'

const IDENTITY = {
  orgName: 'NomDeLaMarque',
  orgDescription: 'Phrase de positionnement, claire, sans superlatif invérifiable.',
  orgSlogan: 'Baseline courte',
  foundingYear: '2020',
  isProfessionalService: true, // ajoute le @type ProfessionalService
  logoPath: '/logo.png',
  knowsAbout: ['SEO', 'GEO', 'AEO'],
  serviceType: ['SEO', 'Audit SEO'],
  areaServedCountry: 'France',
  locality: 'Lyon',
  region: 'Auvergne-Rhône-Alpes',
  countryCode: 'FR',
  email: 'contact@example.com',
  language: 'fr-FR',
  orgSameAs: [
    'https://www.linkedin.com/company/...',
    'https://www.youtube.com/@...',
  ],
  person: {
    slug: 'prenom-nom',
    name: 'Prénom Nom',
    givenName: 'Prénom',
    familyName: 'Nom',
    jobTitle: 'Consultant SEO & GEO',
    aboutPath: '/a-propos',
    portraitPath: '/portrait.png',
    sameAs: [
      'https://www.linkedin.com/in/...',
      'https://x.com/...',
    ],
  },
} as const

// ─────────────────────────────────────────────────────────────────────────
// 2. IDs STABLES + REFS LÉGÈRES
// ─────────────────────────────────────────────────────────────────────────

export const ORG_ID = `${SITE_URL}/#organization`
export const WEBSITE_ID = `${SITE_URL}/#website`
export const PERSON_ID = `${SITE_URL}/#${IDENTITY.person.slug}`
const LOGO_ID = `${SITE_URL}/#logo`

export const AUTHOR_REF = { '@id': PERSON_ID } as const
export const PUBLISHER_REF = { '@id': ORG_ID } as const
export const WEBSITE_REF = { '@id': WEBSITE_ID } as const

// ─────────────────────────────────────────────────────────────────────────
// 3. NŒUDS SITE-WIDE
// ─────────────────────────────────────────────────────────────────────────

const organizationNode = {
  '@type': IDENTITY.isProfessionalService
    ? ['Organization', 'ProfessionalService']
    : 'Organization',
  '@id': ORG_ID,
  name: IDENTITY.orgName,
  legalName: IDENTITY.orgName,
  url: SITE_URL,
  description: IDENTITY.orgDescription,
  slogan: IDENTITY.orgSlogan,
  foundingDate: IDENTITY.foundingYear,
  logo: {
    '@type': 'ImageObject',
    '@id': LOGO_ID,
    url: `${SITE_URL}${IDENTITY.logoPath}`,
    contentUrl: `${SITE_URL}${IDENTITY.logoPath}`,
    caption: IDENTITY.orgName,
  },
  image: { '@id': LOGO_ID },
  founder: { '@id': PERSON_ID },
  knowsLanguage: IDENTITY.language,
  knowsAbout: IDENTITY.knowsAbout,
  serviceType: IDENTITY.serviceType,
  areaServed: { '@type': 'Country', name: IDENTITY.areaServedCountry },
  address: {
    '@type': 'PostalAddress',
    addressLocality: IDENTITY.locality,
    addressRegion: IDENTITY.region,
    addressCountry: IDENTITY.countryCode,
  },
  email: IDENTITY.email,
  contactPoint: {
    '@type': 'ContactPoint',
    email: IDENTITY.email,
    contactType: 'customer support',
    areaServed: IDENTITY.countryCode,
    availableLanguage: 'French',
  },
  sameAs: IDENTITY.orgSameAs,
}

const personNode = {
  '@type': 'Person',
  '@id': PERSON_ID,
  name: IDENTITY.person.name,
  givenName: IDENTITY.person.givenName,
  familyName: IDENTITY.person.familyName,
  url: `${SITE_URL}${IDENTITY.person.aboutPath}`,
  image: {
    '@type': 'ImageObject',
    url: `${SITE_URL}${IDENTITY.person.portraitPath}`,
  },
  jobTitle: IDENTITY.person.jobTitle,
  worksFor: { '@id': ORG_ID },
  knowsAbout: IDENTITY.knowsAbout,
  sameAs: IDENTITY.person.sameAs,
}

const websiteNode = {
  '@type': 'WebSite',
  '@id': WEBSITE_ID,
  url: SITE_URL,
  name: IDENTITY.orgName,
  description: IDENTITY.orgSlogan,
  inLanguage: IDENTITY.language,
  publisher: { '@id': ORG_ID },
}

/** Graphe site-wide : à émettre UNE fois dans le layout racine. */
export function siteGraph() {
  return {
    '@context': 'https://schema.org',
    '@graph': [organizationNode, websiteNode, personNode],
  }
}

// ─────────────────────────────────────────────────────────────────────────
// 4. HELPERS DÉRIVÉS
// ─────────────────────────────────────────────────────────────────────────

/** Fil d'Ariane. Toujours émis, dérivé du chemin réel de la page. */
export function breadcrumb(items: { name: string; url: string }[]) {
  return {
    '@context': 'https://schema.org',
    '@type': 'BreadcrumbList',
    itemListElement: items.map((it, i) => ({
      '@type': 'ListItem',
      position: i + 1,
      name: it.name,
      item: it.url,
    })),
  }
}

/**
 * Compte les mots de n'importe quelle structure de sections.
 * Parcours défensif : additionne toute valeur string, quelle que soit
 * la forme du contenu. Sert à dériver wordCount, jamais à le coder en dur.
 */
export function countWords(value: unknown): number {
  if (typeof value === 'string') {
    return value.trim().split(/\s+/).filter(Boolean).length
  }
  if (Array.isArray(value)) {
    return value.reduce<number>((n, v) => n + countWords(v), 0)
  }
  if (value && typeof value === 'object') {
    return Object.values(value).reduce<number>((n, v) => n + countWords(v), 0)
  }
  return 0
}

// ─────────────────────────────────────────────────────────────────────────
// 5. BUILDERS PAR TYPE — adapter les noms de champs au modèle du site
// ─────────────────────────────────────────────────────────────────────────

type ArticleLike = {
  title: string
  excerpt: string
  date: string
  category?: string
  highlights?: string[]
  sections: unknown
}

/** Article / BlogPosting dérivé de la donnée. Auteur/éditeur par ref @id. */
export function articleSchema(a: ArticleLike, url: string, ogImage = `${SITE_URL}/og.png`) {
  return {
    '@context': 'https://schema.org',
    '@type': 'BlogPosting',
    headline: a.title,
    description: a.excerpt,
    url,
    datePublished: a.date,
    dateModified: a.date,
    articleSection: a.category,
    inLanguage: IDENTITY.language,
    isAccessibleForFree: true,
    wordCount: countWords(a.sections),
    keywords: a.highlights?.join(', '),
    image: ogImage,
    author: AUTHOR_REF,
    publisher: PUBLISHER_REF,
    isPartOf: WEBSITE_REF,
    mainEntityOfPage: { '@type': 'WebPage', '@id': url },
  }
}

/** FAQPage : émis SEULEMENT si un vrai bloc FAQ existe sur la page. */
export function faqSchema(items: { q: string; a: string }[]) {
  return {
    '@context': 'https://schema.org',
    '@type': 'FAQPage',
    mainEntity: items.map(({ q, a }) => ({
      '@type': 'Question',
      name: q,
      acceptedAnswer: { '@type': 'Answer', text: a },
    })),
  }
}

/** VideoObject : ID YouTube extrait par regex, thumbnail + embed déduits. */
export function videoSchema(
  video: { url: string; caption?: string },
  ctx: { title: string; excerpt: string; date: string },
) {
  const ytId =
    video.url.match(/(?:youtu\.be\/|v=|shorts\/|embed\/)([\w-]{11})/)?.[1] ?? null
  return {
    '@context': 'https://schema.org',
    '@type': 'VideoObject',
    name: video.caption ?? ctx.title,
    description: ctx.excerpt,
    uploadDate: ctx.date,
    thumbnailUrl: ytId ? `https://i.ytimg.com/vi/${ytId}/maxresdefault.jpg` : undefined,
    contentUrl: video.url,
    embedUrl: ytId ? `https://www.youtube-nocookie.com/embed/${ytId}` : video.url,
  }
}

/**
 * HowTo dérivé des sections : détecte un H2 dont le titre matche `predicate`,
 * collecte les H3 numérotés suivants + leur contenu en HowToStep.
 * Renvoie [] si aucune étape réelle (jamais de HowTo vide).
 *
 * Adapter la forme des sections au modèle du site. Le défaut reproduit le
 * heuristique organikk : H2 contenant "prompt".
 */
type Section =
  | { type: 'h2'; title: string }
  | { type: 'h3'; title: string; content?: string }
  | { type: 'p' | 'code'; content: string }
  | { type: 'ul' | 'ol'; content: string[] }
  | { type: string; [k: string]: unknown }

export function howToFromSections(
  sections: Section[],
  predicate: (h2Title: string) => boolean = (t) => /prompt/i.test(t),
) {
  const out: Record<string, unknown>[] = []
  for (let i = 0; i < sections.length; i++) {
    const s = sections[i]
    if (s.type !== 'h2' || !predicate((s as { title: string }).title)) continue
    const steps: { name: string; text: string }[] = []
    let j = i + 1
    while (j < sections.length) {
      const t = sections[j]
      if (t.type === 'h2') break
      if (t.type === 'h3' && /^\d+\.\s/.test((t as { title: string }).title)) {
        const stepName = (t as { title: string }).title.replace(/^\d+\.\s*/, '').trim()
        const parts: string[] = []
        const c = (t as { content?: string }).content
        if (c) parts.push(c)
        let k = j + 1
        while (k < sections.length) {
          const u = sections[k]
          if (u.type === 'p' || u.type === 'code') { parts.push((u as { content: string }).content); k++ }
          else if (u.type === 'ul' || u.type === 'ol') { parts.push((u as { content: string[] }).content.join('\n')); k++ }
          else break
        }
        if (parts.length) steps.push({ name: stepName, text: parts.join('\n\n') })
        j = k
      } else j++
    }
    if (steps.length) {
      out.push({
        '@context': 'https://schema.org',
        '@type': 'HowTo',
        name: (s as { title: string }).title,
        step: steps.map((st, idx) => ({
          '@type': 'HowToStep',
          position: idx + 1,
          name: st.name,
          text: st.text,
        })),
      })
      break // un seul HowTo par page
    }
  }
  return out
}

Centraliser les entités et vérifier leurs identifiants

Le skill centralise le balisage dans lib/schema.ts. Chaque entité est déclarée une fois, puis référencée par son @id. Les schémas sont dérivés du contenu de la page.

Pour ces identifiants, le modèle prévoit l’adresse du site suivie d’un fragment, composé d’un dièse et du nom de l’entité. Organikk.co n’utilise plus ce format : depuis le 2 novembre, une règle propre au site interdit les dièses dans le HTML servi, balisage compris.

Le relevé compte 99 identifiants distincts : 93 commencent par urn:organikk:, comme urn:organikk:organisation, et les six autres reprennent les adresses des articles.

L’analyse distingue plusieurs niveaux de validation. JSON-LD 1.1 permet d’identifier un nœud par une IRI ou un identifiant de nœud anonyme, et cet identifiant ne doit pas nécessairement mener à une page. Cela ne suffit pas à valider toute chaîne commençant par urn: : la conformité à la RFC 8141 est une question distincte. Dans le relevé, « organikk » ne figure pas au registre IANA.

Les exemples de Google utilisent des fragments, mais le relevé ne rapporte pas de règle générale imposant ce format à tous les identifiants. La règle interne du site et les exigences des formats doivent donc être examinées séparément.

Ne baliser que des informations présentes dans la page

La méthode exige une preuve dans le contenu pour chaque donnée structurée. Elle interdit d’ajouter un FAQPage ou un HowTo par précaution lorsque la page n’affiche pas le contenu correspondant.

L’essai a trouvé 12 réponses de FAQ, réparties sur trois pages, dont les mots étaient collés dans le JSON-LD. Par exemple, le balisage contenait « Non.Les e-mails » alors que la page séparait ces phrases en deux paragraphes. L’origine du problème a été localisée dans src/lib/schema.ts.

Le site déclare aussi 40 fils d’Ariane sans fil affiché. D’autres modèles reprennent correctement le contenu : les 35 pages vidéo balisent la date, la durée, le lecteur et la FAQ mot pour mot ; cinq pages extraient leur FAQ des accordéons visibles, sans seconde saisie.

Le skill déduit le fil d’Ariane du chemin de l’URL. La recommandation Google citée dans le relevé privilégie le parcours type d’un visiteur, qui ne correspond pas nécessairement à cette structure d’URL.

Distinguer balisage valide et éligibilité aux résultats enrichis

Le relevé documentaire du 11 novembre 2026 compte 25 types de résultats enrichis dans la galerie Google, d’Article à Video. Il indique que FAQ et HowTo n’y figurent plus.

Selon les dates consignées dans ce relevé, Google n’affiche plus les résultats HowTo depuis le 13 septembre 2023. Pour les FAQ, l’annonce du 8 mai 2026 indiquait un arrêt de l’affichage à compter du 7 mai ; la documentation avait ensuite été retirée le 15 juin.

Le cas de Dataset illustre la nécessité de dater cette vérification : un retrait progressif avait été annoncé le 5 novembre 2025, mais le type figurait encore dans la galerie consultée le 11 novembre 2026.

Le skill, daté du 19 mai 2026, mentionne toujours l’éligibilité aux résultats enrichis. Il génère un FAQPage à partir d’un bloc FAQ et un HowTo à partir d’un H2 contenant « prompt », « étapes » ou « tutoriel ». Cette règle de génération ne démontre pas à elle seule l’éligibilité à un affichage dans Google.

Sur organikk.co, 45 pages portent un balisage FAQ, pour 239 questions. Neuf autres affichent une FAQ sans balisage. Parmi elles, le calculateur de budget explique dans son code que les questions servent à aider le lecteur à décider, sans viser un résultat enrichi.

Le relevé indique aussi que le résultat enrichi des applications exige une note ou un avis. Les outils d’organikk.co n’en disposent pas et la méthode interdit d’en inventer.

Indiquer les validateurs exécutés et ceux qui ne l’ont pas été

Un balisage valide ne garantit pas son affichage sous forme de résultat enrichi. Les vérifications mentionnées dans le relevé comprennent le test des résultats enrichis de Google, l’inspection d’URL, les rapports Search Console après déploiement et le validateur de schema.org.

La liste de contrôle du skill porte notamment sur des identifiants uniques et stables, l’absence de redéclarations de l’organisation ou de la personne, un wordCount calculé et l’absence de champs inventés.

L’essai du 11 novembre n’a exécuté ni le test Google ni le validateur de schema.org dans le navigateur. Le contrôle local a comparé le HTML servi au vocabulaire schema.org 30.1, publié le 16 septembre 2026, sans exécuter le JavaScript.

La documentation Next.js 16.2.3 citée dans le relevé demande aussi de remplacer le caractère < par sa représentation Unicode dans le JSON-LD. Le modèle du skill ne le fait pas. Aucun bloc observé sur organikk.co ne contenait ce caractère lors de l’essai, mais ce constat ne corrige pas l’omission dans la méthode.

Lire les anomalies relevées sur 90 pages d’organikk.co

L’analyse a couvert 90 pages en 37 minutes : les 89 URL du sitemap et /systeme-seo/. Parmi elles, 81 contenaient du JSON-LD, réparti dans 132 blocs, sans erreur de syntaxe. Les neuf pages dépourvues de balisage étaient des fichiers statiques, dont quatre guides.

La syntaxe correcte n’a pas empêché plusieurs problèmes de contenu :

  • sur 80 pages, le portrait déclaré pointait vers /tim-portrait.png, une URL en 404 ; l’image avait été convertie en WebP le 18 mai 2026, deux jours après l’installation du balisage, sans mise à jour de ce dernier ;
  • le logo de l’organisation était une photo de moi, alors que la documentation citée demande un logo représentatif de l’organisation ;
  • les six articles utilisaient l’image de partage de l’accueil, plutôt qu’une image liée à chaque article ;
  • sur 80 pages, le type ProfessionalService était utilisé alors que le vocabulaire schema.org le signalait comme obsolète pour les entreprises locales, en raison d’une confusion avec Service.

Le modèle du skill contient également ce dernier type, utilisé sur le site depuis le 16 mai 2026. L’essai propose 15 corrections, sans les appliquer au code.

06 · Croiser le crawl et Search Console pour préparer les liens internes

Analyser les liens existants sans Search Console

maillage-systeme construit le graphe des liens internes, c’est-à-dire la représentation des pages et des liens qui les relient. Il classe les pages selon leur rôle, de la page générale aux pages plus spécialisées, puis relève les ancres, les pages orphelines et les impasses.

Prompt
/maillage-systeme Analyse le maillage de [DOMAINE] à partir de [ADRESSE DU SITEMAP].

Compte séparément les liens éditoriaux et les liens du menu, de l’en-tête, du pied de page ou des barres latérales. Pour les liens entrants, compte les pages sources distinctes.

Précise si le crawl utilise le HTML initial ou un rendu JavaScript. Associe chaque proposition de lien à un passage existant et indique les limites de l’exploration.

Ne modifie pas le site.
~/.claude/skills/maillage-systeme/SKILL.md · 3 714 mots
---
name: maillage-systeme
description: >
  Maillage interne stratégique d'un site (blog, catalogue, doc) : architecture en piliers,
  classification hub/satellite, sélection d'ancres avec diversification entrante,
  détection des pages orphelines et dead-end, audit complet du graphe interne. Sortie obligatoire en plus du tableau : un rapport de pré-décision (diagnostic, preuves typées, état Critique / À améliorer / Sain, actions P1-P3 avec confiance, effort et risque, jamais de score affiché) ; sans lui le skill n'a pas terminé.

  Complémentaire au skill maillage-interne-gsc qui exploite la donnée Search Console.
  Celui-ci raisonne sur la structure éditoriale et le contenu, sans dépendre de la GSC.
  Utilisable dès la phase de cadrage d'un nouveau site, avant qu'aucune donnée
  comportementale ne soit disponible.

  TOUJOURS utiliser ce skill quand l'utilisateur mentionne : architecture de maillage,
  piliers de blog, hub et satellite, ancres internes, anchor text, choix d'ancre, audit
  maillage interne, orphan pages, pages dead-end, link equity, structurer le maillage
  d'un nouveau site, mailler un blog avant lancement, plan de cocon, ou uploade
  une liste d'articles/URLs et veut un plan de maillage complet.
---

# Skill — Maillage Interne : Architecture, Ancres et Audit

## Rôle

Construire et auditer le graphe de liens internes d'un site à partir du contenu existant ou planifié, sans dépendre de la Search Console. Le skill produit trois livrables : une **architecture en piliers**, un **plan d'ancres diversifiées** par lien, et un **rapport d'audit** des trous structurels.

L'objectif n'est pas de générer des liens à la chaîne. C'est de construire un graphe où chaque lien est justifié par trois signaux : topique, intention et autorité.

---

## Réflexion appliquée (méthode Boussardon)

- Le maillage interne est **un système, pas une passe**. Trois axes simultanés : topique, intention, autorité.
- Une ancre, ce n'est pas un mot-clé. C'est **une promesse de continuité** entre deux pages, lue par Google, par les LLM (en vecteur), et par l'humain (en désir de cliquer).
- **5 ancres possibles vers la même page = 5 ancres différentes.** Un seul exact match. Le reste est partial / sémantique / contextuel long.
- **Test à voix haute** : si la phrase tombe juste sans le lien, l'ancre est bien intégrée. Si elle clopine, l'ancre est plaquée.
- **Le maillage Know→Do passe avant le maillage Know→Know.** Une page qui explique un concept doit toujours pointer vers la page qui permet de l'exécuter (outil, audit, démo).
- **Pas de "Voir aussi" en bas d'article.** Le contexte de lien est dilué. Liens contextuels in-body uniquement.
- **Une page mère n'est pas un titre de catégorie.** C'est l'article le plus stratégique du pilier, celui qui définit le vocabulaire et reçoit le plus de liens internes.
- **Le cross-pillar pollination compte autant que le maillage intra-cluster.** 1 lien sortant sur N doit pointer vers un autre pilier pour éviter la siloïsation.

---

## Données requises

| Source | Description | Obligatoire |
|--------|-------------|-------------|
| Liste des URLs/articles | Titre, slug, catégorie, excerpt, mots-clés cibles | Oui |
| Contenu intégral (markdown ou HTML) | Pour détecter les opportunités contextuelles | Recommandé |
| Mots-clés piliers (3-5) | Le vocabulaire métier business du client | Recommandé |
| Pages "Do" identifiées | URLs des outils, audits, formulaires, simulateurs | Recommandé |

**Minimum viable** : la liste des articles avec titre + excerpt + mots-clés. Sans le contenu intégral, le skill produit l'architecture mais pas les ancres précises.

---

## Étape 0 — Ingestion (site existant en ligne)

**Règle de contexte : le contenu intégral du site n'entre JAMAIS d'un bloc dans le contexte principal.** La qualité de raisonnement d'un LLM se dégrade quand la fenêtre se remplit ; charger 50+ pages HTML avant de raisonner produit un plan médiocre. Le contexte principal ne travaille que sur l'index.

Si le site est en ligne avec un sitemap, lancer le script d'ingestion AVANT toute lecture de page :

```bash
python3 ~/.claude/skills/maillage-systeme/scripts/crawl_graph.py https://site.com/sitemap.xml -o ./maillage-data
```

Le script (stdlib Python uniquement, zéro dépendance, zéro token) produit :

- **`index.json`** — une ligne légère par page : URL, title, H1, meta description, compteurs inbound/outbound éditoriaux, listes des orphelines et dead-ends. C'est le SEUL fichier chargé dans le contexte principal.
- **`graph.json`** — tous les liens internes avec leur ancre exacte, marqués `in_body` (hors nav/header/footer/aside) et `sitewide` (même couple cible+ancre présent sur ≥ 80 % des pages = lien de gabarit, exclu du comptage éditorial même si le HTML n'est pas sémantique).

Répartition du travail ensuite :

1. **Étapes 1-4 et 6-7** raisonnent sur `index.json` + les compteurs de `graph.json`. Pas de lecture de contenu.
2. **Étape 5 (ancres précises)** : déléguer à des sous-agents. Chaque sous-agent lit 2-3 pages sources maximum, propose les passages et ancres, seul le résultat remonte au contexte principal.
3. Les ancres existantes vers une cible (pour la diversification) se lisent dans `graph.json`, jamais en re-crawlant.

Si le site n'est pas en ligne (contenu planifié, markdown local), sauter cette étape : la liste fournie par l'utilisateur fait office d'index, et la cartographie étape 4 se fait par parsing des fichiers locaux (grep des liens, pas lecture intégrale en contexte).

---

## Raisonnement de l'agent (étapes obligatoires)

L'agent DOIT suivre ces étapes **dans l'ordre** avant de répondre.

### Étape 1 — Classifier chaque page en intention

Pour chaque article, déterminer son intention dominante :

| Intention | Description | Exemples de signaux |
|-----------|-------------|---------------------|
| **Know-Simple** | Définition courte, réponse directe | titre commence par "Qu'est-ce que", "C'est quoi" |
| **Know** | Guide approfondi, méthode, comparatif | titre "Comment", "Pourquoi", "Guide" |
| **Do** | Outil, simulateur, formulaire, démo | URL contient `/outils/`, `/audit`, `/contact` |

Une page peut avoir une intention dominante + une intention secondaire. Noter les deux.

### Étape 2 — Identifier les piliers

Regrouper les articles par cohérence sémantique (pas par catégorie technique). **Repère interne : 3 à 5 piliers** pour un blog de taille moyenne. C'est un repère de travail, pas une condition de bonne santé SEO : un site à deux offres a deux piliers, un catalogue en a plus (Tim, 28/09/2026 : les quotas de ce skill sont des repères internes, jamais des conditions universelles ; Google recommande des liens utiles, contextualisés et explorables, sans nombre idéal).

Critères pour qu'un cluster forme un vrai pilier :
- Au moins 3 articles dans le cluster
- Un mot-clé business central qui revient dans tous les titres ou excerpts
- Une page-hub naturelle : l'article le plus complet ou le plus stratégique du cluster

Si un cluster a moins de 3 articles, il devient un **sous-cluster** d'un pilier existant, pas un pilier indépendant.

### Étape 3 — Désigner le hub de chaque pilier

Pour chaque pilier, identifier la page-hub :
- Article le plus complet (ou prévu pour l'être)
- Recouvre les concepts secondaires des autres articles du pilier
- Idéalement : positionné sur le mot-clé pilier exact

Le hub reçoit des liens entrants depuis tous les satellites. Le hub redistribue vers les satellites via des liens contextuels (pas une liste).

### Étape 4 — Cartographier les liens existants

Si l'étape 0 a tourné, cette cartographie est DÉJÀ dans `index.json` (compteurs) et `graph.json` (détail des ancres) : la lire, pas la refaire. Sinon, pour chaque article, lister :
- **Inbound links** : combien d'articles pointent vers lui ?
- **Outbound links** : vers combien d'articles pointe-t-il ?

(La profondeur de clic n'est PAS un critère : on ne la mesure pas, on ne la corrige pas.)

**Comment on compte** (Tim, 28/09/2026 : un total de liens n'a pas la même signification selon l'origine et le rôle) : `graph.json` sépare déjà `in_body` et `sitewide`. Le comptage éditorial retient les liens du corps, depuis des **pages sources distinctes** (dix liens depuis une même page = une source), vers des **cibles pertinentes et accessibles** (pas une page en noindex, en redirection ou hors sujet). Les liens de navigation, pied de page et barre latérale se comptent à part et ne font ni orpheline ni hub à eux seuls. Chaque chiffre du rapport dit quel comptage il utilise.

Détecter les observations :
- **Orphan pages** : 0 lien entrant éditorial (une orpheline n'est pas critique par défaut : une page légale orpheline n'est pas un problème)
- **Dead-end pages** : 0 lien sortant éditorial
- **Hub sous-maillé** : repère interne, moins de 5 entrants depuis des satellites distincts ; à lire avec la taille du pilier, pas comme un seuil

### Étape 5 — Sélectionner les ancres pour chaque lien proposé

Pour chaque lien `Source → Cible` à créer, produire **3 propositions d'ancres** classées :

1. **Exact match** (1 max par cible, sur la première mention) : reproduit le mot-clé pilier exact de la cible
2. **Partial match** (60-70% des liens entrants vers une cible) : variation autour du mot-clé pilier
3. **Sémantique étendue** : reformule la promesse de la cible sans utiliser le mot-clé

Pour chaque ancre, vérifier les 5 critères :

| Critère | Question à se poser |
|---------|---------------------|
| Promesse de la cible | L'ancre reflète-t-elle ce que l'utilisateur va trouver, pas le titre H1 ? |
| Phrase porteuse | La phrase reste-t-elle fluide à voix haute sans le lien ? |
| Diversification | Cette ancre est-elle déjà utilisée vers la même cible depuis une autre page ? |
| Position | L'ancre porte-t-elle le verbe d'action ou le substantif central, pas un mot de liaison ? |
| Link context | Les 5 mots avant/après parlent-ils du sujet de la cible ? |

Si une ancre rate un critère, la rejeter.

### Étape 6 — Prioriser les liens à créer

Plus de score numérique (Tim, 28/09/2026). L'ancienne formule `(impressions × poids_intention) + (gain_authority × 0.4)` mélangeait des grandeurs sans normalisation : quelques milliers d'impressions écrasaient tout le reste, et cette passe, annoncée indépendante de la GSC, en dépendait quand même. La priorité se justifie depuis les dimensions déjà relevées, dans cet ordre, et chaque lien proposé porte sa justification écrite :

1. **La cible est une page business prioritaire** (Phase 0 du workflow, ou fournie par Tim) et elle est orpheline ou sous-maillée.
2. **Le lien oriente Know → Do** vers une page qui permet d'agir (outil, audit, contact).
3. **Le lien manque entre un hub et un satellite** du même pilier (le cocon ne tourne pas sans lui).
4. **Le lien répare une orpheline ou une impasse** hors pages business.
5. **Le lien relie deux piliers** (un par pilier au moins, sur une passerelle conceptuelle réelle).

Deux liens au même rang se départagent par l'intention de la cible (Do avant Know-décisionnel avant Know avant Know-Simple), puis, **seulement si la GSC est disponible**, par l'exposition réelle de la cible (impressions). Sans GSC, cette passe reste complète : le départage s'arrête à l'intention. C'est le fonctionnement par défaut, pas un cas particulier.

### Étape 7 — Vérifier les règles de conservation

Avant de finaliser le plan, valider. Les chiffres sont des repères internes de travail, pas des conditions de santé SEO : on explique un écart, on ne le corrige pas mécaniquement.
- Aucune page business orpheline restante (une page légale ou utilitaire orpheline peut le rester, en le disant)
- Aucune page business en impasse (repère : ≥ 2 liens sortants éditoriaux)
- Chaque hub reçoit des liens depuis des satellites distincts (repère : 5)
- Aucune cible ne reçoit la même ancre 2 fois
- Densité lisible (repère : 2 à 5 liens éditoriaux pour 1000 mots) ; au-delà, vérifier que chaque lien reste utile en contexte, pas retirer pour atteindre un nombre

**NE PAS répondre avant d'avoir complété chaque étape.**

---

## Sortie de pré-décision (obligatoire)

Ce skill n'a pas terminé tant que le rapport de pré-décision n'est pas écrit. Il fait partie de la sortie, au même titre que le tableau, et applique le format de restitution décrit ci-dessous. Fichier : `wiki/maillage/YYYY-MM-DD-slug-structurel-decision.md`.

Ce qu'il contient, dans cet ordre :

1. Diagnostic principal : une phrase, la cause structurante, pas une liste d'erreurs
2. Les chiffres à retenir : 3 à 5, ceux qui illustrent le diagnostic
3. État : Critique, À améliorer ou Sain, calculé sur l'impact SEO réel et le type de page, jamais sur le nombre d'erreurs ; jamais de score sur 10
4. Problèmes (3 maximum) et opportunités (5 maximum), séparés : chacun avec Preuve (2 à 4 données), Pourquoi c'est important, Action, Confiance (forte / moyenne / faible) ; chaque problème s'écrit en trois temps : observation prouvée → conséquence ou risque justifié → bénéfice attendu de la correction (l'observation seule n'est pas un frein SEO démontré)
5. Actions P1 / P2 / P3, 3 P1 maximum : pourquoi, preuve, signal attendu (jamais un résultat chiffré promis), dépendance préalable, test de validation (ce qui distingue « correction appliquée » de « résultat SEO observé »), effort faible / moyen / élevé (jamais en heures), confiance, risque low / medium / high ; toute action high (suppression, 301, fusion, changement d'URL) porte « À valider avant déploiement » et sa checklist
6. Ce que les données ne permettent pas de conclure, et « données insuffisantes » ou « ne rien faire » quand c'est le cas

Sur le périmètre de ce skill, le rapport tranche l'architecture : orphelines et impasses pondérées par le type de page (orphan != automatically critical, une page légale orpheline n'est pas un problème), pages commerciales sous-liées regroupées en un seul problème avec les URL en preuves.

Règles : chaque information est typée FACT, HYPOTHESIS ou ACTION, jamais une hypothèse écrite comme un fait ; un problème existe une seule fois (ID), les observations qui parlent du même problème fusionnent ; une anomalie n'est pas une priorité par défaut ; les pages business et les tendances GSC passent avant les anomalies techniques secondaires ; jamais de recommandation automatique de fusion, 301, suppression, réécriture ou création de page ; Google n'est jamais anthropomorphisé. Phrases courtes, une donnée par diagnostic, aucune des phrases « Il est important de », « Il convient de », « Cela peut potentiellement », « Il est intéressant de noter », « Dans le cadre de ».

Restitution (corrections V2 du 23 septembre) : aucun ID technique ni mot anglais (low / medium / high) dans le rapport ; Faible / Moyen / Élevé partout ; la certitude affichée ne dépasse jamais la couverture des données (« aucun problème majeur détecté sur les URL inspectées », pas « Sain ») ; formulations précises (« URL en 404 avec encore des impressions ») ; aucune action proposée sur une page dont les requêtes ne sont pas connues (« à vérifier ») ; le nombre de mots seul n'est jamais un problème ; limites de longueur : diagnostic 70 mots, 4 chiffres, 3 problèmes de 40 mots, 6 actions, 3 opportunités de 35 mots, le reste dans les détails repliés.

Onglet Analyse technique, structure validée le 23 septembre 2026 : chaque priorité = une phrase de cadrage, « Ce qu'on observe » (faits chiffrés en liste, pages en code), « Pourquoi c'est prioritaire » (deux phrases), « Action » (liste numérotée courte), « Impact attendu » et « Risque » en gras ; puis le plan des 30 jours en trois paliers (Priorité immédiate, Deuxième étape, Priorité secondaire), une action par paragraphe en gras suivie d'une phrase ; puis « à surveiller avant d'agir » pour la page dont la cause n'est pas isolée ; puis « Autres pages à surveiller » : chiffres séparés par « · », une phrase, verdict en gras (« Aucune action recommandée », « À vérifier avant toute modification »).

## Format de sortie OBLIGATOIRE

### Bloc 1 — Architecture détectée

```
PILIER 1 — [Nom thématique] (mot-clé pilier : "...")
├── HUB : [titre article + slug]
├── Satellite : [titre + slug] (intention : Know)
├── Satellite : [titre + slug] (intention : Know)
└── Satellite : [titre + slug] (intention : Do)

PILIER 2 — [Nom]
...
```

### Bloc 2 — Audit du graphe existant

Tableau :

| Article | Inbound | Outbound | Statut |
|---------|---------|----------|--------|
| ... | 3 | 4 | OK |
| ... | 0 | 2 | **ORPHELINE** |
| ... | 5 | 0 | **DEAD-END** |

### Bloc 3 — Plan de liens à créer (priorisé)

Pour chaque lien proposé :

```
PRIORITÉ : HAUTE | Rang : 1 (cible business prioritaire, orpheline)
─────────────────────────────────
SOURCE     : [titre article source] (Know)
CIBLE      : [titre article cible] (Do)
PILIER     : Cross-pillar (Pilier 1 → Pilier 3)
NATURE     : Know → Do (orientation funnel)

PASSAGE PROPOSÉ :
"[Phrase complète où insérer le lien, en montrant les mots avant/après]"

ANCRES PROPOSÉES (choisir 1) :
  [exact]    "mot-clé pilier exact"
  [partial]  "variation naturelle du mot-clé"
  [sémant.]  "reformulation de la promesse cible"

JUSTIFICATION : [1 phrase sur pourquoi ce lien crée de la valeur]
```

### Bloc 4 — Règles de gouvernance

Une checklist finale que le client suit à chaque nouvelle publication :

- [ ] Le nouvel article reçoit des liens entrants depuis des articles existants distincts (repère : 3)
- [ ] Le nouvel article contient des liens sortants utiles vers des articles existants (repère : 3)
- [ ] Au moins 1 lien sortant pointe vers une page Do
- [ ] Au moins 1 lien sortant pointe vers un autre pilier (cross-pollination)
- [ ] Aucune ancre exacte n'est dupliquée vers la même cible
- [ ] Tous les liens sont in-body, aucun en bloc "Voir aussi"

---

## Points de vigilance

- **Ne pas tout automatiser.** Le skill propose, l'humain décide. Une ancre forcée détruit le naturel d'un texte.
- **Le contexte vaut plus que l'ancre.** Une ancre parfaite dans une phrase qui parle d'autre chose = lien faible. Réécris la phrase.
- **Le hub n'est pas figé.** Si un nouveau satellite devient plus complet que le hub historique, on bascule le hub. La structure suit le contenu, pas l'inverse.
- **Cross-pillar ≠ liens hors-sujet.** Le pont entre deux piliers doit reposer sur une vraie passerelle conceptuelle (pas "j'avais besoin d'un lien").
- **Ne jamais lier vers la home depuis le contenu.** La home a déjà tout le PageRank, elle n'en a pas besoin. Garde le jus pour les pages business.
- **Les FAQ sont une mine d'ancres.** Chaque réponse de FAQ qui mentionne un sous-sujet déjà traité doit lier. Densité haute, contexte naturel.
- **Densité : un repère, pas un plafond.** Au-delà de 5 liens éditoriaux pour 1000 mots, relire chaque lien pour vérifier qu'il reste utile et contextualisé. Le modèle « chaque ancre pèse 1/N » est un raisonnement de PageRank interne, pas une règle publiée par Google : il sert à réfléchir, pas à trancher.

---

## Cas particulier — Site sans donnée GSC

Ce n'est plus un cas particulier : cette passe ne dépend pas de la GSC par construction (voir Étape 6). Sans GSC :
- Étape 4 (cartographie inbound/outbound) se fait via l'étape 0 (script) si le site est en ligne, sinon par parsing du contenu local (markdown/HTML)
- Étape 6 s'arrête au départage par intention ; l'exposition GSC ne s'ajoute que quand `maillage-interne-gsc` tourne derrière
- Le plan reste valable, ajusté avec la GSC dès que la donnée arrive

---

## Cas particulier — Refonte de site existant

Si le site existe et a ≥ 6 mois de GSC :
- Chaîner ce skill avec **maillage-interne-gsc** : ce skill définit l'architecture, l'autre injecte la donnée comportementale
- Identifier les pages qui rankent déjà sur le pilier et les promouvoir hub si pertinent
- Préserver les liens existants qui marchent (pas de refonte aveugle)

---

## Cas particulier — Pages générées en masse depuis une table de données

Ce skill raisonne par lecture et jugement éditorial (étapes 1-7). Ce raisonnement suppose un nombre de pages qu'un agent peut encore comparer entre elles de façon cohérente. Il ne tient plus au-delà de quelques centaines de pages issues d'un même gabarit.

**Détection** : si un lot de pages partage la même route/le même template et provient d'une table de données (pSEO — un mot de lexique, une fiche produit, un lieu, une entité par ligne), et que ce lot dépasse **300-500 instances**, NE PAS appliquer les étapes 1-7 à ce lot. Le pilier de ces pages est déjà donné par le template lui-même — il n'y a rien à clusteriser.

**Ce qui remplace le raisonnement agent à cette échelle** : un signal de données réel et vérifiable, calculé une fois pour tout le lot, jamais un agent qui juge page par page. Par ordre de préférence :
1. **Relation déjà présente dans la donnée** (cooccurrence, attribut partagé, référence croisée, clé étrangère). C'est le signal le plus fiable : il est vérifiable, pas juste "sémantiquement proche".
2. **Embedding + kNN**, seulement si aucune relation de données n'existe pour rapprocher les instances entre elles.

Dans les deux cas, l'agent n'intervient qu'en amont — pour définir la règle (quel signal, combien de liens, quel format de rendu) — jamais par page. Le rendu est un bloc templaté (type "Mots liés"), pas un lien in-body : la règle "pas de Voir aussi" de ce skill vise le contenu éditorial écrit à la main, elle ne s'applique pas à un gabarit généré à grande échelle où aucune prose organique n'existe pour y glisser un lien contextuel.

Si le lot reste sous le seuil (quelques dizaines à ~300 pages), les étapes 1-7 s'appliquent normalement : à cette échelle, le jugement éditorial reste fiable et moins coûteux à mettre en place qu'un pipeline de données dédié.

---

## Rappels méthode

> "Le maillage interne, c'est un système, pas une passe."
> "5 liens entrants vers la même page = 5 ancres différentes. Un seul exact match."
> "Test à voix haute : si la phrase tombe juste sans le lien, l'ancre est bonne."
> "Une page Know doit toujours pointer vers une page Do."
> "Pas de Voir aussi. Liens in-body uniquement."
> "Un hub n'est pas une catégorie. C'est l'article le plus stratégique du pilier."
> "Le contexte des 5 mots avant/après l'ancre vaut plus que l'ancre elle-même."


## Contrôle avant livraison
Vérifier la demande, les données réellement consultées, les fichiers produits, les sources, les limites et le périmètre autorisé. Chaque fait doit être traçable. Indiquer les contrôles non exécutés. Ne publier ni modifier un site distant sans autorisation.
~/.claude/skills/maillage-systeme/scripts/crawl_graph.py · 288 lignes
#!/usr/bin/env python3
"""Étape 0 du skill maillage-systeme : ingestion déterministe d'un site.

Entrée  : une URL de sitemap (ou une URL de base, on tente /sitemap.xml).
Sortie  : index.json (une ligne légère par page) + graph.json (tous les liens
          internes avec leur ancre, leur passage d'ancrage, in-body ou non) + un résumé sur stdout.

Aucune dépendance externe (stdlib uniquement). Aucun LLM : le graphe est exact.

Usage :
  python3 crawl_graph.py https://exemple.com/sitemap.xml -o ./maillage-data
  python3 crawl_graph.py https://exemple.com --limit 50 --delay 0.3
"""

import argparse
import json
import re
import sys
import time
import urllib.request
import xml.etree.ElementTree as ET
from html.parser import HTMLParser
from urllib.parse import urljoin, urlsplit, urlunsplit

UA = "Mozilla/5.0 (compatible; maillage-systeme/1.0; audit maillage interne)"
# Zones dont les liens ne comptent pas comme liens éditoriaux in-body
CHROME_TAGS = {"nav", "header", "footer", "aside"}
# Blocs de texte : le paragraphe autour d'un lien sert à juger ce lien sur son
# contexte et non sur le seul titre de la cible.
BLOCK_TAGS = {"p", "li", "td", "th", "blockquote", "dd", "dt", "figcaption",
              "h1", "h2", "h3", "h4", "h5", "h6", "section", "article", "div"}
PASSAGE_MAX = 400
# Un bloc qui n'est qu'une suite d'ancres (carrousel de logos, liste de liens)
# ressemble à du contexte sans en être. En dessous de ce nombre de caractères de
# prose hors ancres, on n'attribue pas de passage : Jev juge alors sur le titre
# de la cible, et le rapport porte la limite au lieu d'un faux contexte.
PROSE_MIN = 40
# Second signal : un carrousel de logos concatène ses libellés sans espace
# (« LogoALogoBLogoC… »). Le compte de mots l'écarte là où la
# longueur seule le laisse passer.
PROSE_MOTS_MIN = 10
TRACKING_PARAMS = re.compile(r"^(utm_|fbclid|gclid|ref$)")


def fetch(url, timeout=20):
    req = urllib.request.Request(url, headers={"User-Agent": UA})
    with urllib.request.urlopen(req, timeout=timeout) as resp:
        charset = resp.headers.get_content_charset() or "utf-8"
        return resp.read().decode(charset, errors="replace")


def sitemap_urls(sitemap_url):
    """Retourne toutes les URLs de pages du sitemap (gère les sitemap index)."""
    xml = fetch(sitemap_url)
    root = ET.fromstring(xml.encode())
    ns = {"sm": root.tag.split("}")[0].strip("{")} if "}" in root.tag else {}
    tag = lambda name: f"sm:{name}" if ns else name
    urls = []
    if root.tag.endswith("sitemapindex"):
        for loc in root.iterfind(f".//{tag('sitemap')}/{tag('loc')}", ns):
            urls.extend(sitemap_urls(loc.text.strip()))
    else:
        for loc in root.iterfind(f".//{tag('url')}/{tag('loc')}", ns):
            urls.append(loc.text.strip())
    return urls


def normalize(url, base):
    """URL absolue, sans fragment, sans params de tracking, sans slash final."""
    absolute = urljoin(base, url)
    parts = urlsplit(absolute)
    if parts.scheme not in ("http", "https"):
        return None
    query = "&".join(
        p for p in parts.query.split("&") if p and not TRACKING_PARAMS.match(p)
    )
    path = parts.path.rstrip("/") or "/"
    host = parts.netloc.lower().removeprefix("www.")
    return urlunsplit((parts.scheme, host, path, query, ""))


class PageParser(HTMLParser):
    """Extrait titre, meta description, h1 et liens (avec zone in-body ou non)."""

    def __init__(self, base_url):
        super().__init__(convert_charrefs=True)
        self.base_url = base_url
        self.title = ""
        self.description = ""
        self.h1 = ""
        self.links = []  # (href, anchor_text, in_body, passage)
        self._block_parts = []      # texte du bloc courant
        self._block_anchor_len = 0  # part de ce texte occupée par des ancres
        self._pending = []          # index des liens ouverts dans ce bloc
        self._chrome_depth = 0
        self._in_title = False
        self._in_h1 = False
        self._current_link = None  # [href, [text_parts], in_body]

    def handle_starttag(self, tag, attrs):
        attrs = dict(attrs)
        if tag in BLOCK_TAGS:
            self._fermer_bloc()
        if tag in CHROME_TAGS:
            self._chrome_depth += 1
        elif tag == "title":
            self._in_title = True
        elif tag == "h1":
            self._in_h1 = True
        elif tag == "meta" and attrs.get("name", "").lower() == "description":
            self.description = (attrs.get("content") or "").strip()
        elif tag == "a" and attrs.get("href"):
            self._current_link = [attrs["href"], [], self._chrome_depth == 0]

    def _fermer_bloc(self):
        """Attribue le texte du bloc aux liens qu'il contient, puis repart à vide."""
        texte = re.sub(r"\s+", " ", "".join(self._block_parts)).strip()
        prose = len(texte) - self._block_anchor_len
        if texte and prose >= PROSE_MIN and len(texte.split()) >= PROSE_MOTS_MIN:
            for i in self._pending:
                if not self.links[i][3]:
                    self.links[i][3] = texte[:PASSAGE_MAX]
        self._block_parts = []
        self._block_anchor_len = 0
        self._pending = []

    def close(self):
        super().close()
        self._fermer_bloc()

    def handle_endtag(self, tag):
        if tag in BLOCK_TAGS:
            self._fermer_bloc()
        if tag in CHROME_TAGS and self._chrome_depth > 0:
            self._chrome_depth -= 1
        elif tag == "title":
            self._in_title = False
        elif tag == "h1":
            self._in_h1 = False
        elif tag == "a" and self._current_link:
            href, parts, in_body = self._current_link
            anchor = re.sub(r"\s+", " ", "".join(parts)).strip()
            self.links.append([href, anchor, in_body, ""])
            self._block_anchor_len += len(anchor)
            self._pending.append(len(self.links) - 1)
            self._current_link = None

    def handle_data(self, data):
        if self._in_title:
            self.title += data
        if self._in_h1 and not self.h1.strip():
            self.h1 += data
        if self._current_link:
            self._current_link[1].append(data)
        self._block_parts.append(data)


def main():
    ap = argparse.ArgumentParser(description=__doc__)
    ap.add_argument("sitemap", help="URL du sitemap.xml ou URL de base du site")
    ap.add_argument("-o", "--out", default=".", help="dossier de sortie")
    ap.add_argument("--limit", type=int, default=0, help="max de pages (0 = tout)")
    ap.add_argument("--delay", type=float, default=0.2, help="pause entre requêtes (s)")
    args = ap.parse_args()

    sitemap = args.sitemap
    if not sitemap.endswith(".xml"):
        sitemap = sitemap.rstrip("/") + "/sitemap.xml"

    pages = sitemap_urls(sitemap)
    if args.limit:
        pages = pages[: args.limit]
    site_host = urlsplit(pages[0]).netloc.lower().removeprefix("www.")
    known = {normalize(u, u) for u in pages}

    index, edges, errors = {}, [], []
    for i, url in enumerate(pages, 1):
        page_key = normalize(url, url)
        try:
            html = fetch(url)
        except Exception as e:
            errors.append({"url": url, "error": str(e)})
            print(f"[{i}/{len(pages)}] ERREUR {url} : {e}", file=sys.stderr)
            continue
        parser = PageParser(url)
        try:
            parser.feed(html)
            parser.close()
        except Exception as e:
            errors.append({"url": url, "error": f"parse: {e}"})
            continue
        for href, anchor, in_body, passage in parser.links:
            target = normalize(href, url)
            if not target or urlsplit(target).netloc != site_host:
                continue
            if target == page_key:
                continue
            edges.append(
                {
                    "source": page_key,
                    "target": target,
                    "anchor": anchor,
                    "in_body": in_body,
                    "passage": passage,
                    "target_in_sitemap": target in known,
                }
            )
        index[page_key] = {
            "url": page_key,
            "title": re.sub(r"\s+", " ", parser.title).strip(),
            "h1": re.sub(r"\s+", " ", parser.h1).strip(),
            "description": parser.description,
            "inbound_in_body": 0,
            "outbound_in_body": 0,
        }
        print(f"[{i}/{len(pages)}] {page_key}", file=sys.stderr)
        if args.delay:
            time.sleep(args.delay)

    # Un même couple (cible, ancre) présent sur la quasi-totalité des pages
    # est un lien de gabarit (menu/footer non sémantique), pas un lien éditorial
    from collections import defaultdict

    pair_sources = defaultdict(set)
    for e in edges:
        if e["in_body"]:
            pair_sources[(e["target"], e["anchor"])].add(e["source"])
    sitewide_threshold = max(3, int(len(index) * 0.8))
    for e in edges:
        e["sitewide"] = (
            e["in_body"]
            and len(pair_sources[(e["target"], e["anchor"])]) >= sitewide_threshold
        )

    # Compteurs sur les liens in-body non sitewide uniquement (nav/footer et
    # liens de gabarit ne comptent pas comme maillage éditorial dans la méthode)
    # inbound_in_body = pages sources distinctes (10 liens depuis un seul article = 1) ;
    # inbound_links_in_body = nombre brut de liens
    inbound_sources = defaultdict(set)
    for p in index.values():
        p["inbound_links_in_body"] = 0
    for e in edges:
        if not e["in_body"] or e["sitewide"]:
            continue
        if e["source"] in index:
            index[e["source"]]["outbound_in_body"] += 1
        if e["target"] in index:
            index[e["target"]]["inbound_links_in_body"] += 1
            inbound_sources[e["target"]].add(e["source"])

    for u, p in index.items():
        p["inbound_in_body"] = len(inbound_sources[u])
    orphans = [u for u, p in index.items() if p["inbound_in_body"] == 0]
    dead_ends = [u for u, p in index.items() if p["outbound_in_body"] == 0]

    import os

    os.makedirs(args.out, exist_ok=True)
    with open(os.path.join(args.out, "index.json"), "w") as f:
        json.dump(
            {
                "site": site_host,
                "crawled": len(index),
                "errors": errors,
                "orphans": orphans,
                "dead_ends": dead_ends,
                "pages": list(index.values()),
            },
            f,
            ensure_ascii=False,
            indent=2,
        )
    with open(os.path.join(args.out, "graph.json"), "w") as f:
        json.dump(edges, f, ensure_ascii=False, indent=2)

    in_body_edges = sum(1 for e in edges if e["in_body"] and not e["sitewide"])
    sitewide_edges = sum(1 for e in edges if e["sitewide"])
    print(
        f"\n{len(index)} pages crawlées, {len(edges)} liens internes "
        f"({in_body_edges} éditoriaux, {sitewide_edges} de gabarit), "
        f"{len(orphans)} orphelines, "
        f"{len(dead_ends)} dead-ends, {len(errors)} erreurs.\n"
        f"Sorties : {args.out}/index.json et {args.out}/graph.json"
    )


if __name__ == "__main__":
    main()

La méthode compte les pages sources distinctes : dix liens depuis une même page représentent une seule source. Les liens de navigation sont comptés à part.

Le 11 novembre, le script a exploré les 89 URL du sitemap en deux minutes, une requête à la fois. Il retire la barre oblique finale des adresses et suit les redirections sans les consigner. L’essai a donc ajouté un contrôle HTTP sans suivi automatique : cinq liens du corps passaient par une 301 et deux menaient à une 404.

Le script lit le HTML reçu sans rendu dans Chrome. Il ne contrôle donc pas les liens ajoutés ensuite par JavaScript.

Utiliser Search Console pour repérer les pages commerciales prioritaires

maillage-interne-gsc complète cette analyse avec les requêtes et les impressions. Une page mère potentielle associe des impressions élevées, une position entre 4 et 15 et une requête transactionnelle. La méthode demande aussi qu’une page d’information renvoie vers au moins une page d’action pertinente.

Prompt
/maillage-interne-gsc Analyse le maillage de [DOMAINE] à partir de [EXPORT SEARCH CONSOLE] et du crawl [FICHIER].

Vérifie que les requêtes sont reliées aux URL. Indique les périodes disponibles, les seuils retenus et les données manquantes.

Utilise Search Console pour repérer les pages commerciales prioritaires et le crawl pour confirmer leur nombre de sources de liens. Ne déduis pas un manque de liens du seul taux de clics.

Propose les pages sources, les pages cibles et les ancres, avec un passage vérifié pour chaque lien. Signale les conflits de cannibalisation à résoudre avant de modifier le maillage.
~/.claude/skills/maillage-interne-gsc/SKILL.md · 1 365 mots
---
name: maillage-interne-gsc
description: |
  Analyse et optimisation du maillage interne depuis les données GSC. Hiérarchie page mère/fille/petite-fille selon la méthode Boussardon. Pipeline en 5 étapes : récupérer GSC → diagnostiquer la structure (mères potentielles, sous-maillées, orphelines) → construire le plan de maillage avec règles Know→Do → prioriser par score urgence → générer recommandations (page source, destination, ancre, contexte). Sortie obligatoire en plus du tableau : un rapport de pré-décision (diagnostic, preuves typées, état Critique / À améliorer / Sain, actions P1-P3 avec confiance, effort et risque, jamais de score affiché) ; sans lui le skill n'a pas terminé.

  TOUJOURS utiliser ce skill quand l'utilisateur dit : "maillage interne", "liens internes", "cocon SEO", "pages orphelines", "GSC + structure de site", quand un fichier GSC est uploadé.
---

# Skill — Maillage Interne GSC

## Quand déclencher

Analyse et optimisation du maillage interne depuis les données GSC. Hiérarchie page mère/fille/petite-fille.

## Philosophie

> "Le maillage interne, c'est la puissance. Et ça part de tes mots-clés."

- Page mère = citée depuis des pages filles/petites-filles distinctes, liens du corps (repère interne : 5 ; les anciennes règles disaient 10, les deux sont des repères de travail, pas des seuils de santé)
- Le maillage part de la stratégie de mots-clés → le cocon est la conséquence
- Priorité : transactionnel > décisionnel > informationnel
- Maillage par intention (Know → Do) en plus du maillage sémantique

## Input requis

| Source | Obligatoire |
|--------|-------------|
| Export GSC Pages — URL, Clics, Impressions, CTR, Position | Oui |
| Export GSC Requêtes par page | Recommandé |
| Période 3-6 mois | Recommandé |

## Pipeline (5 étapes)

1. **Récupérer les données GSC** — export Pages + Requêtes par URL
2. **Diagnostiquer la structure** :
   - Pages mères potentielles (impressions élevées, pos 4-15, requête transactionnelle)
   - Pages sous-maillées : déficit de liens entrants confirmé par un crawl ; le CTR seul ne le démontre pas
   - Pages orphelines : aucun lien entrant détecté dans le périmètre du crawl, à expliciter ; la GSC seule ne le démontre pas
3. **Construire le plan de maillage** — hiérarchie mère/fille/petite-fille + règles Know→Do
4. **Prioriser** — plus de score numérique (Tim, 28/09/2026 : l'ancienne formule `(Impressions × 0.4) + (Potentiel position × 0.4) + (Business value × 0.2)` additionnait des grandeurs non normalisées, les impressions écrasaient le reste). Priorité justifiée, dans cet ordre : (a) page business prioritaire à fort déficit de maillage (forte en impressions, peu de liens entrants éditoriaux depuis des pages distinctes) ; (b) page en position 4-15 sur une requête transactionnelle que des liens entrants peuvent aider ; (c) page en forte baisse sur 90 jours contre 90 (tendance `declining`) ; (d) le reste. Chaque recommandation écrit la raison de son rang.
5. **Générer les recommandations** — page source + page destination + ancre + contexte + priorité

## Structure hiérarchique

```
Page Mère (mot-clé principal business)
├── Page Fille 1 (requête secondaire transactionnelle)
│   ├── Page Petite-Fille A (longue traîne / micro-intention)
│   └── Page Petite-Fille B
└── Page Fille 2
```

Règle Know → Do : chaque page Know doit pointer vers au moins 1 page Do thématiquement reliée.

## Sortie de pré-décision (obligatoire)

Ce skill n'a pas terminé tant que le rapport de pré-décision n'est pas écrit. Il fait partie de la sortie, au même titre que le tableau, et applique le format de restitution décrit ci-dessous. Fichier : `wiki/maillage/YYYY-MM-DD-slug-gsc-decision.md`.

Ce qu'il contient, dans cet ordre :

1. Diagnostic principal : une phrase, la cause structurante, pas une liste d'erreurs
2. Les chiffres à retenir : 3 à 5, ceux qui illustrent le diagnostic
3. État : Critique, À améliorer ou Sain, calculé sur l'impact SEO réel et le type de page, jamais sur le nombre d'erreurs ; jamais de score sur 10
4. Problèmes (3 maximum) et opportunités (5 maximum), séparés : chacun avec Preuve (2 à 4 données), Pourquoi c'est important, Action, Confiance (forte / moyenne / faible) ; chaque problème s'écrit en trois temps : observation prouvée → conséquence ou risque justifié → bénéfice attendu de la correction (l'observation seule n'est pas un frein SEO démontré)
5. Actions P1 / P2 / P3, 3 P1 maximum : pourquoi, preuve, signal attendu (jamais un résultat chiffré promis), dépendance préalable, test de validation (ce qui distingue « correction appliquée » de « résultat SEO observé »), effort faible / moyen / élevé (jamais en heures), confiance, risque low / medium / high ; toute action high (suppression, 301, fusion, changement d'URL) porte « À valider avant déploiement » et sa checklist
6. Ce que les données ne permettent pas de conclure, et « données insuffisantes » ou « ne rien faire » quand c'est le cas

Sur le périmètre de ce skill, le rapport tranche les pages fortes en impressions et sous-liées, tendance 28 jours contre 28 et 90 contre 90 par page stratégique (growing / stable / declining / new / insufficient_data), les fortes baisses en premier.

Règles : chaque information est typée FACT, HYPOTHESIS ou ACTION, jamais une hypothèse écrite comme un fait ; un problème existe une seule fois (ID), les observations qui parlent du même problème fusionnent ; une anomalie n'est pas une priorité par défaut ; les pages business et les tendances GSC passent avant les anomalies techniques secondaires ; jamais de recommandation automatique de fusion, 301, suppression, réécriture ou création de page ; Google n'est jamais anthropomorphisé. Phrases courtes, une donnée par diagnostic, aucune des phrases « Il est important de », « Il convient de », « Cela peut potentiellement », « Il est intéressant de noter », « Dans le cadre de ».

Restitution (corrections V2 du 23 septembre) : aucun ID technique ni mot anglais (low / medium / high) dans le rapport ; Faible / Moyen / Élevé partout ; la certitude affichée ne dépasse jamais la couverture des données (« aucun problème majeur détecté sur les URL inspectées », pas « Sain ») ; formulations précises (« URL en 404 avec encore des impressions ») ; aucune action proposée sur une page dont les requêtes ne sont pas connues (« à vérifier ») ; le nombre de mots seul n'est jamais un problème ; limites de longueur : diagnostic 70 mots, 4 chiffres, 3 problèmes de 40 mots, 6 actions, 3 opportunités de 35 mots, le reste dans les détails repliés.

Onglet Analyse technique, structure validée le 23 septembre 2026 : chaque priorité = une phrase de cadrage, « Ce qu'on observe » (faits chiffrés en liste, pages en code), « Pourquoi c'est prioritaire » (deux phrases), « Action » (liste numérotée courte), « Impact attendu » et « Risque » en gras ; puis le plan des 30 jours en trois paliers (Priorité immédiate, Deuxième étape, Priorité secondaire), une action par paragraphe en gras suivie d'une phrase ; puis « à surveiller avant d'agir » pour la page dont la cause n'est pas isolée ; puis « Autres pages à surveiller » : chiffres séparés par « · », une phrase, verdict en gras (« Aucune action recommandée », « À vérifier avant toute modification »).

## Output obligatoire

Pour chaque action :
- Page source (intention Know/Do/Know+Do)
- Page destination + intention
- Nature du lien (sémantique ou intentionnel Know→Do)
- Ancre recommandée (jamais "cliquez ici")
- Contexte d'insertion
- Priorité (Haute/Moyenne/Faible)

## Règles absolues

- Ne pas automatiser à 100% — le maillage part de la stratégie, pas des outils
- Ne pas mailler sans tenir compte de l'intention (sémantique ≠ intentionnel)
- Ne pas répéter la même ancre sur toutes les pages filles
- Une page mère se juge à ses citations depuis des pages distinctes, dans le corps (repère : 5) ; jamais un total brut qui mélange navigation et contexte

## Sauvegarde

Output dans `wiki/maillage/YYYY-MM-DD-slug.md` dans le dossier de travail du projet.

## Concepts liés

`cocon-semantique` · `pagerank-interne` · `intention-recherche` · `cannibalisation` · `gsc-export`




## Contrôle avant livraison
Vérifier la demande, les données réellement consultées, les fichiers produits, les sources, les limites et le périmètre autorisé. Chaque fait doit être traçable. Indiquer les contrôles non exécutés. Ne publier ni modifier un site distant sans autorisation.

Sur 90 jours, deux pages concentraient 377 des 466 impressions des requêtes d’achat en position 4 à 15 : /consultant-seo-geo-lyon/, avec 220 impressions, et /bootcamp-candidature/, avec 157. Elles recevaient respectivement deux et zéro lien depuis le corps des autres pages.

Les seuils ne sont pas universels. Pour cet essai, le minimum retenu était de cinq liens entrants pour une page mère et de plus de 100 impressions sur 90 jours pour qualifier un volume d’impressions d’élevé. Il faut fixer ces critères avant l’analyse et les écrire dans le rapport.

Les deux méthodes n’ont pas produit la même hiérarchie. L’analyse structurelle, fondée sur les titres, classait ces pages parmi les pages secondaires. L’analyse Search Console les retenait comme pages mères potentielles à partir de leur visibilité sur les recherches commerciales.

La méthode prévoit aussi des comparaisons de 28 jours contre les 28 jours précédents et de 90 jours contre les 90 jours précédents. Ses entrées ne réclamaient pourtant pas explicitement la période antérieure. Faute de cet export le 11 novembre, la tendance est restée classée « données insuffisantes ».

Confirmer les pages orphelines par le crawl

Le pack précise qu’un déficit de liens entrants doit être confirmé par un crawl. Un faible taux de clics ne le démontre pas. Une page est qualifiée d’orpheline lorsqu’aucun lien entrant n’est détecté dans le périmètre exploré.

Cette règle a changé quatre conclusions lors de l’essai. /accompagnement-1-1-30-jours/ avait reçu 445 impressions, aucun clic et occupait une position moyenne de 70,5. Le crawl a pourtant relevé 13 sources éditoriales pointant vers elle. À l’inverse, /plan-du-site/ et /audit-seo/ étaient orphelines dans le périmètre du crawl malgré 44 et 12 impressions.

Le nombre de pages concernées dépend de la définition retenue :

Périmètre des liens entrantsPages concernées parmi les 89 URL du sitemap
Aucun lien détecté, toutes zones confondues9
Aucun lien depuis le corps d’une page, selon le script20
Aucun lien éditorial selon les critères du skill33

Dix pages n’avaient qu’une source : le plan du site, qui ne recevait lui-même aucun lien. /coaching-seo-lyon/, avec 391 impressions sur 90 jours, faisait partie de ce groupe. Chaque chiffre doit donc rester accompagné de sa définition et du périmètre du crawl.

Choisir une ancre dans un passage réellement publié

L’ancre doit être descriptive, assez courte et cohérente avec la page cible. La méthode prévoit une formulation adaptée à chaque page source.

Pour l’essai, six sous-agents ont travaillé sur des extraits enregistrés localement. Parmi 23 liens examinés depuis 11 pages, 19 reposaient sur un passage retrouvé mot pour mot dans le contenu, avec l’ancre présente dans ce passage. Pour les quatre autres, le rapport recommandait de ne rien faire, ou de ne rien ajouter sans rédiger une nouvelle phrase.

De /etudes-de-cas-seo-b2b/ vers /consultant-seo-geo-lyon/, l’ancre exacte « consultant SEO B2B » a été écartée parce qu’elle était déjà utilisée vers cette cible. La proposition retenue était « j’accompagne les entreprises B2B ».

L’ancre « identifier leurs recherches commerciales prioritaires » a été rejetée pour une autre raison : elle annonçait une méthode de recherche de mots-clés, alors que la destination présentait une offre orientée vers l’acquisition de prospects.

Un décalage comparable a été relevé sur /pre-audit-seo-geo/ : le bouton « Demander mon pré-audit » menait vers /accompagnement-1-1-30-jours/.

Appliquer les liens par lots et vérifier leur présence en ligne

La méthode priorise les pages commerciales orphelines ou insuffisamment reliées. Les liens sont ajoutés par petits lots, puis un nouveau crawl vérifie leur présence.

Pour organikk.co, le plan proposé comprend deux lots : le premier ajoute 12 liens sans dépendance à une décision préalable et corrige les cinq adresses redirigées ; le second ajoute quatre liens avant une nouvelle exploration. Ce découpage reste une proposition d’intervention.

Une correction est considérée comme appliquée lorsque le lien apparaît dans le corps du HTML publié et pointe vers l’adresse finale. Son éventuel effet SEO doit être mesuré séparément. Le suivi prévu porte sur les positions et les clics de « consultant seo b2b », 30 puis 90 jours plus tard, avec un export de même périmètre.

Lire la répartition des liens internes d’organikk.co

Sur 4 305 liens internes, 4 132, soit 96 %, appartenaient au menu, à l’en-tête, au pied de page ou à une barre latérale. Le rapport retenait 105 liens éditoriaux, dont 30 dans un passage de texte.

Parmi les 25 pages d’offre et d’outil, 18 ne recevaient aucun lien depuis le corps d’une autre page : 12 offres sur 19 et les six outils. Le site comptait aussi 44 impasses, définies ici comme des pages sans lien éditorial sortant, dont 26 pages vidéo et l’accueil.

Les deux analyses ont proposé 19 liens associés à des phrases déjà publiées et sept adresses de liens à corriger.

L’analyse Search Console du maillage n’a identifié aucun conflit entre pages, car ses exports ne comportaient pas de dimension temporelle. L’analyse de cannibalisation du même jour, fondée sur un export par date, pays et appareil, a confirmé un conflit sur « coaching seo ». Le rapport demande donc de décider quelle page doit porter cette requête avant d’ajouter des liens vers /coaching-seo-lyon/.

07 · Vérifier si plusieurs pages se concurrencent sur les mêmes requêtes

Séparer les conflits confirmés des simples chevauchements

La méthode distingue trois situations : cannibalisation confirmée, chevauchement potentiel et pages proches qui répondent à des intentions différentes.

Une requête associée à plusieurs URL fournit une liste de candidats à examiner. Elle ne prouve pas un conflit. Le skill rapproche les intentions, puis observe les données dans le temps et par segment, notamment le pays et l’appareil.

Prompt
/seo-cannibalisation Cherche les cannibalisations de [DOMAINE] dans [EXPORT REQUÊTES × PAGES DES 90 DERNIERS JOURS].

Vérifie les requêtes communes, les intentions des pages et les évolutions par date, pays et appareil lorsque ces dimensions sont disponibles.

Distingue les conflits confirmés, les chevauchements potentiels et les pages différenciables. Précise la couverture des données et les analyses impossibles.

Justifie toute fusion ou redirection au-delà du simple chevauchement. Présente ces actions pour validation avant déploiement et conserve la possibilité de ne rien modifier.
~/.claude/skills/seo-cannibalisation/SKILL.md · 1 541 mots
---
name: seo-cannibalisation
description: |
  Audit de cannibalisation SEO depuis les données GSC. Identifie les pages en compétition interne sur les mêmes mots-clés ou intentions, classifie le type de conflit (mot-clé exact, même intention, proximité sémantique, Triade SERP), analyse les métriques, recommande l'action (301, fusion, différenciation, maillage croisé, ou aucune action si Triade SERP). Sortie obligatoire en plus du tableau : un rapport de pré-décision (diagnostic, preuves typées, état Critique / À améliorer / Sain, actions P1-P3 avec confiance, effort et risque, jamais de score affiché) ; sans lui le skill n'a pas terminé.

  TOUJOURS utiliser ce skill quand l'utilisateur dit : "cannibalisation", "deux pages sur le même mot-clé", "je rankais mieux avant", "pages en compétition interne", "keyword cannibalism", "audit cannibalisation".
---

# Skill — Cannibalisation SEO

## Quand déclencher

Deux pages se concurrencent sur les mêmes mots-clés ou intentions. Chutes de positions inexpliquées, CTR qui stagne malgré le volume.

## Input requis

| Source | Obligatoire |
|--------|-------------|
| Export GSC Requêtes — filtré par URL, 90j | Oui |
| Liste des URLs (scraping ou sitemap) | Recommandé |
| Contexte stratégique (pilier vs satellite) | Recommandé |

## Pipeline (5 étapes)

1. **Identifier les coexistences** — requêtes qui déclenchent 2+ URLs dans la GSC. Ce sont des candidats, pas des conflits. La taille du site n'exclut rien : deux pages suffisent à se concurrencer (Tim, 28/09/2026, le seuil de 10 URL de la Phase 4 du workflow est supprimé).
1bis. **Lire dans le temps et par segment avant de qualifier** — sur la période, les deux URL coexistent-elles ou se succèdent-elles (une remplace l'autre) ? Servent-elles des pays ou des appareils différents ? Répondent-elles à des facettes complémentaires de la même requête ? GSC attribue une grande partie des performances aux URL canoniques : vérifier la canonical de chaque URL avant de lire ses chiffres. Une succession, deux marchés ou deux réponses complémentaires ne sont pas des conflits.
2. **Classifier le type** :
   - **(A) Mot-clé exact** — deux pages sur la même requête précise
   - **(B) Même intention** — deux pages répondent à la même intention
   - **(C) Proximité sémantique** — sujets proches sans conflit direct
   - **(Triade SERP)** — opportunité, pas conflit
3. **Analyser les métriques** — position, impressions, clics, CTR par page
4. **Évaluer l'architecture** — pilier vs satellite, objectif business
5. **Proposer l'action, avec sa justification** — le tableau ci-dessous donne l'action type par situation ; une fusion ou une 301 demande une justification plus forte qu'un simple chevauchement (métriques des deux pages, lecture temporelle et segmentée faite, contenu lu, destination claire) et porte toujours « À valider avant déploiement » :

| Situation | Action |
|-----------|--------|
| Type A + perdante faible | Redirection 301 |
| Type A + deux fortes | Fusion + 301 |
| Type B + micro-intentions distinctes | Différenciation + maillage croisé |
| Type C | Renforcement maillage vers pilier |
| Triade SERP | Aucune action — optimiser chaque angle |

## Sortie de pré-décision (obligatoire)

Ce skill n'a pas terminé tant que le rapport de pré-décision n'est pas écrit. Il fait partie de la sortie, au même titre que le tableau, et applique le format de restitution décrit ci-dessous. Fichier : `wiki/cannibalisation/YYYY-MM-DD-slug-decision.md`.

Ce qu'il contient, dans cet ordre :

1. Diagnostic principal : une phrase, la cause structurante, pas une liste d'erreurs
2. Les chiffres à retenir : 3 à 5, ceux qui illustrent le diagnostic
3. État : Critique, À améliorer ou Sain, calculé sur l'impact SEO réel et le type de page, jamais sur le nombre d'erreurs ; jamais de score sur 10
4. Problèmes (3 maximum) et opportunités (5 maximum), séparés : chacun avec Preuve (2 à 4 données), Pourquoi c'est important, Action, Confiance (forte / moyenne / faible) ; chaque problème s'écrit en trois temps : observation prouvée → conséquence ou risque justifié → bénéfice attendu de la correction (l'observation seule n'est pas un frein SEO démontré)
5. Actions P1 / P2 / P3, 3 P1 maximum : pourquoi, preuve, signal attendu (jamais un résultat chiffré promis), dépendance préalable, test de validation (ce qui distingue « correction appliquée » de « résultat SEO observé »), effort faible / moyen / élevé (jamais en heures), confiance, risque low / medium / high ; toute action high (suppression, 301, fusion, changement d'URL) porte « À valider avant déploiement » et sa checklist
6. Ce que les données ne permettent pas de conclure, et « données insuffisantes » ou « ne rien faire » quand c'est le cas

Sur le périmètre de ce skill, le rapport tranche les conflits, trois états : cannibalisation confirmée (même requête GSC + intention concordante), chevauchement potentiel, pages proches mais différenciables ; fusion seulement pour confirmée + destination claire, sinon vérifier, repositionner, différencier ; toute fusion ou 301 = « À valider avant déploiement » + checklist.

Règles : chaque information est typée FACT, HYPOTHESIS ou ACTION, jamais une hypothèse écrite comme un fait ; un problème existe une seule fois (ID), les observations qui parlent du même problème fusionnent ; une anomalie n'est pas une priorité par défaut ; les pages business et les tendances GSC passent avant les anomalies techniques secondaires ; jamais de recommandation automatique de fusion, 301, suppression, réécriture ou création de page ; Google n'est jamais anthropomorphisé. Phrases courtes, une donnée par diagnostic, aucune des phrases « Il est important de », « Il convient de », « Cela peut potentiellement », « Il est intéressant de noter », « Dans le cadre de ».

Restitution (corrections V2 du 23 septembre) : aucun ID technique ni mot anglais (low / medium / high) dans le rapport ; Faible / Moyen / Élevé partout ; la certitude affichée ne dépasse jamais la couverture des données (« aucun problème majeur détecté sur les URL inspectées », pas « Sain ») ; formulations précises (« URL en 404 avec encore des impressions ») ; aucune action proposée sur une page dont les requêtes ne sont pas connues (« à vérifier ») ; le nombre de mots seul n'est jamais un problème ; limites de longueur : diagnostic 70 mots, 4 chiffres, 3 problèmes de 40 mots, 6 actions, 3 opportunités de 35 mots, le reste dans les détails repliés.

Onglet Analyse technique, structure validée le 23 septembre 2026 : chaque priorité = une phrase de cadrage, « Ce qu'on observe » (faits chiffrés en liste, pages en code), « Pourquoi c'est prioritaire » (deux phrases), « Action » (liste numérotée courte), « Impact attendu » et « Risque » en gras ; puis le plan des 30 jours en trois paliers (Priorité immédiate, Deuxième étape, Priorité secondaire), une action par paragraphe en gras suivie d'une phrase ; puis « à surveiller avant d'agir » pour la page dont la cause n'est pas isolée ; puis « Autres pages à surveiller » : chiffres séparés par « · », une phrase, verdict en gras (« Aucune action recommandée », « À vérifier avant toute modification »).

## Output obligatoire

Trois états, dans cet ordre, et on ne saute pas d'étape : **coexistence observée → conflit probable → action proposée avec justification**. Une coexistence sans lecture temporelle et segmentée reste une coexistence.

```
COEXISTENCE OBSERVÉE
Requête : '[requête]' — Type candidat : (A/B/C/Triade)
| URL | Canonical | Position | Impressions | Clics | CTR | Période de présence | Pays / appareil |

→ Lecture temporelle et segmentée : [succession / coexistence stable / marchés distincts / réponses complémentaires]
→ État : [coexistence observée, rien à faire / conflit probable / conflit confirmé]
→ Action proposée : [aucune action / différenciation / maillage / fusion / 301] — Justification : [métriques + contenu lu + destination]
   (fusion et 301 : « À valider avant déploiement » + checklist)
```

## Règles absolues

- Ne pas recommander une 301 sans analyser les métriques des deux pages
- Ne pas traiter toutes les cannibalisations de la même façon
- Ne pas confondre duplication de contenu et cannibalisation
- Ne pas fusionner des pages avec micro-intentions distinctes
- Identifier les Triades SERP comme opportunités, pas comme problèmes
- La taille du site n'exclut jamais un conflit : aucun seuil minimal d'URL
- Aucune fusion ni 301 sans lecture temporelle et segmentée préalable et sans avoir lu les deux contenus ; « aucune action » est une sortie normale
- « Conflit probable » exige des requêtes communes mesurées ou une évolution qui attribue une perte à la concurrence des deux pages (Tim, 28/09/2026). Un recouvrement de contenu seul, avec des requêtes indisponibles, s'écrit : « les deux pages décrivent une offre proche, leur rôle doit être clarifié ; les données présentées ne démontrent pas qu'elles se pénalisent dans Google ». La différenciation éditoriale peut être proposée, jamais vendue comme la correction d'une cannibalisation diagnostiquée.

## Sauvegarde

Output dans `wiki/cannibalisation/YYYY-MM-DD-slug.md` dans le dossier de travail du projet.

## Concepts liés

`triade-serp` · `rrf` · `maillage-interne` · `intention-recherche` · `gsc-export`




## Contrôle avant livraison
Vérifier la demande, les données réellement consultées, les fichiers produits, les sources, les limites et le périmètre autorisé. Chaque fait doit être traçable. Indiquer les contrôles non exécutés. Ne publier ni modifier un site distant sans autorisation.

Le 11 novembre, 35 des 276 requêtes visibles d’organikk.co étaient associées à au moins deux URL sur 90 jours. Le rapport a classé 12 requêtes en conflit confirmé, réparties entre deux groupes de pages, et quatre en conflit probable.

Les 19 autres ne justifiaient pas d’intervention : elles correspondaient notamment à des successions d’URL, à des recherches de marque ou à une URL supprimée en 410.

La requête « consultant seo b2b » apparaissait sur six URL sans cannibalisation confirmée. L’index du blog, la liste des études de cas et l’article de stratégie répondaient à des intentions différentes. Le rapport conservait toutefois une qualification de conflit probable pour cette requête, à approfondir.

Limiter le diagnostic aux requêtes réellement visibles

Les requêtes accessibles dans l’export représentaient 102 des 283 clics et 3 671 des 6 092 impressions. Les 181 autres clics, soit 64 %, ne pouvaient pas être associés à une requête visible. Le diagnostic porte uniquement sur la partie observable.

L’essai a également examiné les différences d’agrégation des impressions. Search Console peut compter par URL ou par propriété selon les données et les filtres. Lorsque plusieurs URL du site apparaissent dans les mêmes résultats, la somme des impressions par URL peut dépasser le total agrégé pour la requête.

Le test a rapporté cet écart au total de la requête pour examiner les affichages multiples. Ce calcul doit conserver les mêmes dates et segments ; il ne remplace pas la lecture des pages et de leurs intentions. L’export par date, pays et appareil a servi à observer les alternances dans le temps.

Choisir une action en fonction des pages et de leur intention

Le skill propose les actions suivantes, sous réserve de vérifier le cas :

Situation examinéeAction envisagée
Même mot-clé, avec une page faible qui concurrence la page retenueRedirection 301
Deux pages solides répondant au même besoinFusion des contenus puis 301
Intention commune, avec des besoins précis distinctsDifférenciation des pages et liens croisés
Proximité sémantique sans conflit démontréLiens vers la page principale
Plusieurs pages présentant des angles complémentaires dans les résultats, situation appelée « triade SERP » dans la méthodeMaintien des pages et amélioration de chaque angle

Une fusion ou une redirection exige davantage qu’un chevauchement de requêtes. Elle reste à valider avant déploiement. La méthode exclut la fusion de pages répondant à des intentions différentes et prévoit de ne rien faire lorsque les données ne justifient pas de modification.

Sur « coaching seo », le conflit a été confirmé, mais aucune destination claire n’a été retenue pour une fusion ou une 301. Le rapport demande d’explorer /accompagnement-1-1-30-jours/, puis d’observer les deux pages pendant 28 jours sans les modifier.

Pour « consultant seo b2b », il propose des liens depuis le texte de /a-propos/ et de /blog/ vers la page B2B.

Examiner les deux pages consacrées au référencement à Lyon

Le 22 septembre, l’audit ne confirmait aucune cannibalisation. Le 11 novembre, il en relevait deux groupes : Lyon et coaching. Les pages Lyon avaient reçu leurs premières impressions les 7 et 10 octobre, après le premier audit.

/consultant-seo-geo-lyon/, la page B2B, et /consultant-seo-lyon/, la page régionale, apparaissaient sur cinq requêtes communes.

PageClics sur les cinq requêtes communesImpressionsPosition moyenne
/consultant-seo-geo-lyon/2519218,2
/consultant-seo-lyon/22041,6

Les pages alternaient sur « consultant seo b2b lyon » du 12 au 20 octobre. Dans le périmètre hors marque visible rapporté par l’essai, cette requête apportait 29 des 45 clics. Ce total n’est pas présenté comme celui du tableau précédent, qui porte sur les cinq requêtes communes aux deux pages.

Les contenus partageaient 75 phrases identiques, soit 39 % des phrases de la page B2B. La distinction prévue, B2B pour l’une et région pour l’autre, n’apparaissait pas clairement dans les requêtes : « consultant seo lyon » était associée à la page B2B dans 95 des 96 occurrences relevées.

Le rapport propose une 301 de /consultant-seo-lyon/ vers /consultant-seo-geo-lyon/, à valider avant déploiement avec une liste de sept contrôles. Si les deux pages sont conservées, leurs H1, leurs titres et leurs sections communes devront être différenciés.

L’hypothèse d’une contribution de cette alternance au recul de la page B2B reste ouverte. Les impressions de la requête diminuaient également pendant cette période, après un pic le 8 octobre. Le relevé ne permet pas d’isoler la cause.

08 · Programmer les audits et vérifier les rapports réellement produits

Vérifier l’environnement avant de planifier une exécution

Le skill d’indexation propose un audit mensuel avec /schedule, le premier du mois à 1 h, dans l’environnement cloud par défaut d’Anthropic. Il annonce cinq à dix minutes par exécution.

La procédure consignée dans le relevé du 11 novembre décrit une fonction en « research preview » : chaque exécution cloud commence par cloner le dépôt, et une fréquence supérieure à une exécution par heure est refusée.

L’application de bureau prévoit aussi des tâches planifiées, mais leur exécution dépend d’une application ouverte et d’un ordinateur éveillé. Le relevé indique qu’une exécution manquée n’est rattrapée qu’une fois. Ces conditions doivent être vérifiées dans l’environnement utilisé avant de programmer l’audit.

Le 11 novembre, mon Mac s’est mis en veille de 15 h 33 à 17 h 05 pendant la campagne de vitesse. Un appel à PageSpeed a été interrompu deux fois avant de reprendre.

Lancer un contrôle sans conversation interactive

La procédure utilise claude -p pour lancer une exécution non interactive. Le nom du skill est inclus dans le prompt ; elle demande de ne pas ajouter --bare, qui désactive la découverte des skills dans le fonctionnement décrit.

Terminal
claude -p "/indexation-check Audite l'indexation de [domaine] à partir de [adresse du sitemap]."

Cette commande lance un contrôle. Sa planification exige un mécanisme distinct, configuré dans l’environnement choisi.

J’utilise deux routines. La première, créée le 9 juin 2026, s’exécute dans le cloud chaque lundi à 7 h UTC. Elle relit sa mémoire et demande d’appliquer indexation-check, en lecture seule sur le web public, sans forçage d’indexation. Si une modification du skill semble nécessaire, elle doit la proposer dans un fichier de questions plutôt que l’appliquer.

Le dépôt cloné par cette routine ne contient pas le skill. Je suppose qu’elle suit son prompt et sa mémoire, qui reprennent une partie de ses consignes, mais je ne l’ai pas vérifié sur une exécution. Je ne peux donc pas affirmer qu’elle charge réellement la méthode complète.

La seconde routine est locale. Elle est lancée par launchd, le 5 du mois à 8 h 30, sur mes trois sites, avec un rapport attendu par site.

Contrôler la date du dernier rapport, pas seulement l’état de la tâche

Le 9 septembre 2026, quinze routines de mon système avaient cessé de s’exécuter pendant deux jours sans le signaler. Je vérifie donc la date inscrite dans le nom du dernier fichier produit, plutôt que sa seule date de modification.

Le 11 novembre, ce contrôle a montré que la tâche locale mensuelle n’avait rien produit depuis le 5 septembre. Les journaux de juillet, août et septembre existaient, mais aucun pour octobre ni novembre. L’agent était chargé et son dernier code de sortie était 0 ; la cause de l’arrêt n’était pas établie.

Le tableau de suivi affichait pourtant « Contrôle d’indexation : à jour ». Il associait la tâche mensuelle aux fichiers reports/indexation-*.md, produits par la routine du lundi. La présence d’un rapport ne suffisait donc pas à confirmer l’exécution de la bonne tâche.

Délimiter ce que les essais permettent d’affirmer

Ces essais portent sur un seul site, le mien. Quatre des cinq sujets avaient été audités le 22 septembre 2026 avec des versions précédentes des skills. Les cinq ont été examinés le 11 novembre avec le pack. La routine du lundi effectue ses contrôles d’indexation depuis le 15 juin.

Je n’ai comparé ces méthodes à aucun crawler ni outil payant. Je ne dispose pas d’un cas client publiable pour cet essai et je n’ai mesuré l’effet SEO d’aucune correction proposée ici. Les chiffres décrivent les contrôles exécutés et les observations obtenues sur organikk.co.

09 · Commencer par les URL importantes, puis compléter l’audit avec la vitesse et les liens

Lance indexation-check sur le sitemap et les pages importantes. Avant d’interpréter le rapport, vérifie combien d’URL ont réellement été inspectées et quels contrôles ont échoué.

Tu peux décider de la suite lorsque le rapport distingue les blocages confirmés des points non vérifiés. « Aucun défaut d’indexation confirmé sur les N pages inspectées » n’est utile que si le nombre de pages et les limites du contrôle sont explicites.

Mesure ensuite la vitesse sur un échantillon qui couvre les pages commerciales. Le maillage structurel peut commencer sans Search Console ; l’analyse fondée sur les requêtes et la cannibalisation nécessitent les exports associant requêtes et pages.

Prompt
À partir des rapports de [PROJET], prépare les prochaines actions SEO.

Commence par les problèmes d’indexation confirmés sur les pages importantes. Distingue les corrections justifiées, les hypothèses à tester et les contrôles à relancer faute de données.

Vérifie que les pages commerciales sont représentées dans les tests de vitesse. Pour le maillage et la cannibalisation, précise les exports Search Console disponibles et ceux qui manquent.

Pour chaque action, indique la page, la preuve, la modification proposée et le contrôle à effectuer après son application. Présente le plan pour validation sans modifier le site.

10 · Répondre aux questions d’installation, de balisage et d’accès aux données

Peut-on utiliser ces méthodes sur un site WordPress ?

Les contrôles d’indexation, de vitesse, de maillage et de cannibalisation exploitent des URL, du contenu et des exports. Leurs entrées ne se limitent pas à Next.js. En revanche, le skill de données structurées présenté ici génère du code pour Next.js App Router : son installation ne peut pas être appliquée telle quelle à WordPress.

Faut-il supprimer le balisage FAQPage lorsqu’il ne produit plus de résultat enrichi ?

L’absence de résultat enrichi ne permet pas, à elle seule, de conclure qu’il faut supprimer tout le balisage. Dans cet audit, le premier contrôle consiste à vérifier que les questions et les réponses balisées sont visibles et fidèles au contenu. Le rapport ne démontre aucun gain SEO lié au maintien ou à la suppression de FAQPage.

Comment installer le même pack pour toute une équipe SEO ?

Distribue la même version des six dossiers, avec leurs fichiers scripts/ et references/, puis fais sauvegarder les anciennes versions avant remplacement. Chaque utilisateur doit vérifier que Claude Code trouve les méthodes et que les outils nécessaires sont disponibles. La présence des dossiers ne garantit pas, à elle seule, que les accès Search Console fonctionnent.

Les redirections fondées sur la langue du navigateur ont-elles été testées ?

Non. Les essais décrits ici ne permettent pas de conclure sur leur effet. Pour traiter ce point, il faut un contrôle distinct des URL linguistiques et des réponses servies selon les conditions d’accès. Il ne faut pas présenter cette question comme résolue par les relevés d’organikk.co.

Que faire après une réponse 429 de PageSpeed ou une réponse 403 de Search Console ?

Conserve le code d’erreur et indique que le contrôle n’a pas abouti. Vérifie les accès, les limites d’utilisation et les conditions de relance de l’outil concerné. Tant qu’aucune mesure n’a été obtenue, ne conclus ni sur la vitesse réelle de la page ni sur son indexation.

Quels éléments demander au client avant le premier audit ?

Demande le domaine, le sitemap ou la liste des URL, les pages commerciales prioritaires et les documents disponibles. Pour les analyses Search Console, il faut les exports associant les requêtes aux pages, avec les périodes et les filtres utilisés ; les comparaisons nécessitent aussi la période précédente. Pour générer des données structurées avec la méthode présentée, il faut en plus l’accès au projet Next.js local et une autorisation explicite de modifier le code.

+20 % de trafic qualifié en moyenne
et un ROI de 2 sur notre prestation

Prenons un call