Compétence d'Audit SEO
Auditez des sites web pour le SEO, le contenu, les performances, la sécurité, le rendu JavaScript et la préparation à l'IA à l'aide de l'outil en ligne de commande SEOmator.
SEOmator propose un audit complet de site web en analysant la structure et le contenu du site selon 251 règles réparties dans 20 catégories.
Il fournit une liste de problèmes avec leur niveau de sévérité, les URL concernées et des suggestions de correctifs exploitables.
Liens
- Paquet npm SEOmator : npmjs.com/package/@seomator/seo-audit
- Dépôt GitHub : github.com/seo-skills/seo-audit-skill
- Interface Web : seomator.com/free-seo-audit-tool
Ce Que Fait Cette Compétence
Cette compétence permet aux agents IA d'auditer des sites web selon 251 règles dans 20 catégories, notamment :
- SEO de base (19 règles) : URL canoniques, directives d'indexation, unicité des titres, conflits/boucles canoniques
- Performances (22 règles) : LCP, CLS, FCP, TTFB, INP, compression, mise en cache, minification, HTTP/2
- Liens (19 règles) : Liens brisés, chaînes de redirection, texte d'ancrage, pages orphelines, liens localhost/fragment
- Images (14 règles) : Texte alternatif, dimensions, chargement différé, formats modernes, longueur du texte alt, images d'arrière-plan
- Sécurité (16 règles) : HTTPS, HSTS, CSP, sécurité des liens externes, fuites de secrets, expiration/protocole SSL
- SEO technique (13 règles) : robots.txt, sitemap.xml, structure d'URL, pages 404, soft 404, codes d'erreur
- Crawlability (18 règles) : Conflits de sitemap, signaux d'indexabilité, chaînes canoniques, problèmes de pagination
- Données structurées (13 règles) : Balisage Schema.org, Article, Organisation, FAQ, Produit, Fil d'Ariane
- Rendu JavaScript (13 règles) : Vérifications du DOM rendu, différences entre brut et rendu, détection SSR
- Accessibilité (12 règles) : Étiquettes ARIA, contraste des couleurs, étiquettes de formulaire, points de repère, cibles tactiles
- Contenu (17 règles) : Nombre de mots, lisibilité, densité des mots-clés, détection de doublons, largeurs en pixels
- Social (9 règles) : Balises Open Graph, cartes Twitter, boutons de partage, liens de profil
- E-E-A-T (14 règles) : Signatures d'auteur, citations, signaux de confiance, pages à propos/contact, détection YMYL
- Structure d'URL (14 règles) : Slugs de mots-clés, mots vides, majuscules, underscores, identifiants de session, paramètres de suivi
- Redirections (8 règles) : Boucles de redirection, types (301/302), meta refresh, redirections JavaScript, redirections brisées
- Mobile (5 règles) : Tailles de police, défilement horizontal, interstitiels intrusifs, problèmes de viewport
- Internationalisation (10 règles) : Attribut lang, validation hreflang (liens retour, conflits, incohérences)
- Validation HTML (9 règles) : Doctype, jeu de caractères, structure head, lorem ipsum, titres/descriptions multiples
- Préparation IA/GEO (5 règles) : HTML sémantique, accès des bots IA, llms.txt, dérive de schéma
- Conformité juridique (1 règle) : Consentement aux cookies
L'audit explore le site web, analyse chaque page selon les règles d'audit et renvoie un rapport complet avec :
- Score de santé global (0-100) avec note alphabétique (A-F)
- Répartition par catégorie avec comptes de réussite/avertissement/échec
- Problèmes spécifiques avec URL concernées regroupées par règle
- Recommandations de correctifs exploitables
Quand L'Utiliser
Utilisez cette compétence lorsque vous avez besoin de :
- Analyser la santé SEO d'un site web
- Déboguer des problèmes de SEO technique
- Vérifier les liens brisés et les chaînes de redirection
- Valider les balises méta, les URL canoniques et les données structurées
- Auditer les en-têtes de sécurité, SSL et HTTPS
- Vérifier la conformité en accessibilité
- Analyser le rendu JavaScript et la compatibilité SSR
- Évaluer la préparation IA/GEO (HTML sémantique, llms.txt, accès des bots)
- Détecter le contenu en double entre les pages
- Valider la configuration hreflang et d'internationalisation
- Vérifier la structure et la validation du document HTML
- Générer des rapports d'audit de site dans plusieurs formats
- Comparer la santé du site avant/après modifications
Prérequis
Cette compétence nécessite l'installation de l'outil en ligne de commande SEOmator.
Installation
npm install -g @seomator/seo-audit
Vérification de l'Installation
Vérifiez que seomator est installé et que le système est prêt :
seomator self doctor
Ceci vérifie :
- Version de Node.js (18+ recommandée)
- Disponibilité de npm
- Chrome/Chromium pour les Core Web Vitals et le rendu JS
- Permissions d'écriture pour ~/.seomator
- Présence d'un fichier de configuration local
Configuration
L'exécution de seomator init crée un fichier de configuration seomator.toml dans le répertoire courant.
seomator init # Configuration interactive
seomator init -y # Utiliser les valeurs par défaut
seomator init --preset blog # Configuration optimisée pour blog
seomator init --preset ecommerce # Configuration pour e-commerce
seomator init --preset ci # Configuration minimale pour CI
S'il n'y a pas de fichier seomator.toml dans le répertoire, CRÉEZ-EN UN avec seomator init avant d'exécuter des audits.
Utilisation
Bonnes Pratiques pour les Agents IA
VOUS DEVEZ toujours préférer --format llm – cela fournit une sortie XML optimisée en tokens, spécialement conçue pour les agents IA (50 à 70 % plus petite que le JSON).
Lors de l'audit :
- Privilégiez les sites web en direct plutôt que les serveurs de développement locaux pour des données précises de performance et de rendu
- Utilisez
--no-cwvpour des audits plus rapides lorsque les Core Web Vitals et les vérifications de rendu JS ne sont pas nécessaires - Planifiez les correctifs comme des tâches concurrentes lorsque vous implémentez plusieurs correctifs
- Exécutez la vérification de type/formatage après avoir implémenté les correctifs (tsc, eslint, prettier, etc.)
Découverte du Site Web
Si l'utilisateur ne fournit pas de site web à auditer :
- Vérifiez les configurations de serveur de développement local (scripts package.json, fichiers .env)
- Recherchez les liens de projets Vercel/Netlify
- Vérifiez les variables d'environnement pour les URL de déploiement
- Demandez à l'utilisateur quelle URL auditer
Si vous avez à la fois des sites locaux et en direct disponibles, suggérez d'auditer le site en direct pour des résultats précis.
Flux de Travail de Base
# Audit rapide d'une seule page avec sortie LLM
seomator audit https://example.com --format llm --no-cwv
# Exploration multi-pages (jusqu'à 50 pages)
seomator audit https://example.com --crawl -m 50 --format llm --no-cwv
# Audit complet avec Core Web Vitals + analyse du rendu JS
seomator audit https://example.com --crawl -m 20 --format llm
Options Avancées
Forcer une nouvelle exploration (ignorer le cache) :
seomator audit https://example.com --refresh --format llm
Reprendre une exploration interrompue :
seomator audit https://example.com --resume --format llm
Auditer uniquement des catégories spécifiques :
seomator audit https://example.com -c core,security,js --format llm --no-cwv
Enregistrer un rapport HTML pour le partager :
seomator audit https://example.com --format html -o report.html
Sortie détaillée pour déboguer :
seomator audit https://example.com --format llm -v
Référence des Commandes
Options de la Commande d'Audit
| Option | Alias | Description | Défaut |
|---|---|---|---|
--format <fmt> | -f | Format de sortie : console, json, html, markdown, llm | console |
--max-pages <n> | -m | Nombre maximum de pages à explorer | 10 |
--crawl | Activer l'exploration multi-pages | false | |
--categories <liste> | -c | Catégories à auditer séparées par des virgules | Toutes |
--refresh | -r | Ignorer le cache, récupérer à nouveau | false |
--resume | Reprendre une exploration interrompue | false | |
--no-cwv | Ignorer les Core Web Vitals + rendu JS | false | |
--verbose | -v | Afficher la progression | false |
--output <chemin> | -o | Chemin du fichier de sortie | |
--config <chemin> | Chemin du fichier de configuration | ||
--save | Enregistrer dans ~/.seomator | false |
Autres Commandes
seomator init # Créer un fichier de configuration
seomator self doctor # Vérifier la configuration système
seomator config --list # Afficher toutes les valeurs de configuration
seomator report --list # Lister les rapports passés
seomator db stats # Afficher les statistiques de la base de données
Formats de Sortie
| Format | Drapeau | Idéal pour |
|---|---|---|
| console | --format console | Sortie terminal humaine (défaut) |
| json | --format json | CI/CD, traitement programmatique |
| html | --format html | Rapports autonomes, partage |
| markdown | --format markdown | Documentation, GitHub |
| llm | --format llm | Agents IA (recommandé) |
La sortie --format llm est un format XML compact optimisé pour l'efficacité des tokens :
- 50 à 70 % plus petite que la sortie JSON
- Problèmes triés par sévérité (critiques en premier)
- Suggestions de correctifs incluses pour chaque problème
- Sortie standard propre pour le piping vers des outils IA
Exemples
Exemple 1 : Audit Rapide avec Sortie LLM
# L'utilisateur demande : "Vérifie les problèmes SEO de example.com"
seomator audit https://example.com --format llm --no-cwv
Exemple 2 : Exploration Approfondie pour un Grand Site
# L'utilisateur demande : "Fais un audit approfondi avec jusqu'à 100 pages"
seomator audit https://example.com --crawl -m 100 --format llm --no-cwv
Exemple 3 : Nouvel Audit Après Modifications
# L'utilisateur demande : "Ré-audite le site, ignore les résultats en cache"
seomator audit https://example.com --refresh --format llm --no-cwv
Exemple 4 : Générer un Rapport Partageable
# L'utilisateur demande : "Crée un rapport HTML que je puisse partager"
seomator audit https://example.com --crawl -m 20 --format html -o seo-report.html
Exemple 5 : Se Concentrer sur des Domaines Spécifiques
# L'utilisateur demande : "Vérifie juste mon rendu JavaScript et mes redirections"
seomator audit https://example.com -c js,redirect --format llm
Évaluation des Résultats
Tranches de Score
| Score | Note | Signification |
|---|---|---|
| 90-100 | A | Excellent – Uniquement des optimisations mineures |
| 80-89 | B | Bon – Traiter les avertissements |
| 70-79 | C | Nécessite du travail – Correctifs prioritaires requis |
| 50-69 | D | Médiocre – Plusieurs problèmes critiques |
| 0-49 | F | Critique – Problèmes majeurs à résoudre |
Ordre de Priorité (par poids de catégorie)
Corrigez les problèmes dans cet ordre pour un impact maximal :
- Core (12 %) – Balises méta, canonical, H1, indexation
- Performances (12 %) – Core Web Vitals + optimisation
- Liens (8 %) – Structure de liens internes
- Images (8 %) – Performance + accessibilité
- Sécurité (8 %) – Signaux de confiance, SSL
- SEO technique (7 %) – Base de crawl
- Crawlability (5 %) – Indexabilité, pagination
- Données structurées (5 %) – Extraits enrichis
- Rendu JavaScript (5 %) – DOM rendu, SSR
- Contenu (5 %) – Qualité du texte + doublons
- Accessibilité (4 %) – Conformité WCAG
- Social (3 %) – Partage social
- E-E-A-T (3 %) – Confiance, expertise
- Structure d'URL (3 %) – Hygiène des URL
- Redirections (3 %) – Chaînes de redirection
- Mobile (2 %) – Viewport, polices
- Internationalisation (2 %) – Hreflang
- Validation HTML (2 %) – Structure du document
- Préparation IA/GEO (2 %) – HTML sémantique, bots IA
- Conformité juridique (1 %) – Consentement aux cookies
Correction par Sévérité
- Échecs (statut : "fail") – Doivent être corrigés immédiatement
- Avertissements (statut : "warn") – Devraient être corrigés bientôt
- Réussites (statut : "pass") – Aucune action nécessaire
Résumé de Sortie
Après avoir implémenté les correctifs, donnez à l'utilisateur un résumé de toutes les modifications effectuées.
Lors de la planification des tâches, organisez-les pour qu'elles puissent s'exécuter en parallèle en tant que sous-agents afin d'accélérer la mise en œuvre.
Dépannage
Commande seomator introuvable
Si vous voyez cette erreur, seomator n'est pas installé ou n'est pas dans votre PATH.
Solution :
npm install -g @seomator/seo-audit
Core Web Vitals non mesurés
Si les métriques CWV sont manquantes, Chrome/Chromium peut ne pas être disponible.
Solution :
- Installez Chrome, Chromium ou Edge
- Exécutez
seomator self doctorpour vérifier la détection du navigateur - Utilisez
--no-cwvpour ignorer les CWV si non nécessaires
Délai d'exploration ou performances lentes
Pour les grands sites, les audits peuvent prendre plusieurs minutes.
Solution :
- Utilisez
--verbosepour voir la progression - Limitez les pages avec
-m 20pour des résultats plus rapides - Utilisez
--no-cwvpour ignorer les mesures basées sur le navigateur
URL Invalide
Assurez-vous que l'URL inclut le protocole :
# Erroné
seomator audit example.com
# Correct
seomator audit https://example.com
Comment Cela Fonctionne
- Récupération : Télécharge le HTML de la page et mesure le temps de réponse
- Analyse : Extrait le DOM, les balises méta, les liens, les images, les données structurées
- Enrichissement : Récupère robots.txt et la sitemap une fois par audit
- Rendu (si CWV activé) : Capture le DOM rendu via Playwright pour l'analyse du rendu JS
- Exploration (si activée) : Découvre et récupère les pages liées
- Analyse : Exécute 251 règles d'audit sur chaque page
- Score : Calcule les scores pondérés par catégorie et globaux
- Rapport : Génère la sortie dans le format demandé
Les résultats sont stockés dans ~/.seomator/ pour une récupération ultérieure avec seomator report.
Ressources
- Référence complète des règles : Voir
docs/SEO-AUDIT-RULES.mdpour les 251 règles - Architecture de stockage : Voir
docs/STORAGE-ARCHITECTURE.mdpour les détails de la base de données - Aide CLI :
seomator --helpetseomator <commande> --help