SEO-Berichtsgenerator: XLSX, DOCX, PDF

report-build formatiert gesicherte Belege als XLSX, DOCX, CSV, Markdown, JSON oder als begrenzte PDF-Übersicht. Es formatiert nur Belege und erfindet nie Befunde.

Was es leistet

Formate

Aus einem Audit können eine Arbeitstabelle, ein Kundendokument oder maschinenlesbares JSON entstehen. XLSX enthält Blätter für Befunde, Seiten und Umfang. Große Blätter werden mit einem Hash-Index aufgeteilt. DOCX beginnt mit einer Zusammenfassung der Anzahlen und der nicht verfügbaren Prüfungen, danach folgen die Belege. Eigene Schlussfolgerungen oder Empfehlungen ergänzt das Dokument nicht.

  • xlsx: die sachliche Audit-Arbeitsmappe für das Team
  • docx: ein Dokument für Kunden oder Vorgesetzte
  • csv: getrennte Tabellen für Befunde, Umfangsbelege und Seiten
  • md und json: für ein Repository oder einen anderen Agenten

PDF-Übersicht

Das PDF ist eine begrenzte Leseansicht. Die erste Seite nennt, wie viele Befunde und Seiten es gibt, wie viele angezeigt und wie viele weggelassen werden. Vollständiges JSON, CSV-Dateien und ein Manifest mit Hashes entstehen daneben, damit nichts verloren geht. Das PDF wird lokal mit Chrome, Edge oder Chromium erzeugt und stellt keine Netzwerkanfragen.

  • Gestreamte audit.v2-Eingaben benötigen die ausdrückliche Option --pdf-policy overview-v1
  • Das PDF und sein Begleitordner müssen beide neue Pfade sein
  • Die Sprache des PDFs wählen Sie mit --lang en oder --lang ru

BI-Pakete

Für viele Websites oder ein Dashboard macht bi-export aus einem gespeicherten Scan oder Audit typisierte CSV-Partitionen und ein versioniertes Manifest mit Zeilenanzahlen und SHA-256-Hashes. Der Export läuft offline. Eigene Plan-Befehle prüfen ein Paket für Google Sheets oder BigQuery, ohne Google zu kontaktieren. Das Schreiben in ein Ziel ist ein eigener, ausdrücklicher Schritt.

  • bi-sheets-plan und bi-bigquery-plan sind offline und nur lesend
  • Unbekannte oder nicht verfügbare Werte bleiben markiert, und eine gemessene Null bleibt Null
  • bi-destination-apply braucht eine Freigabe durch den Host und akzeptiert nie Zugangsdaten

Drei Schritte, ein gespeicherter Scan

  1. Ein gespeichertes Audit einspeisen

    Richten Sie report-build auf ein Audit-JSON oder ein SQLite-Artefakt scan.v1. Es liest die gespeicherten Belege und crawlt die Website nicht.

  2. Das Format wählen

    Schreiben Sie xlsx, docx, csv, md oder json. PDF ist eine begrenzte Übersicht und braucht für gestreamte Audits eine ausdrückliche Richtlinie.

  3. Eine gespeicherte Ansicht anwenden

    Mit --project und --view wird eine begrenzte Seite mit Befunden angezeigt. Die Summen decken weiterhin das gesamte Audit ab.

Prüfungen in dieser Funktion

PrüfungBedeutungSchweregradBeleg
BROKEN_PAGE_4XXDie Seite liefert eine 4xx-AntwortCriticalURL und Statuscode
REDIRECT_LOOPDie Weiterleitungskette führt zu einer URL zurück, die sie bereits besucht hatCriticalWeiterleitungspfad
TITLE_MISSINGDas Title-Element fehltCriticalURL
H1_MISSINGDie Seite hat keine H1-ÜberschriftImportantURL
DESC_MISSINGDie Meta-Description fehltImportantURL
CANONICAL_MISSINGEine indexierbare Seite hat keine kanonische URLImportantURL
REDIRECT_CHAINDie Weiterleitungskette hat zwei oder mehr SprüngeImportantSprünge in der Reihenfolge
URL_NOT_IN_SITEMAPEine indexierbare Seite fehlt in der SitemapTipURL

Ein Befehl

bash
seohead report-build --audit ./scans/audit.sqlite --format xlsx --out audit.xlsx

Zuerst installieren: Installationsanleitung. Jeder Befehl läuft auch als MCP-Tool für KI-Agenten.

Was Sie brauchen

  • Ein gespeichertes Audit als JSON oder ein nativer Scan (SQLite-Datei scan.v1)
  • Ein Ausgabepfad mit --out und ein Format mit --format
  • Das Zusatzpaket reports für XLSX und DOCX (openpyxl, python-docx)
  • Lokal installiertes Chrome, Edge oder Chromium, nur für PDF

Grenzen

  • Es formatiert ein gespeichertes Audit. Es crawlt nicht, prüft nicht erneut und ergänzt keine Befunde
  • Das PDF ist eine Übersicht, keine vollständige Liste. Die vollständigen Daten stehen in den JSON- und CSV-Begleitdateien
  • Mit --project und --view erhalten Sie eine begrenzte Seite mit Befunden. Die Summen decken jedoch das gesamte Audit ab
  • CSV ist ein flacher Export und keine gruppierte Backlog-Liste. Für Aufgaben nutzen Sie die Aufgabenliste

Fragen

Crawlt report-build meine Website?
Nein. Es formatiert ein Audit, das Sie bereits erstellt haben, aus einem Audit-JSON oder einer SQLite-Datei scan.v1. Führen Sie zuerst site-audit, crawl-site oder einen SF-Lauf aus.
Kann es Befunde ergänzen, die das Audit nicht erfasst hat?
Nein. Es formatiert Belege und erfindet nie Befunde. Der Bericht zeigt, was das Audit gespeichert hat, einschließlich übersprungener oder nicht verfügbarer Prüfungen.
Kann ich ein PDF erhalten?
Ja, als begrenzte Übersicht mit vollständigen JSON- und CSV-Begleitdateien. Gestreamte audit.v2-Eingaben brauchen --pdf-policy overview-v1. Für das PDF ist ein lokal installiertes Chrome, Edge oder Chromium nötig. Wählen Sie --lang en oder --lang ru.
Wird ein langer Bericht zu einem riesigen Blatt?
Nein. XLSX teilt große Blätter für Befunde und Seiten auf und schreibt einen Hash-Index.
Welches Format sollte ich an einen Kunden senden?
DOCX ist das lesbare Dokument, XLSX die Arbeitsmappe für alle, die Zeilen filtern möchten. Beide zeigen dieselben gespeicherten Belege. Prüfen Sie jede Datei, bevor Sie sie versenden.
Braucht es API-Schlüssel, oder kostet es Geld?
Nein. report-build arbeitet offline und nutzt keinen Anbieter. Es schreibt nur die Datei, die Sie mit --out angeben, bei einem PDF zusätzlich den Begleitordner.

Testen Sie es auf Ihrer eigenen Website