SEO-Operationen & Automatisierung (seo-ops)

Was macht SEO-Operationen & Automatisierung (seo-ops)?

Ein automatisiertes Runbook zur Einrichtung des seo MCP-Servers, Integration von Pre-Push- und CI/CD-Qualitätsprüfungen und Durchführung evidenzbasierter technischer und Ranking-Audits.

---

Phase 0: Obligatorischer Pre-Flight-Check & Auto-Installation

[!IMPORTANT] Null-Manuelle-Setup-Annahme: Überprüfe vor jeder Code-Analyse oder jedem Audit, ob die seo CLI und der MCP-Server konfiguriert und in der aktuellen Sitzung verfügbar sind.

flowchart TD
    Start["/seo-ops aufrufen"] --> Check{"Ist SEO MCP / CLI konfiguriert?"}
    Check -->|Nein / Fehlt| AutoInstall["1. Auto-Installation ausführen<br/>('npm i -g seo' + mcp_config.json schreiben)"]
    AutoInstall --> TestDaemon["2. Überprüfen: 'npx -y seo mcp serve --test'"]
    TestDaemon --> PromptRestart["3. Benutzer zu Agent/IDE-Neustart auffordern & STOPP"]
    Check -->|Ja / Aktiv| RouteIntent["Zur Benutzerabsicht-Routing fortfahren"]

Selbstinstallations-Runbook (Wird ausgelöst, wenn MCP/CLI fehlt)

1. Paket installieren:

   npm install -g seo
   

2. MCP-Server konfigurieren: Stelle sicher, dass .agents/mcp_config.json (und ~/.gemini/config/mcp_config.json) Folgendes enthält:

   {
     "mcpServers": {
       "seo": {
         "command": "npx",
         "args": ["-y", "seo", "mcp", "serve"]
       }
     }
   }
   

3. Daemon überprüfen:

   npx -y seo mcp serve --test
   

4. Neustart anfordern & Zug beenden: Wenn die MCP-Tools in dieser Sitzung neu hinzugefügt wurden, benötigt Antigravity einen Sitzungs-/Fenster-Neuladevorgang, um die Tools zu registrieren. Gib deutlich an:

   "Die seo CLI und der MCP-Server wurden installiert und registriert. Bitte lade das IDE-Fenster neu oder starte die Agentensitzung neu, damit die neuen MCP-Tools (seo_list_reports, seo_describe_report, seo_run_report) geladen werden. Rufe dann /seo-ops erneut auf." Fahre NICHT mit manuellen Code-Änderungen oder halluzinierten Vermutungen ohne aktive Tools fort.

---

Aktive Absichtsweiterleitung (Wenn MCP/CLI bereit ist)

Wenn die Voraussetzungen erfüllt sind, fordere den Benutzer auf oder überprüfe den Kontext auf sein Ziel:

flowchart LR
    Route["Aktive Sitzung"] --> A["1. CI/CD & Pre-Push-Setup (setup-cicd)"]
    Route --> B["2. Technisches & On-Page-Audit (audit-technical)"]
    Route --> C["3. Search Console & Wachstums-Audit (audit-gsc)"]
    Route --> D["4. Umgebungs-Gesundheitscheck (check-health)"]

---

Pfad A: Repository-CI/CD & Pre-Push-Qualitätsprüfung (setup-cicd)

Erzwinge Null-Regression-SEO-Tore in Entwicklungs- und Bereitstellungspipelines:

• 1. Node 22+ überprüfen: Führe node -v aus, um die Node 22+-Laufzeitumgebung sicherzustellen.
• 2. Lokalen Pre-Push-Hook konfigurieren:
  • Stelle ein Pre-Push-Runner-Skript bereit (scripts/seo-pre-push.ps1 oder scripts/seo-pre-push.sh) mit automatischer Erkennung des Dev-Servers (Wiederverwendung aktiver Instanzen oder Start von cmd.exe /c pnpm run dev mit Bereinigung der Prozessbaumstruktur).
  • Führe in .husky/pre-push diskrete Schritte aus:

    pnpm run test:all
    pnpm run seo:pre-push
    

  • Siehe cicd-pipeline-guide.md.
• 3. GitHub Actions-Workflow installieren:
  • Erstelle .github/workflows/seo-check.yml mit seo-ci.yml.template.
• 4. Pipeline validieren:
  • Windows: powershell -ExecutionPolicy Bypass -File .agents/skills/seo-ops/scripts/verify-seo-setup.ps1 -Mode cicd
  • Linux/macOS: bash .agents/skills/seo-ops/scripts/verify-seo-setup.sh -m cicd

---

Pfad B: Technisches & On-Page-Audit (audit-technical)

Führe evidenzbasierte Crawls auf lokalen Builds oder Live-URLs durch:

• 1. Lokalen Build/Start ausführen:
  • Führe pnpm build && pnpm start auf http://127.0.0.1:3000 aus.
• 2. Technisches Audit durchführen:
  • Über MCP: Rufe seo_run_report mit reportId: "audit-page" oder "site-crawl" und params: {"url": "http://127.0.0.1:3000"} auf.
  • Über CLI:

    npx -y seo report --url http://127.0.0.1:3000 --actions-only --json
    

• 3. Next.js-Code korrigieren:
  • Aktualisiere generateMetadata() (Titel, Beschreibung, OpenGraph, Kanonische URLs).
  • Korrigiere JSON-LD-Strukturdaten-Komponenten (BreadcrumbList, Article, WebSite).
  • Korrigiere interne defekte <Link>-Tags und app/sitemap.ts.
  • Siehe ranking-optimization-guide.md.
• 4. Korrekturen überprüfen:
  • Führe erneut seo audit-page --url <target-url> aus, um einen sauberen Zustand ohne Befunde zu bestätigen.

---

Pfad C: Search Console & Wachstumschancen (audit-gsc)

Erschließe Ranking-Chancen auf Live-Domains mit Search Console:

• 1. Reports über MCP entdecken:
  • Rufe seo_list_reports auf (Kategorie: "gsc" oder "pseo").
  • Rufe seo_describe_report für reportId: "quick-wins", "second-page" oder "pseo-patterns" auf.
• 2. Chancen-Audit durchführen:
  • Rufe seo_run_report mit der Zieleigenschaft auf (site: "sc-domain:example.com").
• 3. Verbesserungen anwenden:
  • Quick Wins (Positionen 4–10): Verfeinere <title> und <meta description>, um die Klickrate zu steigern.
  • Zweite Seite (Positionen 10–20): Füge kontextbezogene interne Links von übergeordneten Seiten mit hoher Autorität hinzu und vertiefe den Inhalt.
  • pSEO-Muster: Erstelle dynamische Routen mit generateStaticParams().
• 4. Erneut überprüfen: Bestätige, dass aktualisierte Meta- und Schema-Markups im Produktions-SSR-Build gerendert werden.

---

Randfälle & Bekannte Fallstricke

• Prozessneustartanforderung: Wenn .agents/mcp_config.json geändert wird, kann der Agent erst nach einem Neuladen der Sitzung/des Fensters auf neue Tools zugreifen. Überspringe niemals die Neustartaufforderung.
• Windows-Pfadauflösung: Verwende immer "command": "npx" mit ["-y", "seo", "mcp", "serve"], um %PATH%-Binärsuchfehler unter Windows zu vermeiden.
• Keine statische Schätzung: Untersuche Code niemals statisch auf SEO, ohne zuerst die MCP-Tools oder den CLI-Report auszuführen.
• Evidenztrennung: Halte beobachtete Crawl-Evidenz getrennt von Schätzungen externer Provider-Keywords.

---

Referenzhandbücher & Ressourcen

• MCP-Setup- & Tool-Referenz
• CI/CD- & Pre-Push-Pipeline-Handbuch
• SEO-Ranking- & Code-Behebungs-Handbuch
• GitHub Actions CI-Workflow-Vorlage
• MCP-Konfigurations-JSON-Vorlage