Communitygithub.com

AndresOrozcoDev/website

Auditez des sites web pour le SEO, la technique, le contenu, la sécurité, le rendu JavaScript et la préparation à l'IA avec l'outil en ligne de commande SEOmator. Retourne des rapports optimisés pour les LLM avec des scores de santé sur 251 règles et 20 catégories.

Qu'est-ce que website ?

Cette compétence permet aux agents d'IA d'effectuer des audits complets de sites web en utilisant SEOmator CLI, couvrant 251 règles de vérification réparties dans 20 catégories, notamment le SEO de base, les performances, la sécurité, le rendu JavaScript, l'accessibilité et la préparation à l'IA. Elle produit des rapports détaillés avec un score de santé global (0-100, note de A à F), des décomptes par catégorie (réussite/ avertissement/ échec), et des recommandations correctives exploitables. La compétence prend en charge plusieurs formats de sortie (console, JSON, HTML, markdown, XML optimisé pour les LLM), l'exploration de sites multi-pages, et des audits ciblés par catégorie. Elle est particulièrement utile pour les développeurs, les spécialistes SEO et les agents d'IA qui doivent diagnostiquer des problèmes de référencement, valider la structure technique d'un site, ou préparer une migration ou une refonte. L'installation se fait via npm, et l'outil nécessite Node.js 18+ pour fonctionner correctement.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AndresOrozcoDev/website/tree/HEAD/.agents/skills/seo-audit

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

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 :

  1. 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
  2. Utilisez --no-cwv pour des audits plus rapides lorsque les Core Web Vitals et les vérifications de rendu JS ne sont pas nécessaires
  3. Planifiez les correctifs comme des tâches concurrentes lorsque vous implémentez plusieurs correctifs
  4. 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 :

  1. Vérifiez les configurations de serveur de développement local (scripts package.json, fichiers .env)
  2. Recherchez les liens de projets Vercel/Netlify
  3. Vérifiez les variables d'environnement pour les URL de déploiement
  4. 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

OptionAliasDescriptionDéfaut
--format <fmt>-fFormat de sortie : console, json, html, markdown, llmconsole
--max-pages <n>-mNombre maximum de pages à explorer10
--crawlActiver l'exploration multi-pagesfalse
--categories <liste>-cCatégories à auditer séparées par des virgulesToutes
--refresh-rIgnorer le cache, récupérer à nouveaufalse
--resumeReprendre une exploration interrompuefalse
--no-cwvIgnorer les Core Web Vitals + rendu JSfalse
--verbose-vAfficher la progressionfalse
--output <chemin>-oChemin du fichier de sortie
--config <chemin>Chemin du fichier de configuration
--saveEnregistrer dans ~/.seomatorfalse

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

FormatDrapeauIdéal pour
console--format consoleSortie terminal humaine (défaut)
json--format jsonCI/CD, traitement programmatique
html--format htmlRapports autonomes, partage
markdown--format markdownDocumentation, GitHub
llm--format llmAgents 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

ScoreNoteSignification
90-100AExcellent – Uniquement des optimisations mineures
80-89BBon – Traiter les avertissements
70-79CNécessite du travail – Correctifs prioritaires requis
50-69DMédiocre – Plusieurs problèmes critiques
0-49FCritique – Problèmes majeurs à résoudre

Ordre de Priorité (par poids de catégorie)

Corrigez les problèmes dans cet ordre pour un impact maximal :

  1. Core (12 %) – Balises méta, canonical, H1, indexation
  2. Performances (12 %) – Core Web Vitals + optimisation
  3. Liens (8 %) – Structure de liens internes
  4. Images (8 %) – Performance + accessibilité
  5. Sécurité (8 %) – Signaux de confiance, SSL
  6. SEO technique (7 %) – Base de crawl
  7. Crawlability (5 %) – Indexabilité, pagination
  8. Données structurées (5 %) – Extraits enrichis
  9. Rendu JavaScript (5 %) – DOM rendu, SSR
  10. Contenu (5 %) – Qualité du texte + doublons
  11. Accessibilité (4 %) – Conformité WCAG
  12. Social (3 %) – Partage social
  13. E-E-A-T (3 %) – Confiance, expertise
  14. Structure d'URL (3 %) – Hygiène des URL
  15. Redirections (3 %) – Chaînes de redirection
  16. Mobile (2 %) – Viewport, polices
  17. Internationalisation (2 %) – Hreflang
  18. Validation HTML (2 %) – Structure du document
  19. Préparation IA/GEO (2 %) – HTML sémantique, bots IA
  20. Conformité juridique (1 %) – Consentement aux cookies

Correction par Sévérité

  1. Échecs (statut : "fail") – Doivent être corrigés immédiatement
  2. Avertissements (statut : "warn") – Devraient être corrigés bientôt
  3. 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 :

  1. Installez Chrome, Chromium ou Edge
  2. Exécutez seomator self doctor pour vérifier la détection du navigateur
  3. Utilisez --no-cwv pour 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 --verbose pour voir la progression
  • Limitez les pages avec -m 20 pour des résultats plus rapides
  • Utilisez --no-cwv pour 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

  1. Récupération : Télécharge le HTML de la page et mesure le temps de réponse
  2. Analyse : Extrait le DOM, les balises méta, les liens, les images, les données structurées
  3. Enrichissement : Récupère robots.txt et la sitemap une fois par audit
  4. Rendu (si CWV activé) : Capture le DOM rendu via Playwright pour l'analyse du rendu JS
  5. Exploration (si activée) : Découvre et récupère les pages liées
  6. Analyse : Exécute 251 règles d'audit sur chaque page
  7. Score : Calcule les scores pondérés par catégorie et globaux
  8. 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.md pour les 251 règles
  • Architecture de stockage : Voir docs/STORAGE-ARCHITECTURE.md pour les détails de la base de données
  • Aide CLI : seomator --help et seomator <commande> --help

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

AndresOrozcoDev/website

Frontend design skill that generates, restyles, and guides UI development in mager's signature aesthetic — hot, sleek, sexy, usable, fun, and addictive interfaces with dark-first themes, terminal-inspired typography, neon accents, and visual discovery patterns. Use this skill when building or reviewing any frontend UI.

AndresOrozcoDev/website

Generate beautiful, production-ready, animated single-file HTML landing pages. Use this skill whenever the user asks to create a landing page, marketing page, product page, startup homepage, SaaS landing, app launch page, waitlist page, or any promotional single-page site. Also trigger when user says "make a landing for...", "generate landing page", "build me a homepage", "create a product page", "landing page for my startup", or asks to improve/redesign an existing landing page. Covers both "from scratch" generation and "improve/convert" workflows. Outputs one self-contained HTML file with Tailwind CSS, vanilla JS animations, responsive design, dark/light mode, and curated visual style presets. Always use this skill even for simple landing requests — it ensures premium, non-generic output.

AndresOrozcoDev/website

This skill should be used when the user asks to "write SEO content", "create a blog post", "write an article", "content writing for SEO", "draft optimized content", "write a how-to guide", "create a product description", "write a landing page", "SEO copywriting", "draft content targeting [keyword]", or "write 2000-word article about [topic]". Creates keyword-optimized content using a 12-step workflow: CORE-EEAT pre-write checklist, keyword integration, title optimization (5 formula options), meta description, H1/H2/H3 hierarchy, featured snippet targeting, internal/external linking, and readability enhancement. Produces full drafts with embedded SEO elements, title variants, meta description, FAQ section with schema, and a self-scored CORE-EEAT checklist. For AI-citation optimization, see geo-content-optimizer. For updating existing content, see content-refresher.

Skills associés