Communitygithub.com

AndresOrozcoDev/website

Prüft Websites auf SEO, technische Aspekte, Inhalt, Sicherheit, JS-Rendering und KI-Bereitschaft mit dem SEOmator-CLI. Liefert LLM-optimierte Berichte mit Gesundheitswerten über 251 Regeln und 20 Kategorien.

Was ist website?

Diese Fähigkeit ermöglicht es KI-Agenten, umfassende Website-Audits mit dem SEOmator-CLI durchzuführen. Sie analysiert Websites anhand von 251 Regeln in 20 Kategorien, darunter Kern-SEO, Leistung, Links, Bilder, Sicherheit, technisches SEO, Crawlbarkeit, strukturierte Daten, JavaScript-Rendering, Barrierefreiheit, Inhalt, soziale Medien, E-E-A-T, URL-Struktur, Weiterleitungen, Mobil, Internationalisierung, HTML-Validierung, KI/GEO-Bereitschaft und rechtliche Konformität. Der Audit liefert einen Gesamt-Gesundheitswert (0-100) mit Buchstabennoten (A-F), Kategorieaufschlüsselungen und detaillierten Problemen mit betroffenen URLs sowie umsetzbaren Lösungsvorschlägen. Das Tool unterstützt mehrere Ausgabeformate, darunter ein spezielles LLM-optimiertes XML-Format (`--format llm`), das 50-70% kleiner als JSON ist, sowie HTML-Berichte für gemeinsame Nutzung. Die Fähigkeit wird ideal eingesetzt, um die SEO-Gesundheit zu analysieren, technische SEO-Probleme zu debuggen, defekte Links zu erkennen und KI-Bereitschaft zu prüfen, und erfordert die Installation des npm-Pakets `@seomator/seo-audit`.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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

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:

  1. Bevorzuge Live-Websites gegenüber lokalen Entwicklungsservern für genaue Leistungs- und Rendering-Daten
  2. Verwende --no-cwv für schnellere Audits, wenn Core Web Vitals und JS-Rendering-Prüfungen nicht benötigt werden
  3. Plane Korrekturen als gleichzeitige Aufgaben, wenn mehrere Korrekturen implementiert werden
  4. 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:

  1. Überprüfe die Konfigurationen lokaler Entwicklungsserver (package.json-Skripte, .env-Dateien)
  2. Suche nach Vercel/Netlify-Projektlinks
  3. Überprüfe Umgebungsvariablen auf Bereitstellungs-URLs
  4. 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

OptionAliasBeschreibungStandard
--format <fmt>-fAusgabeformat: console, json, html, markdown, llmconsole
--max-pages <n>-mMaximale Anzahl zu crawlender Seiten10
--crawlMehrseiten-Crawl aktivierenfalse
--categories <list>-cKommagetrennte Kategorien zum AuditierenAlle
--refresh-rCache ignorieren, frisch abrufenfalse
--resumeUnterbrochenen Crawl fortsetzenfalse
--no-cwvCore Web Vitals + JS-Rendering überspringenfalse
--verbose-vFortschritt anzeigenfalse
--output <path>-oAusgabedateipfad
--config <path>Konfigurationsdateipfad
--saveIn ~/.seomator speichernfalse

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

FormatFlagAm besten geeignet für
console--format consoleMenschliche Terminalausgabe (Standard)
json--format jsonCI/CD, programmatische Verarbeitung
html--format htmlEigenständige Berichte, Teilen
markdown--format markdownDokumentation, GitHub
llm--format llmKI-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

PunktzahlNoteBedeutung
90-100AHervorragend - Nur kleinere Optimierungen erforderlich
80-89BGut - Warnungen beachten
70-79CVerbesserungsbedarf - Prioritäre Korrekturen erforderlich
50-69DSchlecht - Mehrere kritische Probleme
0-49FKritisch - Schwerwiegende Probleme zu beheben

Prioritätenreihenfolge (nach Kategoriegewicht)

Behebe Probleme in dieser Reihenfolge für maximale Wirkung:

  1. Kern (12%) - Meta-Tags, Kanonisch, H1, Indizierung
  2. Leistung (12%) - Core Web Vitals + Optimierung
  3. Links (8%) - Interne Verlinkungsstruktur
  4. Bilder (8%) - Leistung + Barrierefreiheit
  5. Sicherheit (8%) - Vertrauenssignale, SSL
  6. Technisches SEO (7%) - Grundlage für Crawling
  7. Crawlbarkeit (5%) - Indexierbarkeit, Paginierung
  8. Strukturierte Daten (5%) - Rich Snippets
  9. JavaScript-Rendering (5%) - Gerendertes DOM, SSR
  10. Inhalt (5%) - Textqualität + Duplikate
  11. Barrierefreiheit (4%) - WCAG-Konformität
  12. Soziale Medien (3%) - Social Sharing
  13. E-E-A-T (3%) - Vertrauen, Expertise
  14. URL-Struktur (3%) - URL-Hygiene
  15. Weiterleitungen (3%) - Weiterleitungsketten
  16. Mobil (2%) - Viewport, Schriftarten
  17. Internationalisierung (2%) - Hreflang
  18. HTML-Validierung (2%) - Dokumentenstruktur
  19. KI/GEO-Bereitschaft (2%) - Semantisches HTML, KI-Bots
  20. Rechtliche Konformität (1%) - Cookie-Zustimmung

Nach Schweregrad beheben

  1. Fehler (status: "fail") - Muss sofort behoben werden
  2. Warnungen (status: "warn") - Sollte bald behoben werden
  3. 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:

  1. Installiere Chrome, Chromium oder Edge
  2. Führe seomator self doctor aus, um die Browsererkennung zu überprüfen
  3. 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 20 fü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

  1. Abrufen: Lädt das Seiten-HTML herunter und misst die Antwortzeit
  2. Parsen: Extrahiert DOM, Meta-Tags, Links, Bilder, strukturierte Daten
  3. Anreichern: Ruft robots.txt und Sitemap einmal pro Audit ab
  4. Rendern (falls CWV aktiviert): Erfasst gerendertes DOM über Playwright für JS-Rendering-Analyse
  5. Crawlen (falls aktiviert): Entdeckt und ruft verlinkte Seiten ab
  6. Analysieren: Führt 251 Audit-Regeln gegen jede Seite aus
  7. Bewerten: Berechnet Kategorie- und Gesamtgewichte
  8. 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.md für alle 251 Regeln
  • Speicherarchitektur: Siehe docs/STORAGE-ARCHITECTURE.md für Datenbankdetails
  • CLI-Hilfe: seomator --help und seomator <command> --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.

Verwandte Skills