codebase-seo
Auditez, puis révisez GEO, puis appliquez les correctifs. Valeurs par défaut Next.js / TypeScript ; suivez ce que le dépôt utilise déjà. ${CLAUDE_SKILL_DIR} est le répertoire de cette compétence — le répertoire de travail est le projet de l'utilisateur, adressez donc les fichiers groupés via celui-ci.
| Drapeau | Phase | Écrit du code |
|---|---|---|
--audit | 1 — SEO technique | non |
--geo | 2 — Préparation à la citation IA | non |
--fix | 3 — Appliquer les résultats déjà en contexte | oui |
--full | 1 → 2 → 3 (par défaut) | oui |
--routes /,/pricing limite le périmètre ; par défaut, toutes les routes.
Configuration
- Préférez un chemin local et une URL en ligne. Chacun capture ce que l'autre ne peut pas.
- Lisez
.agents/product-marketing.mdou.claude/product-marketing.mdsi l'un d'eux existe. Ne demandez que ce qu'il ne répond pas. --fixnécessite des rapports en contexte. S'ils sont absents, exécutez--full.
Scripts
Nécessite curl et Node 18+, rien à installer. Exécutez-les avant de lire le code source : ils produisent
les preuves, l'inspection du code source les explique. Chacun se termine avec un code non nul en cas de problème de niveau erreur.
Ajoutez --json aux scripts Node pour une sortie structurée.
bash "${CLAUDE_SKILL_DIR}/scripts/redirect-trace.sh" example.com /pricing /blog
node "${CLAUDE_SKILL_DIR}/scripts/extract-jsonld.mjs" https://example.com/pricing
node "${CLAUDE_SKILL_DIR}/scripts/audit-meta.mjs" https://example.com/pricing
node "${CLAUDE_SKILL_DIR}/scripts/audit-meta.mjs" out/pricing.html --base https://example.com
Passez des routes réelles à redirect-trace.sh — les boucles se cachent souvent sur des chemins profonds, pas sur /.
Les trois lisent uniquement le HTML rendu côté serveur. Le JSON-LD injecté côté client leur est invisible, comme il l'est
à web_fetch. N'écrivez jamais "aucun schéma trouvé" sur la seule parole d'un script ; confirmez dans un navigateur.
Phase 1 — audit technique (--audit)
Lisez ${CLAUDE_SKILL_DIR}/references/technical-audit.md et parcourez sa liste de contrôle. Exécutez d'abord les
scripts, puis utilisez le code source pour localiser et expliquer chaque constatation.
Rapport par constatation :
Fichier : app/page.tsx:37-41
Sévérité : Critique | Élevée | Moyenne | Faible
Cause racine : <une phrase>
Impact : <ce qui se casse dans la recherche, les réseaux sociaux ou la citation IA>
Correctif : <changement minimal, fichier + ligne>
Effort : <5 min | 30 min | décision produit>
Groupez par sévérité, puis terminez par un tableau : # | Constatation | Sévérité | Effort | Bloque la publication ?
Phase 2 — revue GEO (--geo)
Lisez ${CLAUDE_SKILL_DIR}/references/geo.md. JSON-LD à copier :
${CLAUDE_SKILL_DIR}/references/schema-recipes.md.
Vérifiez d'abord l'accès des robots — si les crawlers sont bloqués, rien d'autre dans cette phase n'a d'importance.
Deux affirmations à ne jamais faire : que les types de schémas ont un classement de rendement de citation "selon une recherche de Princeton" (cette étude testait des tactiques de contenu, pas les schémas), et toute augmentation de trafic projetée. Ni l'une ni l'autre n'est observable depuis une codebase, et les inventer discrédite les vraies constatations.
Groupez la sortie en Lacunes de schémas, Opportunités de contenu, Décisions d'architecture.
Phase 3 — correctif (--fix)
Applique les constatations des Phase 1 et Phase 2. Modifiez l'arbre de travail et arrêtez-vous — pas de git add,
pas de git commit. La revue et le commit reviennent à l'utilisateur.
- Respectez le framework, la disposition des fichiers et l'orthographe du dépôt. N'imposez pas un dialecte.
- Nommez le fichier exact et la ligne avant chaque modification. Changement minimal, pas de refactorisations annexes, pas de
any. - Raccordez les champs de schéma aux sources de données réelles ; ne codez jamais en dur une valeur qui dérive.
- N'inventez jamais un
aggregateRating. Supprimez-le et listez-le sous "nécessite des données réelles". - Ignorez l'architecture i18n, la copie en dehors des descriptions de schéma, et tout ce que le rapport marque comme nécessitant une décision produit.
Redirections hôte — règle stricte. Une redirection www↔apex, http↔https ou de barre oblique finale
au niveau de l'application qui duplique une redirection déjà effectuée par la plateforme d'hébergement va faire des
allers-retours, produire ERR_TOO_MANY_REDIRECTS et faire tomber le site. Laissez la canonicalisation de l'hôte à la
plateforme. Corrigez une boucle en supprimant la redirection au niveau de l'application, jamais en en ajoutant une autre.
Lorsque l'hôte canonique et l'hôte réellement servi sont en désaccord, changez les métadonnées pour correspondre à l'hôte
effectivement servi — pas la redirection pour correspondre aux métadonnées.
Lot 1 : chaque constatation Critique, Élevée et Moyenne de la Phase 1, dans l'ordre de sévérité. Lot 2 : le travail de schéma de la Phase 2.
Vérifiez avant de signaler comme terminé. Ne prétendez jamais au succès sur la seule force des modifications.
- Le projet compile (
npm run build, ou ce que le dépôt utilise). extract-jsonld.mjsvérifie proprement le HTML compilé ou un serveur de développement.audit-meta.mjspasse sur chaque route modifiée.redirect-trace.sh, si une redirection a été touchée.
Signalez toute étape que vous n'avez pas pu exécuter, et pourquoi.
Sections de sortie : Modifié (par lot), Vérification, Nécessite une décision produit, Nécessite des données réelles.