SEO-Audit-Fähigkeit
Auditiere Websites hinsichtlich SEO, Technik, Inhalt, Leistung, Sicherheit, JavaScript-Rendering und KI-Bereitschaft mit dem SEOmator-CLI.
SEOmator bietet umfassende Website-Audits, indem es die Website-Struktur und den Inhalt gegen 251 Regeln in 20 Kategorien analysiert.
Es liefert eine Liste von Problemen mit Schweregraden, betroffenen URLs und umsetzbaren Lösungsvorschlägen.
Links
- SEOmator npm-Paket: npmjs.com/package/@seomator/seo-audit
- GitHub-Repository: github.com/seo-skills/seo-audit-skill
- Web-UI: seomator.com/free-seo-audit-tool
Was diese Fähigkeit tut
Diese Fähigkeit ermöglicht es KI-Agenten, Websites auf 251 Regeln in 20 Kategorien zu auditieren, darunter:
- Kern-SEO (19 Regeln): Kanonische URLs, Indizierungsanweisungen, Titel-Einzigartigkeit, kanonische Konflikte/Schleifen
- Leistung (22 Regeln): LCP, CLS, FCP, TTFB, INP, Komprimierung, Caching, Minifizierung, HTTP/2
- Links (19 Regeln): Defekte Links, Weiterleitungsketten, Ankertext, verwaiste Seiten, Localhost/Fragment-Links
- Bilder (14 Regeln): Alt-Text, Abmessungen, Lazy Loading, moderne Formate, Alt-Länge, Hintergrundbilder
- Sicherheit (16 Regeln): HTTPS, HSTS, CSP, externe Link-Sicherheit, durchgesickerte Geheimnisse, SSL-Ablauf/Protokoll
- Technisches SEO (13 Regeln): robots.txt, sitemap.xml, URL-Struktur, 404-Seiten, Soft 404s, Fehlercodes
- Crawlbarkeit (18 Regeln): Sitemap-Konflikte, Indexierbarkeitssignale, kanonische Ketten, Paginierungsprobleme
- Strukturierte Daten (13 Regeln): Schema.org-Markup, Artikel, Organisation, FAQ, Produkt, Breadcrumb
- JavaScript-Rendering (13 Regeln): Gerendertes DOM, Roh- vs. gerenderte Abweichungen, SSR-Erkennung
- Barrierefreiheit (12 Regeln): ARIA-Label, Farbkontrast, Formular-Label, Sehenswürdigkeiten, Touch-Ziele
- Inhalt (17 Regeln): Wortanzahl, Lesbarkeit, Keyword-Dichte, Duplikaterkennung, Pixelbreiten
- Soziale Medien (9 Regeln): Open-Graph-Tags, Twitter Cards, Share-Buttons, Profil-Links
- E-E-A-T (14 Regeln): Autorenzeilen, Zitate, Vertrauenssignale, Über-/Kontaktseiten, YMYL-Erkennung
- URL-Struktur (14 Regeln): Keyword-Slugs, Stoppwörter, Großbuchstaben, Unterstriche, Session-IDs, Tracking-Parameter
- Weiterleitungen (8 Regeln): Weiterleitungsschleifen, Typen (301/302), Meta-Refresh, JavaScript-Weiterleitungen, defekte Weiterleitungen
- Mobil (5 Regeln): Schriftgrößen, horizontales Scrollen, aufdringliche Interstitials, Viewport-Probleme
- Internationalisierung (10 Regeln): lang-Attribut, hreflang-Validierung (Rückverweise, Konflikte, Abweichungen)
- HTML-Validierung (9 Regeln): Doctype, Zeichensatz, Kopfstruktur, Lorem Ipsum, mehrere Titel/Beschreibungen
- KI/GEO-Bereitschaft (5 Regeln): Semantisches HTML, KI-Bot-Zugriff, llms.txt, Schema-Drift
- Rechtliche Konformität (1 Regel): Cookie-Zustimmung
Der Audit durchsucht die Website, analysiert jede Seite anhand der Audit-Regeln und liefert einen umfassenden Bericht mit:
- Gesamt-Gesundheitswert (0-100) mit Buchstabennote (A-F)
- Kategorieaufschlüsselungen mit Bestanden/Warnung/Fehlgeschlagen-Zählungen
- Spezifische Probleme mit betroffenen URLs, gruppiert nach Regel
- Umsetzbare Lösungsvorschläge
Wann verwenden
Verwende diese Fähigkeit, wenn du Folgendes benötigst:
- Analyse der SEO-Gesundheit einer Website
- Debuggen technischer SEO-Probleme
- Prüfung auf defekte Links und Weiterleitungsketten
- Validierung von Meta-Tags, kanonischen URLs und strukturierten Daten
- Audit von Sicherheits-Headern, SSL und HTTPS
- Prüfung der Barrierefreiheitskonformität
- Analyse des JavaScript-Renderings und der SSR-Kompatibilität
- Bewertung der KI/GEO-Bereitschaft (semantisches HTML, llms.txt, Bot-Zugriff)
- Erkennung von doppeltem Inhalt über Seiten hinweg
- Validierung von hreflang- und Internationalisierungseinrichtung
- Prüfung der HTML-Dokumentenstruktur und -Validierung
- Generierung von Site-Audit-Berichten in mehreren Formaten
- Vergleich der Site-Gesundheit vor/nach Änderungen
Voraussetzungen
Diese Fähigkeit erfordert die Installation des SEOmator-CLI.
Installation
npm install -g @seomator/seo-audit
Installation überprüfen
Überprüfe, ob seomator installiert und das System bereit ist:
seomator self doctor
Dies prüft:
- Node.js-Version (18+ empfohlen)
- npm-Verfügbarkeit
- Chrome/Chromium für Core Web Vitals und JS-Rendering
- Schreibberechtigungen für ~/.seomator
- Lokale Konfigurationsdatei vorhanden
Einrichtung
Die Ausführung von seomator init erstellt eine seomator.toml-Konfigurationsdatei im aktuellen Verzeichnis.
seomator init # Interaktive Einrichtung
seomator init -y # Standardwerte verwenden
seomator init --preset blog # Blog-optimierte Konfiguration
seomator init --preset ecommerce # E-Commerce-Konfiguration
seomator init --preset ci # Minimal-CI-Konfiguration
Wenn sich keine seomator.toml im Verzeichnis befindet, ERSTELLE EINE mit seomator init, bevor Audits ausgeführt werden.
Verwendung
Best Practices für KI-Agenten
DU SOLLTEST immer --format llm bevorzugen - es bietet token-optimierte XML-Ausgabe, die speziell für KI-Agenten entwickelt wurde (50-70% kleiner als JSON).
Beim Auditieren:
- Bevorzuge Live-Websites gegenüber lokalen Entwicklungsservern für genaue Leistungs- und Rendering-Daten
- Verwende
--no-cwvfür schnellere Audits, wenn Core Web Vitals und JS-Rendering-Prüfungen nicht benötigt werden - Plane Korrekturen als gleichzeitige Aufgaben, wenn mehrere Korrekturen implementiert werden
- Führe Typprüfung/Formatierung durch nach der Implementierung von Korrekturen (tsc, eslint, prettier, etc.)
Website-Erkennung
Wenn der Benutzer keine zu auditierende Website bereitstellt:
- Überprüfe die Konfigurationen lokaler Entwicklungsserver (package.json-Skripte, .env-Dateien)
- Suche nach Vercel/Netlify-Projektlinks
- Überprüfe Umgebungsvariablen auf Bereitstellungs-URLs
- Frage den Benutzer, welche URL auditiert werden soll
Wenn sowohl lokale als auch Live-Websites verfügbar sind, schlage vor, die Live-Site zu auditieren für genaue Ergebnisse.
Grundlegender Workflow
# Schnelles Einzelseiten-Audit mit LLM-Ausgabe
seomator audit https://example.com --format llm --no-cwv
# Mehrseiten-Crawl (bis zu 50 Seiten)
seomator audit https://example.com --crawl -m 50 --format llm --no-cwv
# Vollständiges Audit mit Core Web Vitals + JS-Rendering-Analyse
seomator audit https://example.com --crawl -m 20 --format llm
Erweiterte Optionen
Frischen Crawl erzwingen (Cache ignorieren):
seomator audit https://example.com --refresh --format llm
Unterbrochenen Crawl fortsetzen:
seomator audit https://example.com --resume --format llm
Nur bestimmte Kategorien auditieren:
seomator audit https://example.com -c core,security,js --format llm --no-cwv
HTML-Bericht zum Teilen speichern:
seomator audit https://example.com --format html -o report.html
Ausführliche Ausgabe zum Debuggen:
seomator audit https://example.com --format llm -v
Befehlsreferenz
Audit-Befehlsoptionen
| Option | Alias | Beschreibung | Standard |
|---|---|---|---|
--format <fmt> | -f | Ausgabeformat: console, json, html, markdown, llm | console |
--max-pages <n> | -m | Maximale Anzahl zu crawlender Seiten | 10 |
--crawl | Mehrseiten-Crawl aktivieren | false | |
--categories <list> | -c | Kommagetrennte Kategorien zum Auditieren | Alle |
--refresh | -r | Cache ignorieren, frisch abrufen | false |
--resume | Unterbrochenen Crawl fortsetzen | false | |
--no-cwv | Core Web Vitals + JS-Rendering überspringen | false | |
--verbose | -v | Fortschritt anzeigen | false |
--output <path> | -o | Ausgabedateipfad | |
--config <path> | Konfigurationsdateipfad | ||
--save | In ~/.seomator speichern | false |
Andere Befehle
seomator init # Konfigurationsdatei erstellen
seomator self doctor # Systemeinrichtung überprüfen
seomator config --list # Alle Konfigurationswerte anzeigen
seomator report --list # Vergangene Berichte auflisten
seomator db stats # Datenbankstatistiken anzeigen
Ausgabeformate
| Format | Flag | Am besten geeignet für |
|---|---|---|
| console | --format console | Menschliche Terminalausgabe (Standard) |
| json | --format json | CI/CD, programmatische Verarbeitung |
| html | --format html | Eigenständige Berichte, Teilen |
| markdown | --format markdown | Dokumentation, GitHub |
| llm | --format llm | KI-Agenten (empfohlen) |
Die --format llm-Ausgabe ist ein kompaktes XML-Format, das auf Tokeneffizienz optimiert ist:
- 50-70% kleiner als JSON-Ausgabe
- Probleme nach Schweregrad sortiert (kritisch zuerst)
- Lösungsvorschläge für jedes Problem enthalten
- Saubere stdout für die Weiterleitung an KI-Tools
Beispiele
Beispiel 1: Schnelles Audit mit LLM-Ausgabe
# Benutzer fragt: "Überprüfe example.com auf SEO-Probleme"
seomator audit https://example.com --format llm --no-cwv
Beispiel 2: Tiefer Crawl für große Website
# Benutzer fragt: "Führe ein gründliches Audit mit bis zu 100 Seiten durch"
seomator audit https://example.com --crawl -m 100 --format llm --no-cwv
Beispiel 3: Frisches Audit nach Änderungen
# Benutzer fragt: "Auditiere die Website erneut, ignoriere zwischengespeicherte Ergebnisse"
seomator audit https://example.com --refresh --format llm --no-cwv
Beispiel 4: Teilbaren Bericht erstellen
# Benutzer fragt: "Erstelle einen HTML-Bericht, den ich teilen kann"
seomator audit https://example.com --crawl -m 20 --format html -o seo-report.html
Beispiel 5: Fokus auf bestimmte Bereiche
# Benutzer fragt: "Überprüfe nur mein JavaScript-Rendering und meine Weiterleitungen"
seomator audit https://example.com -c js,redirect --format llm
Ergebnisse auswerten
Bewertungsbereiche
| Punktzahl | Note | Bedeutung |
|---|---|---|
| 90-100 | A | Hervorragend - Nur kleinere Optimierungen erforderlich |
| 80-89 | B | Gut - Warnungen beachten |
| 70-79 | C | Verbesserungsbedarf - Prioritäre Korrekturen erforderlich |
| 50-69 | D | Schlecht - Mehrere kritische Probleme |
| 0-49 | F | Kritisch - Schwerwiegende Probleme zu beheben |
Prioritätenreihenfolge (nach Kategoriegewicht)
Behebe Probleme in dieser Reihenfolge für maximale Wirkung:
- Kern (12%) - Meta-Tags, Kanonisch, H1, Indizierung
- Leistung (12%) - Core Web Vitals + Optimierung
- Links (8%) - Interne Verlinkungsstruktur
- Bilder (8%) - Leistung + Barrierefreiheit
- Sicherheit (8%) - Vertrauenssignale, SSL
- Technisches SEO (7%) - Grundlage für Crawling
- Crawlbarkeit (5%) - Indexierbarkeit, Paginierung
- Strukturierte Daten (5%) - Rich Snippets
- JavaScript-Rendering (5%) - Gerendertes DOM, SSR
- Inhalt (5%) - Textqualität + Duplikate
- Barrierefreiheit (4%) - WCAG-Konformität
- Soziale Medien (3%) - Social Sharing
- E-E-A-T (3%) - Vertrauen, Expertise
- URL-Struktur (3%) - URL-Hygiene
- Weiterleitungen (3%) - Weiterleitungsketten
- Mobil (2%) - Viewport, Schriftarten
- Internationalisierung (2%) - Hreflang
- HTML-Validierung (2%) - Dokumentenstruktur
- KI/GEO-Bereitschaft (2%) - Semantisches HTML, KI-Bots
- Rechtliche Konformität (1%) - Cookie-Zustimmung
Nach Schweregrad beheben
- Fehler (status: "fail") - Muss sofort behoben werden
- Warnungen (status: "warn") - Sollte bald behoben werden
- Bestanden (status: "pass") - Keine Maßnahmen erforderlich
Ausgabeübersicht
Nach der Implementierung von Korrekturen gib dem Benutzer eine Zusammenfassung aller vorgenommenen Änderungen.
Bei der Planung des Umfangs organisiere Aufgaben so, dass sie gleichzeitig als Unteragenten ausgeführt werden können, um die Implementierung zu beschleunigen.
Fehlerbehebung
seomator-Befehl nicht gefunden
Wenn dieser Fehler auftritt, ist seomator nicht installiert oder nicht im PATH.
Lösung:
npm install -g @seomator/seo-audit
Core Web Vitals nicht gemessen
Wenn CWV-Metriken fehlen, ist Chrome/Chromium möglicherweise nicht verfügbar.
Lösung:
- Installiere Chrome, Chromium oder Edge
- Führe
seomator self doctoraus, um die Browsererkennung zu überprüfen - Verwende
--no-cwv, um CWV zu überspringen, falls nicht benötigt
Crawl-Timeout oder langsame Leistung
Bei großen Websites können Audits mehrere Minuten dauern.
Lösung:
- Verwende
--verbose, um den Fortschritt zu sehen - Begrenze Seiten mit
-m 20für schnellere Ergebnisse - Verwende
--no-cwv, um browserbasierte Messungen zu überspringen
Ungültige URL
Stelle sicher, dass die URL das Protokoll enthält:
# Falsch
seomator audit example.com
# Richtig
seomator audit https://example.com
Funktionsweise
- Abrufen: Lädt das Seiten-HTML herunter und misst die Antwortzeit
- Parsen: Extrahiert DOM, Meta-Tags, Links, Bilder, strukturierte Daten
- Anreichern: Ruft robots.txt und Sitemap einmal pro Audit ab
- Rendern (falls CWV aktiviert): Erfasst gerendertes DOM über Playwright für JS-Rendering-Analyse
- Crawlen (falls aktiviert): Entdeckt und ruft verlinkte Seiten ab
- Analysieren: Führt 251 Audit-Regeln gegen jede Seite aus
- Bewerten: Berechnet Kategorie- und Gesamtgewichte
- Berichten: Generiert Ausgabe im angeforderten Format
Ergebnisse werden in ~/.seomator/ für späteren Abruf mit seomator report gespeichert.
Ressourcen
- Vollständige Regelnreferenz: Siehe
docs/SEO-AUDIT-RULES.mdfür alle 251 Regeln - Speicherarchitektur: Siehe
docs/STORAGE-ARCHITECTURE.mdfür Datenbankdetails - CLI-Hilfe:
seomator --helpundseomator <command> --help