Compétence d'Audit de Site Web
Auditez les sites web pour les problèmes de SEO, techniques, de contenu, de performance et de sécurité à l'aide de l'outil en ligne de commande squirrelscan.
squirrelscan fournit un outil CLI squirrel - disponible pour macOS, Windows et Linux. Il effectue des audits complets de sites web en émulant un navigateur, un robot de recherche et en analysant la structure et le contenu du site selon plus de 230 règles.
Il vous fournira une liste de problèmes ainsi que des suggestions pour les résoudre.
Liens
- Le site web de squirrelscan est à https://squirrelscan.com
- La documentation (incluant les références des règles) se trouve à docs.squirrelscan.com
Vous pouvez consulter la documentation d'une règle avec ce modèle :
https://docs.squirrelscan.com/rules/{catégorie_de_règle}/{id_de_règle}
exemple :
https://docs.squirrelscan.com/rules/links/external-links
Que Fait Cette Compétence
Cette compétence permet aux agents IA d'auditer des sites web selon plus de 230 règles dans 21 catégories, notamment :
- SEO : Balises meta, titres, descriptions, URL canoniques, balises Open Graph
- Problèmes techniques : Liens brisés, chaînes de redirection, vitesse de page, convivialité mobile
- Performance : Temps de chargement des pages, utilisation des ressources, mise en cache
- Qualité du contenu : Structure des titres, texte alternatif des images, analyse du contenu
- Sécurité : Secrets divulgués, utilisation de HTTPS, en-têtes de sécurité, contenu mixte
- Accessibilité : Texte alternatif, contraste des couleurs, navigation au clavier
- Utilisabilité : Validation de formulaires, gestion des erreurs, parcours utilisateur
- Liens : Vérification des liens internes et externes brisés
- E-E-A-T : Expertise, Expérience, Autorité, Fiabilité
- Expérience Utilisateur : Parcours utilisateur, gestion des erreurs, validation de formulaires
- Mobile : Vérification de la convivialité mobile, design responsive, éléments tactiles
- Crawlabilité : Vérification de la crawlabilité, robots.txt, sitemap.xml et plus
- Schéma : Balisage Schema.org, données structurées, rich snippets
- Juridique : Conformité aux exigences légales, politiques de confidentialité, conditions d'utilisation
- Social : Open Graph, Twitter Cards et validation des schémas, extraits, etc.
- Structure des URL : Longueur, tirets, mots-clés
- Mots-clés : Bourrage de mots-clés
- Contenu : Structure du contenu, titres
- Images : Texte alternatif, contraste des couleurs, taille d'image, format d'image
- SEO Local : Cohérence NAP, métadonnées géographiques
- Vidéo : Schéma VideoObject, accessibilité
et plus
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)
- Répartition par catégorie (SEO de base, SEO technique, contenu, sécurité)
- Problèmes spécifiques avec les URL concernées
- Détection des liens brisés
- Recommandations exploitables
- Les règles ont des niveaux d'erreur, d'avertissement et d'avis et également un rang entre 1 et 10
Quand Utiliser
Utilisez cette compétence lorsque vous devez :
- Analyser la santé d'un site web
- Déboguer des problèmes de SEO technique
- Corriger tous les problèmes mentionnés ci-dessus
- Vérifier les liens brisés
- Valider les balises meta et les données structurées
- Générer des rapports d'audit de site
- Comparer la santé du site avant/après des modifications
- Améliorer la performance, l'accessibilité, le SEO, la sécurité et plus.
Vous devriez ré-auditer aussi souvent que possible pour garantir que votre site web reste sain et performant.
Prérequis
Cette compétence nécessite l'outil CLI squirrel installé et accessible dans le PATH.
Installation : squirrelscan.com/download
Vérification :
squirrel --version
Configuration
Exécutez squirrel init pour créer un fichier de configuration squirrel.toml dans le répertoire courant. S'il n'en existe pas, créez-en un et spécifiez un nom de projet :
squirrel init -n mon-projet
# écraser la configuration existante
squirrel init -n mon-projet --force
Utilisation
Introduction
Trois processus peuvent être exécutés et sont tous mis en cache dans la base de données locale du projet :
crawl- sous-commande pour lancer ou actualiser un crawl, ou reprendre un crawl interrompuanalyze- sous-commande pour analyser les résultats du crawlreport- sous-commande pour générer un rapport dans le format souhaité (llm, text, console, html, etc.)
La commande audit est un encapsuleur qui exécute ces trois processus séquentiellement :
squirrel audit https://example.com --format llm
VOUS DEVRIEZ toujours préférer le format llm - il a été conçu pour vous et fournit un format de sortie exhaustif et compact.
LE PREMIER SCAN devrait être un scan de surface, c'est-à-dire un scan rapide et peu profond du site web pour recueillir des informations de base sur le site, telles que sa structure, son contenu et sa pile technologique. Ce scan peut être effectué rapidement sans impacter les performances du site.
LE SECOND SCAN devrait être un scan profond, c'est-à-dire un scan approfondi et détaillé du site web pour recueillir davantage d'informations sur le site, telles que sa sécurité, ses performances et son accessibilité. Ce scan peut prendre plus de temps et peut impacter les performances du site.
Si l'utilisateur ne fournit pas de site web à auditer, demandez quelle URL il souhaite auditer.
Vous devriez PRÉFÉRER auditer des sites web en ligne - seulement là nous obtenons une VRAIE représentation du site et de ses problèmes de performance ou de rendu.
Si vous avez à la fois des sites locaux et en ligne à auditer, demandez à l'utilisateur de choisir celui à auditer et SUGGÉREZ de choisir le site en ligne.
Vous pouvez appliquer les corrections d'un audit sur le site en ligne au code local.
Lors de la planification des tâches de périmètre, exécutez-les en tant que sous-agents concurrents pour accélérer les corrections.
Lors de l'implémentation des corrections, tirez parti des sous-agents pour accélérer l'implémentation.
Après avoir appliqué les corrections, vérifiez que le code se compile toujours et passe les vérifications existantes du projet.
Flux de Travail de Base
Le processus d'audit comporte deux étapes :
- Exécuter l'audit (sauvegarde dans la base de données, affiche la sortie console)
- Exporter le rapport dans le format souhaité
# Étape 1 : Exécuter l'audit (par défaut : sortie console)
squirrel audit https://example.com
# Étape 2 : Exporter au format LLM
squirrel report <id-audit> --format llm
Diffs de Régression
Lorsque vous devez détecter des régressions entre audits, utilisez le mode diff :
# Comparer le rapport actuel par rapport à un ID d'audit de référence
squirrel report --diff <id-audit> --format llm
# Comparer le dernier rapport de domaine par rapport à un domaine de référence
squirrel report --regression-since example.com --format llm
Le mode diff supporte les formats console, text, json, llm et markdown. Les formats html et xml ne sont pas supportés.
Exécution des Audits
Lors de l'exécution d'un audit :
- Présenter le rapport - montrer à l'utilisateur les résultats de l'audit et le score
- Proposer des corrections - lister les problèmes pouvant être corrigés et demander la confirmation de l'utilisateur avant d'apporter des modifications
- Paralléliser les corrections approuvées - utiliser des sous-agents pour les modifications en masse du contenu (texte alternatif, titres, descriptions)
- Itérer - corriger un lot → ré-auditer → présenter les résultats → proposer le lot suivant
- Marquer une pause pour jugement - les liens brisés, les changements structurels et tout ce qui est ambigu doivent être signalés pour examen par l'utilisateur
- Montrer avant/après - présenter la comparaison des scores après chaque lot de corrections
-
Boucle d'Itération : Après avoir corrigé un lot de problèmes, ré-auditer et continuer à corriger jusqu'à ce que :
- Le score atteigne l'objectif (généralement 85+), OU
- Seuls les problèmes nécessitant un jugement humain subsistent (par exemple, "ce lien doit-il être supprimé ?")
-
Traiter toutes les corrections de manière égale : Les modifications de code et les modifications de contenu sont tout aussi importantes.
-
Paralléliser les corrections de contenu : Pour les problèmes affectant plusieurs fichiers :
- Créer des sous-agents pour corriger en parallèle
- Exemple : 7 fichiers nécessitent du texte alternatif → créer 1-2 agents pour tout corriger
- Exemple : 30 fichiers ont des problèmes de titres → créer des agents pour modifier par lots
-
Critères d'achèvement :
- ✅ Toutes les erreurs corrigées
- ✅ Tous les avertissements corrigés (ou documentés comme nécessitant un examen humain)
- ✅ Un ré-audit confirme les améliorations
- ✅ Comparaison avant/après montrée à l'utilisateur
Après que les corrections sont appliquées, demandez à l'utilisateur s'il souhaite examiner les modifications.
Objectifs de Score
| Score de Départ | Score Cible | Travail Attendu |
|---|---|---|
| < 50 (Note F) | 75+ (Note C) | Corrections majeures |
| 50-70 (Note D) | 85+ (Note B) | Corrections modérées |
| 70-85 (Note C) | 90+ (Note A) | Polissage |
| > 85 (Note B+) | 95+ | Réglages fins |
Un site est considéré COMPLET et CORRIGÉ seulement lorsque les scores dépassent 95 (Note A) avec une couverture définie à FULL (--coverage full).
Catégories de Problèmes
| Catégorie | Approche de Correction | Parallélisable |
|---|---|---|
| Balises meta/titres | Modifier les composants de page ou les métadonnées | Non |
| Données structurées | Ajouter JSON-LD aux modèles de page | Non |
| H1/titres manquants | Modifier les composants de page + fichiers de contenu | Oui (contenu) |
| Texte alternatif d'image | Modifier les fichiers de contenu | Oui |
| Hiérarchie des titres | Modifier les fichiers de contenu | Oui |
| Descriptions courtes | Modifier le frontmatter du contenu | Oui |
| Liens HTTP→HTTPS | Rechercher et remplacer dans le contenu | Oui |
| Liens brisés | Examen manuel (signaler à l'utilisateur) | Non |
Pour les corrections parallélisables : Créer des sous-agents avec des affectations de fichiers spécifiques.
Corrections de Fichiers de Contenu
De nombreux problèmes nécessitent la modification de fichiers de contenu. Ils sont tout aussi importants que les corrections de code :
- Texte alternatif d'image : Ajouter un texte alternatif descriptif aux images
- Hiérarchie des titres : Corriger les niveaux de titres sautés
- Méta-descriptions : Étendre les descriptions courtes dans le frontmatter
- Liens HTTP : Mettre à jour les liens non sécurisés vers HTTPS
Parallélisation des Corrections avec des Sous-agents
Lorsque l'utilisateur approuve un lot de corrections, vous pouvez utiliser des sous-agents pour les appliquer en parallèle :
- Demander d'abord à l'utilisateur — toujours confirmer les corrections à appliquer avant de créer des sous-agents
- Regrouper 3-5 fichiers par sous-agent pour le même type de correction
- Paralléliser uniquement les fichiers indépendants (pas de composants ou de configuration partagés)
- Créer plusieurs sous-agents dans un seul message pour une exécution concurrente
Options Avancées
Auditer plus de pages :
squirrel audit https://example.com --max-pages 200
Forcer un nouveau crawl (ignorer le cache) :
squirrel audit https://example.com --refresh
Reprendre un crawl interrompu :
squirrel audit https://example.com --resume
Sortie verbeuse pour le débogage :
squirrel audit https://example.com --verbose
Options Courantes
Options de la Commande Audit
| Option | Alias | Description | Défaut |
|---|---|---|---|
--format <fmt> | -f <fmt> | Format de sortie : console, text, json, html, markdown, llm | console |
--coverage <mode> | -C <mode> | Mode de couverture : quick, surface, full | surface |
--max-pages <n> | -m <n> | Nombre maximum de pages à explorer (max 5000) | varie selon la couverture |
--output <path> | -o <path> | Chemin du fichier de sortie | - |
--refresh | -r | Ignorer le cache, récupérer toutes les pages à nouveau | false |
--resume | - | Reprendre un crawl interrompu | false |
--verbose | -v | Sortie verbeuse | false |
--debug | - | Journalisation de débogage | false |
--trace | - | Activer le traçage des performances | false |
--project-name <name> | -n <name> | Surcharger le nom du projet | depuis la config |
Modes de Couverture
Choisissez un mode de couverture en fonction de vos besoins d'audit :
| Mode | Pages par Défaut | Comportement | Cas d'Utilisation |
|---|---|---|---|
quick | 25 | Uniquement les graines + sitemaps, pas de découverte de liens | Vérifications CI, contrôle de santé rapide |
surface | 100 | Un échantillon par modèle d'URL | Audits généraux (défaut) |
full | 500 | Explorer tout jusqu'à la limite | Analyse approfondie |
Le mode surface est intelligent - il détecte les modèles d'URL comme /blog/{slug} ou /produits/{id} et ne visite qu'un seul échantillon par modèle. Ceci le rend efficace pour les sites avec de nombreuses pages similaires (blogs, e-commerce).
# Contrôle de santé rapide (25 pages, pas de découverte de liens)
squirrel audit https://example.com -C quick --format llm
# Audit de surface par défaut (100 pages, échantillonnage par modèle)
squirrel audit https://example.com --format llm
# Audit complet et approfondi (500 pages)
squirrel audit https://example.com -C full --format llm
# Surcharger la limite de pages pour tout mode
squirrel audit https://example.com -C surface -m 200 --format llm
Quand utiliser chaque mode :
quick: Pipelines CI, contrôles de santé quotidiens, surveillancesurface: La plupart des audits - couvre efficacement les modèles uniquesfull: Avant les lancements, analyse complète, études approfondies
Options de la Commande Report
| Option | Alias | Description |
|---|---|---|
--list | -l | Lister les audits récents |
--severity <niveau> | - | Filtrer par sévérité : error, warning, all |
--category <cats> | - | Filtrer par catégories (séparées par des virgules) |
--format <fmt> | -f <fmt> | Format de sortie : console, text, json, html, markdown, xml, llm |
--output <path> | -o <path> | Chemin du fichier de sortie |
--input <path> | -i <path> | Charger depuis un fichier JSON (mode de secours) |
Sous-commandes de Configuration
| Commande | Description |
|---|---|
config show | Afficher la configuration actuelle |
config set <clé> <valeur> | Définir une valeur de configuration |
config path | Afficher le chemin du fichier de configuration |
config validate | Valider le fichier de configuration |
Autres Commandes
| Commande | Description |
|---|---|
squirrel feedback | Envoyer un retour à l'équipe squirrelscan |
squirrel skills install | Installer la compétence Claude Code |
squirrel skills update | Mettre à jour la compétence Claude Code |
Commandes d'Auto-gestion
Commandes d'auto-gestion sous squirrel self :
| Commande | Description |
|---|---|
self install | Installer l'installation locale |
self update | Vérifier et appliquer les mises à jour |
self completion | Générer les complétions shell |
self doctor | Exécuter des vérifications de santé |
self version | Afficher les informations de version |
self settings | Gérer les paramètres CLI |
self uninstall | Supprimer squirrel du système |
Formats de Sortie
Sortie Console (par défaut)
La commande audit affiche une sortie console lisible par défaut avec une sortie colorée et des indicateurs de progression.
Format LLM
Pour obtenir une sortie optimisée pour LLM, utilisez la commande report avec --format llm :
squirrel report <id-audit> --format llm
Le format LLM est un hybride XML/texte compact optimisé pour l'efficacité des tokens (40% plus petit que le XML verbeux) :
- Résumé : Score de santé global et métriques clés
- Problèmes par Catégorie : Groupés par catégorie de règle d'audit (SEO de base, technique, contenu, sécurité)
- Liens Brisés : Liste des liens brisés
- Recommandations : Suggestions exploitables
Sortie Markdown
Utilisez --format markdown pour des rapports au format Markdown lisibles.
Export Texte
Pour une exportation en texte brut :
squirrel report <id-audit> --format text
Export JSON
Pour un traitement automatisé :
squirrel report <id-audit> --format json
Export CSV
Pour une analyse dans un tableur :
squirrel report <id-audit> --format csv
Export PDF
Pour générer un rapport PDF :
squirrel report <id-audit> --format pdf
Sortie Markdown
Pour générer un rapport Markdown :
squirrel report <id-audit> --format markdown
Exemples
# Audit de surface par défaut (100 pages)
squirrel audit https://example.com --format llm
# Audit complet avec 500 pages
audite https://example.com -C full --format llm
# Vérification rapide pour CI
audite https://example.com -C quick --format llm
# Audit avec limite de pages personnalisée
audite https://example.com -m 200 --format llm
# Afficher le dernier rapport
afficher le rapport --latest