Skill für Website-Audit
Auditiere Websites auf SEO, technische, inhaltliche, Leistungs- und Sicherheitsprobleme mit dem squirrelscan CLI.
squirrelscan bietet das CLI-Tool squirrel – verfügbar für macOS, Windows und Linux. Es führt umfassende Website-Audits durch, indem es einen Browser, einen Such-Crawler emuliert und die Struktur sowie den Inhalt der Website anhand von über 230+ Regeln analysiert.
Es liefert eine Liste der Probleme sowie Vorschläge zu deren Behebung.
Links
- Die squirrelscan-Website ist unter https://squirrelscan.com erreichbar
- Die Dokumentation (einschließlich Regelreferenzen) befindet sich unter docs.squirrelscan.com
Du kannst die Dokumentation für jede Regel mit dieser Vorlage nachschlagen:
https://docs.squirrelscan.com/rules/{rule_category}/{rule_id}
Beispiel:
https://docs.squirrelscan.com/rules/links/external-links
Was dieses Skill tut
Dieses Skill ermöglicht es KI-Agenten, Websites anhand von über 230 Regeln in 21 Kategorien zu auditieren, darunter:
- SEO: Meta-Tags, Titel, Beschreibungen, kanonische URLs, Open Graph Tags
- Technische Probleme: Defekte Links, Weiterleitungsketten, Seitengeschwindigkeit, Mobilfreundlichkeit
- Leistung: Ladezeit der Seite, Ressourcennutzung, Caching
- Inhaltsqualität: Überschriftenstruktur, Bild-Alt-Texte, Inhaltsanalyse
- Sicherheit: Durchgesickerte Geheimnisse, HTTPS-Nutzung, Sicherheitsheader, Mixed Content
- Barrierefreiheit: Alt-Texte, Farbkontrast, Tastaturnavigation
- Benutzerfreundlichkeit: Formularvalidierung, Fehlerbehandlung, Benutzerfluss
- Links: Prüfung auf defekte interne und externe Links
- E-E-A-T: Expertise, Erfahrung, Autorität, Vertrauenswürdigkeit
- Benutzererfahrung: Benutzerfluss, Fehlerbehandlung, Formularvalidierung
- Mobil: Prüfung auf Mobilfreundlichkeit, responsives Design, touch-freundliche Elemente
- Crawlability: Prüfung auf Crawlbarkeit, robots.txt, sitemap.xml und mehr
- Schema: Schema.org-Markup, strukturierte Daten, Rich Snippets
- Rechtliches: Einhaltung rechtlicher Anforderungen, Datenschutzrichtlinien, AGB
- Sozial: Open Graph, Twitter Cards und Validierung von Schemata, Snippets usw.
- URL-Struktur: Länge, Bindestriche, Schlüsselwörter
- Schlüsselwörter: Keyword Stuffing
- Inhalt: Inhaltsstruktur, Überschriften
- Bilder: Alt-Texte, Farbkontrast, Bildgröße, Bildformat
- Lokales SEO: NAP-Konsistenz, Geo-Metadaten
- Video: VideoObject-Schema, Barrierefreiheit
und mehr
Der Audit durchläuft die Website, analysiert jede Seite anhand der Audit-Regeln und liefert einen umfassenden Bericht mit:
- Gesamtbewertung (0-100)
- Kategorieaufschlüsselung (Kern-SEO, technisches SEO, Inhalt, Sicherheit)
- Spezifische Probleme mit betroffenen URLs
- Erkennung defekter Links
- Umsetzbare Empfehlungen
- Regeln haben die Stufen Fehler, Warnung und Hinweis sowie einen Rang zwischen 1 und 10
Wann zu verwenden
Verwende dieses Skill, wenn du Folgendes benötigst:
- Analyse des Website-Zustands
- Debuggen technischer SEO-Probleme
- Behebung aller oben genannten Probleme
- Überprüfung auf defekte Links
- Validierung von Meta-Tags und strukturierten Daten
- Erstellung von Website-Audit-Berichten
- Vergleich des Website-Zustands vor/nach Änderungen
- Verbesserung der Website-Leistung, Barrierefreiheit, SEO, Sicherheit und mehr
Du solltest so oft wie möglich erneut auditieren, um sicherzustellen, dass deine Website gesund bleibt und gut funktioniert.
Voraussetzungen
Dieses Skill erfordert die squirrel CLI, die installiert und im PATH sein muss.
Installation: squirrelscan.com/download
Überprüfung:
squirrel --version
Einrichtung
Führe squirrel init aus, um eine squirrel.toml-Konfiguration im aktuellen Verzeichnis zu erstellen. Falls keine vorhanden ist, erstelle eine und gib einen Projektnamen an:
squirrel init -n mein-projekt
# Vorhandene Konfiguration überschreiben
squirrel init -n mein-projekt --force
Verwendung
Einführung
Es gibt drei Prozesse, die ausgeführt werden können und alle in der lokalen Projektdatenbank zwischengespeichert werden:
- crawl – Unterbefehl zum Ausführen eines Crawls oder zum Aktualisieren/Fortsetzen eines Crawls
- analyze – Unterbefehl zum Analysieren der Crawl-Ergebnisse
- report – Unterbefehl zum Erstellen eines Berichts im gewünschten Format (llm, text, console, html usw.)
Der Befehl audit ist ein Wrapper um diese drei Prozesse und führt sie nacheinander aus:
squirrel audit https://example.com --format llm
DU SOLLTEST immer das Format llm bevorzugen – es wurde für dich entwickelt und bietet ein erschöpfendes und kompaktes Ausgabeformat.
DER ERSTE SCAN sollte ein Oberflächenscan sein, ein schneller und oberflächlicher Scan der Website, um grundlegende Informationen über die Website zu sammeln, wie z. B. Struktur, Inhalt und Technologie-Stack. Dieser Scan kann schnell und ohne Beeinträchtigung der Website-Leistung durchgeführt werden.
DER ZWEITE SCAN sollte ein Tiefenscan sein, ein gründlicher und detaillierter Scan der Website, um weitere Informationen über die Website zu sammeln, wie z. B. Sicherheit, Leistung und Barrierefreiheit. Dieser Scan kann länger dauern und die Website-Leistung beeinträchtigen.
Wenn der Benutzer keine zu auditierende Website angibt, frage, welche URL auditiert werden soll.
Du SOLLTEST Live-Websites bevorzugen – nur dort erhalten wir eine WAHRE Darstellung der Website und Leistungs- oder Rendering-Probleme.
Wenn du sowohl lokale als auch Live-Websites zu auditieren hast, fordere den Benutzer auf, auszuwählen, welche auditiert werden soll, und SCHLAGE vor, dass er die Live-Website wählt.
Du kannst Korrekturen aus einem Audit auf der Live-Site auf den lokalen Code anwenden.
Plane Aufgaben so, dass sie gleichzeitig als Unteragenten ausgeführt werden können, um Korrekturen zu beschleunigen.
Nutze bei der Implementierung von Korrekturen Unteragenten, um die Implementierung von Korrekturen zu beschleunigen.
Nachdem Korrekturen angewendet wurden, überprüfe, ob der Code noch Builds und alle vorhandenen Prüfungen im Projekt besteht.
Grundlegender Workflow
Der Audit-Prozess besteht aus zwei Schritten:
- Audit ausführen (in Datenbank speichern, Konsolenausgabe anzeigen)
- Bericht exportieren im gewünschten Format
# Schritt 1: Audit ausführen (Standard: Konsolenausgabe)
squirrel audit https://example.com
# Schritt 2: Als LLM-Format exportieren
squirrel report <audit-id> --format llm
Regressions-Diffs
Wenn du Regressionen zwischen Audits erkennen musst, verwende den Diff-Modus:
# Aktuellen Bericht mit einem Basis-Audit vergleichen
squirrel report --diff <audit-id> --format llm
# Neuesten Domain-Bericht mit einer Basis-Domain vergleichen
squirrel report --regression-since example.com --format llm
Der Diff-Modus unterstützt console, text, json, llm und markdown. html und xml werden nicht unterstützt.
Audits ausführen
Beim Ausführen eines Audits:
- Bericht präsentieren – dem Benutzer die Audit-Ergebnisse und Bewertung anzeigen
- Korrekturen vorschlagen – die behebbaren Probleme auflisten und den Benutzer um Bestätigung bitten
- Genehmigte Korrekturen parallelisieren – Unteragenten für Bulk-Content-Änderungen verwenden (Alt-Texte, Überschriften, Beschreibungen)
- Iterieren – Batch korrigieren → erneut auditieren → Ergebnisse präsentieren → nächsten Batch vorschlagen
- Pause für Beurteilung – defekte Links, strukturelle Änderungen und alles Unklare zur Überprüfung durch den Benutzer markieren
- Vorher/Nachher anzeigen – nach jedem Korrekturbatch die Bewertung vergleichen
-
Iterationsschleife: Nachdem ein Batch von Problemen behoben wurde, erneut auditieren und weiter korrigieren, bis:
- Die Bewertung das Ziel erreicht (in der Regel 85+), ODER
- Nur noch Probleme übrig sind, die menschliches Urteilsvermögen erfordern (z. B. „Soll dieser Link entfernt werden?“)
-
Alle Korrekturen gleich behandeln: Code-Änderungen und Inhaltsänderungen sind gleich wichtig.
-
Inhaltskorrekturen parallelisieren: Für Probleme, die mehrere Dateien betreffen:
- Unteragenten starten, um parallel zu korrigieren
- Beispiel: 7 Dateien benötigen Alt-Text → 1-2 Agenten starten, um alle zu korrigieren
- Beispiel: 30 Dateien haben Überschriften-Probleme → Agenten starten, um Batch-Änderungen durchzuführen
-
Abschlusskriterien:
- ✅ Alle Fehler behoben
- ✅ Alle Warnungen behoben (oder als überprüfungsbedürftig dokumentiert)
- ✅ Erneute Audit bestätigt Verbesserungen
- ✅ Vorher/Nachher-Vergleich dem Benutzer angezeigt
Nachdem Korrekturen angewendet wurden, frage den Benutzer, ob er die Änderungen überprüfen möchte.
Bewertungsziele
| Startbewertung | Zielbewertung | Erwartete Arbeit |
|---|---|---|
| < 50 (Note F) | 75+ (Note C) | Größere Korrekturen |
| 50-70 (Note D) | 85+ (Note B) | Moderate Korrekturen |
| 70-85 (Note C) | 90+ (Note A) | Feinschliff |
| > 85 (Note B+) | 95+ | Feinabstimmung |
Eine Website gilt nur dann als VOLLSTÄNDIG und BEHOBEN, wenn die Bewertungen über 95 (Note A) liegen und die Abdeckung auf FULL gesetzt ist (--coverage full).
Problemkategorien
| Kategorie | Korrekturansatz | Parallelisierbar |
|---|---|---|
| Meta-Tags/Titel | Seitenkomponenten oder Metadaten bearbeiten | Nein |
| Strukturierte Daten | JSON-LD zu Seitenvorlagen hinzufügen | Nein |
| Fehlende H1/Überschriften | Seitenkomponenten + Inhaltsdateien bearbeiten | Ja (Inhalt) |
| Bild-Alt-Texte | Inhaltsdateien bearbeiten | Ja |
| Überschriftenhierarchie | Inhaltsdateien bearbeiten | Ja |
| Kurze Beschreibungen | Frontmatter von Inhalten bearbeiten | Ja |
| HTTP→HTTPS-Links | Im Inhalt suchen und ersetzen | Ja |
| Defekte Links | Manuelle Überprüfung (für Benutzer markieren) | Nein |
Für parallelisierbare Korrekturen: Unteragenten mit spezifischen Dateizuordnungen starten.
Korrekturen an Inhaltsdateien
Viele Probleme erfordern die Bearbeitung von Inhaltsdateien. Diese sind genauso wichtig wie Code-Korrekturen:
- Bild-Alt-Texte: Beschreibende Alt-Texte zu Bildern hinzufügen
- Überschriftenhierarchie: Übersprungene Überschriftenebenen korrigieren
- Meta-Beschreibungen: Kurze Beschreibungen im Frontmatter erweitern
- HTTP-Links: Unsichere Links auf HTTPS aktualisieren
Korrekturen mit Unteragenten parallelisieren
Wenn der Benutzer einen Batch von Korrekturen genehmigt, kannst du Unteragenten verwenden, um sie parallel anzuwenden:
- Zuerst den Benutzer fragen – immer bestätigen, welche Korrekturen angewendet werden sollen, bevor Unteragenten gestartet werden
- 3-5 Dateien pro Unteragent für denselben Korrekturtyp gruppieren
- Nur unabhängige Dateien parallelisieren (keine gemeinsamen Komponenten oder Konfigurationen)
- Mehrere Unteragenten in einer einzigen Nachricht für die gleichzeitige Ausführung starten
Erweiterte Optionen
Mehr Seiten auditieren:
squirrel audit https://example.com --max-pages 200
Frischen Crawl erzwingen (Cache ignorieren):
squirrel audit https://example.com --refresh
Unterbrochenen Crawl fortsetzen:
squirrel audit https://example.com --resume
Ausführliche Ausgabe zum Debuggen:
squirrel audit https://example.com --verbose
Allgemeine Optionen
Optionen des Audit-Befehls
| Option | Alias | Beschreibung | Standard |
|---|---|---|---|
--format <fmt> | -f <fmt> | Ausgabeformat: console, text, json, html, markdown, llm | console |
--coverage <mode> | -C <mode> | Abdeckungsmodus: quick, surface, full | surface |
--max-pages <n> | -m <n> | Maximale Anzahl zu crawlender Seiten (max. 5000) | variiert je nach Abdeckung |
--output <path> | -o <path> | Ausgabedateipfad | – |
--refresh | -r | Cache ignorieren, alle Seiten frisch abrufen | false |
--resume | – | Unterbrochenen Crawl fortsetzen | false |
--verbose | -v | Ausführliche Ausgabe | false |
--debug | – | Debug-Logging | false |
--trace | – | Performance-Tracing aktivieren | false |
--project-name <name> | -n <name> | Projektnamen überschreiben | aus Konfiguration |
Abdeckungsmodi
Wähle einen Abdeckungsmodus basierend auf deinen Audit-Anforderungen:
| Modus | Standardseiten | Verhalten | Anwendungsfall |
|---|---|---|---|
quick | 25 | Nur Seed + Sitemaps, keine Linkerkennung | CI-Checks, schneller Health Check |
surface | 100 | Ein Sample pro URL-Muster | Allgemeine Audits (Standard) |
full | 500 | Alles bis zum Limit crawlen | Tiefgehende Analyse |
Der Surface-Modus ist intelligent – er erkennt URL-Muster wie /blog/{slug} oder /products/{id} und crawlt nur ein Sample pro Muster. Das macht ihn effizient für Websites mit vielen ähnlichen Seiten (Blogs, E-Commerce).
# Schneller Health Check (25 Seiten, keine Linkerkennung)
squirrel audit https://example.com -C quick --format llm
# Standard-Oberflächen-Audit (100 Seiten, Pattern-Sampling)
squirrel audit https://example.com --format llm
# Vollständiges umfassendes Audit (500 Seiten)
squirrel audit https://example.com -C full --format llm
# Seitenlimit für jeden Modus überschreiben
squirrel audit https://example.com -C surface -m 200 --format llm
Wann welcher Modus verwendet wird:
quick: CI-Pipelines, tägliche Health Checks, Überwachungsurface: Die meisten Audits – deckt eindeutige Vorlagen effizient abfull: Vor Markteinführungen, umfassende Analysen, tiefgehende Untersuchungen
Optionen des Report-Befehls
| Option | Alias | Beschreibung |
|---|---|---|
--list | -l | Letzte Audits auflisten |
--severity <level> | – | Nach Schweregrad filtern: error, warning, all |
--category <cats> | – | Nach Kategorien filtern (kommagetrennt) |
--format <fmt> | -f <fmt> | Ausgabeformat: console, text, json, html, markdown, xml, llm |
--output <path> | -o <path> | Ausgabedateipfad |
--input <path> | -i <path> | Aus JSON-Datei laden (Fallback-Modus) |
Konfigurations-Unterbefehle
| Befehl | Beschreibung |
|---|---|
config show | Aktuelle Konfiguration anzeigen |
config set <key> <value> | Konfigurationswert setzen |
config path | Pfad der Konfigurationsdatei anzeigen |
config validate | Konfigurationsdatei validieren |
Weitere Befehle
| Befehl | Beschreibung |
|---|---|
squirrel feedback | Feedback an das squirrelscan-Team senden |
squirrel skills install | Claude Code Skill installieren |
squirrel skills update | Claude Code Skill aktualisieren |
Selbst-Befehle
Selbstverwaltungsbefehle unter squirrel self:
| Befehl | Beschreibung |
|---|---|
self install | Lokale Installation bootstrappen |
self update | Nach Updates suchen und anwenden |
self completion | Shell-Vervollständigung generieren |
self doctor | Health Checks ausführen |
self version | Versionsinformationen anzeigen |
self settings | CLI-Einstellungen verwalten |
self uninstall | squirrel vom System entfernen |
Ausgabeformate
Konsolenausgabe (Standard)
Der Befehl audit zeigt standardmäßig eine für Menschen lesbare Konsolenausgabe mit farbiger Ausgabe und Fortschrittsanzeigen an.
LLM-Format
Um eine für LLM optimierte Ausgabe zu erhalten, verwende den Befehl report mit --format llm:
squirrel report <audit-id> --format llm
Das LLM-Format ist ein kompaktes XML/Text-Hybrid, das auf Tokeneffizienz optimiert ist (40 % kleiner als ausführliches XML):
- Zusammenfassung: Gesamtbewertung und wichtige Metriken
- Probleme nach Kategorie: Gruppiert nach Audit-Regelkategorie (Kern-SEO, technisch, Inhalt, Sicherheit)
- Defekte Links: Liste der defekten
…
[im Original abgeschnitten]