seo-audit — audit de site & analyse de page

Skill d'analyse, pas de production. La production d'articles et de briefs reste dans la skill seo. Adapté du plugin claude-seo (AgriciDaniel, MIT) — voir docs/vendored-seo.md.

Deux modes

Mode	Déclencheur	Portée
Audit de site	« audit », « check complet », domaine fourni	Homepage + crawl interne (max 50 pages, respecter robots.txt)
Analyse de page	une URL précise fournie	La page seule, en profondeur

Workflow — audit de site

1. Récupérer la homepage (WebFetch ou curl -sL) + robots.txt + sitemap(s).
2. Crawler : suivre les liens internes (max 50 pages, 3 redirections max, respecter robots.txt). Sur les gros sites, échantillonner par gabarit (home, catégorie, article, page produit/service).
3. Déléguer en parallèle aux agents internes :
   • seo-technical — crawlabilité, indexation, canonicals, sécurité, CWV, rendu JS
   • seo-content — E-E-A-T, lisibilité, contenu mince, citabilité IA
   • seo-google — données terrain CrUX / GSC / GA4 (seulement si le couplage /tools-setup est actif)
   • skill seo-geo — crawlers IA, llms.txt, citabilité (si l'audit vise aussi la visibilité IA)
   • skill seo-schema — détection et validation des données structurées
4. Agréger en un score de santé SEO (0-100) :

Catégorie	Poids
SEO technique	25%
Qualité de contenu	25%
On-page	20%
Schema / données structurées	10%
Performance (CWV)	10%
Préparation recherche IA	10%

5. Rapporter dans 09-seo/audits/YYYY-MM-DD-audit-<domaine>.md : résumé exécutif (score, top 5 problèmes critiques, top 5 quick wins), sections par catégorie, plan d'action priorisé.

Workflow — analyse de page unique

Analyser directement (sans sous-agents, sauf besoin) :

On-page

• Title : 50-60 caractères, mot-clé principal, unique
• Meta description : 150-160 caractères, incitative
• H1 unique aligné sur l'intention ; hiérarchie H2-H6 sans saut de niveau
• URL courte, descriptive, avec tirets, sans paramètres
• Maillage interne suffisant, ancres descriptives ; 1-2 liens externes d'autorité

Contenu

• Volume vs type de page (home ≥ 500 mots, page service ≥ 800, article ≥ 1500 — planchers de couverture, pas des cibles)
• Densité de mot-clé naturelle (1-3%), variantes sémantiques
• Signaux E-E-A-T : bio auteur, dates de publication/mise à jour, sources citées

Technique

• Canonical présent et correct ; meta robots ; Open Graph + Twitter Card ; hreflang si multilingue

Images

• Alt descriptif ; poids (> 200 Ko = warning, > 500 Ko = critique) ; formats WebP/AVIF ; dimensions déclarées (CLS) ; loading="lazy" sous la ligne de flottaison

CWV (indices depuis le HTML)

• Risques LCP (hero lourd, ressources bloquantes), INP (JS lourd sans async/defer), CLS (dimensions manquantes, contenu injecté)

Priorités

• Critique : bloque l'indexation ou expose à une pénalité — corriger immédiatement
• Haute : impact significatif sur le ranking — sous 1 semaine
• Moyenne : opportunité d'optimisation — sous 1 mois
• Basse : backlog

Format de sortie (page unique)

Score global : XX/100
On-page XX | Contenu XX | Technique XX | Schema XX | Images XX

Puis : problèmes par priorité → recommandations actionnables → snippets JSON-LD prêts à poser (via skill seo-schema).

Gestion d'erreur

Cas	Action
URL injoignable	Rapporter l'erreur, ne jamais inventer le contenu du site
robots.txt bloque le crawl	Analyser les pages accessibles, noter la limite dans le rapport
Contenu rendu en JS (body vide)	Analyser le HTML disponible, signaler que les résultats sont partiels
Rate limiting (429)	Ralentir, livrer un rapport partiel annoté

Extensions possibles (non vendorées)

Le plugin source couvre aussi : backlinks (APIs Moz/Bing), SEO local & Google Maps, e-commerce, hreflang avancé, drift/baselines, DataForSEO. Si le besoin apparaît, installer le plugin claude-seo complet ou re-vendorer — procédure dans docs/vendored-seo.md.