Réglages des cookies

Les cookies nécessaires gardent le site fonctionnel. L'analytics montre quelles pages sont utiles. Vous pouvez changer votre choix à tout moment depuis le pied de page.

Politique de cookies — le détail : catégories de cookies, stockage de votre choix dans le navigateur et retrait du consentement.

Nécessaires

Fonctions de base du site et votre choix de consentement. Toujours actifs.

Mesure d'audience

Aide à comprendre comment le site est utilisé. Chargé uniquement avec votre accord.

GitHubTélécharger le ZIP

Générateur de rapports SEO : XLSX, DOCX, PDF

report-build met en forme les preuves conservées au format XLSX, DOCX, CSV, Markdown, JSON ou sous forme d’aperçu PDF borné. Il met en forme les preuves et n’invente jamais de constats.

Voir sur GitHubDémarrage rapide

Ce qu'elle fait

  • Terminal : seohead report-build formats

Formats

Un même audit peut devenir un tableur de travail, un document client ou des données JSON lisibles par une machine. Le XLSX contient des feuilles de constats, de pages et de périmètre ; les grandes feuilles sont découpées avec un index haché. Le DOCX commence par un résumé exécutif des comptages et des contrôles indisponibles, suivi des preuves. Il n’ajoute ni conclusion ni recommandation propre.

  • xlsx : le classeur d’audit factuel pour l’équipe
  • docx : un document pour le client ou le manager
  • csv : des tableaux distincts pour les constats, les preuves de périmètre et les pages
  • md et json : pour un dépôt ou un autre agent

Aperçu PDF

Le PDF est une vue de lecture bornée. La première page indique combien de constats et de pages existent, combien sont affichés et combien ont été omis. Les fichiers JSON complets, les CSV et un manifeste haché sont écrits à côté, si bien que rien n’est perdu. Le PDF est généré localement avec Chrome, Edge ou Chromium et n’effectue aucune requête réseau.

  • Les entrées audit.v2 diffusées exigent l’option explicite --pdf-policy overview-v1
  • Le PDF et son dossier d’accompagnement doivent être deux nouveaux chemins
  • Choisissez la langue du PDF avec --lang en ou --lang ru

Paquets BI

Pour de nombreux sites ou un tableau de bord, bi-export transforme un scan ou un audit enregistré en partitions CSV typées et en manifeste versionné, avec le nombre de lignes et les empreintes SHA-256. Il fonctionne hors ligne. Des commandes de plan distinctes vérifient un paquet pour Google Sheets ou BigQuery sans toucher à Google ; écrire vers une destination est une étape explicite à part.

  • bi-sheets-plan et bi-bigquery-plan sont hors ligne et en lecture seule
  • Les valeurs inconnues ou indisponibles restent marquées, et une mesure égale à zéro reste zéro
  • bi-destination-apply exige une autorisation de l’hôte et n’accepte jamais d’identifiants

Trois étapes, un seul scan enregistré

  1. Partir d’un audit enregistré

    Indiquez à report-build un audit JSON ou un artefact SQLite scan.v1. Il lit les preuves enregistrées et ne crawle pas le site.

  2. Choisir le format

    Écrivez en xlsx, docx, csv, md ou json. Le PDF est un aperçu borné et exige une politique explicite pour les audits diffusés.

  3. Appliquer une vue enregistrée

    Avec --project et --view, une page bornée de constats est affichée. Les totaux couvrent toujours tout l’audit.

Contrôles de cette fonctionnalité

ContrôleSignificationGravitéPreuve
BROKEN_PAGE_4XXLa page renvoie une réponse 4xxCriticalURL et code de statut
REDIRECT_LOOPLa chaîne de redirections revient vers une URL déjà visitéeCriticalChemin de redirection
TITLE_MISSINGLa balise title est absenteCriticalURL
H1_MISSINGLa page n’a pas de titre H1ImportantURL
DESC_MISSINGLa balise meta description est absenteImportantURL
CANONICAL_MISSINGUne page indexable n’a pas d’URL canoniqueImportantURL
REDIRECT_CHAINLa chaîne de redirections comporte deux redirections ou plusImportantSauts dans l’ordre
URL_NOT_IN_SITEMAPUne page indexable est absente du sitemapTipURL

Une seule commande

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

Commencez par installer : guide d'installation. Chaque commande fonctionne aussi comme outil MCP pour les agents IA.

Ce qu'il vous faut

  • Un audit JSON enregistré ou un scan natif (fichier SQLite scan.v1)
  • Un chemin de sortie avec --out, et un format avec --format
  • L’extra reports pour XLSX et DOCX (openpyxl, python-docx)
  • Chrome, Edge ou Chromium installé localement, pour le PDF uniquement

Limites

  • Il met en forme un audit enregistré. Il ne crawle pas, ne revérifie pas et n’ajoute aucun constat
  • Le PDF est un aperçu et non une liste complète. Les données complètes se trouvent dans les fichiers JSON et CSV qui l’accompagnent
  • Avec --project et --view, vous obtenez une page bornée de constats, mais les totaux couvrent tout l’audit
  • Le CSV est un export à plat, pas un backlog regroupé. Pour les tâches, utilisez la liste de tâches

Questions

report-build crawle-t-il mon site ?
Non. Il met en forme un audit que vous avez déjà produit, à partir d’un audit JSON ou d’un fichier SQLite scan.v1. Lancez d’abord site-audit, crawl-site ou sf run.
Peut-il ajouter des constats que l’audit n’a pas enregistrés ?
Non. Il met en forme les preuves et n’invente jamais de constats. Le rapport montre ce que l’audit a enregistré, y compris les contrôles ignorés ou indisponibles.
Puis-je obtenir un PDF ?
Oui, sous forme d’aperçu borné, accompagné des fichiers JSON et CSV complets. Les entrées audit.v2 diffusées exigent --pdf-policy overview-v1. Le PDF nécessite Chrome, Edge ou Chromium en local. Choisissez --lang en ou --lang ru.
Un long rapport sera-t-il une seule feuille énorme ?
Non. Le XLSX découpe les grandes feuilles Findings et Pages et écrit un index haché.
Quel format envoyer à un client ?
Le DOCX est le document lisible, le XLSX est le classeur destiné à ceux qui veulent filtrer des lignes. Les deux montrent les mêmes preuves enregistrées. Relisez l’un ou l’autre avant de l’envoyer.
Faut-il des clés, ou cela coûte-t-il de l’argent ?
Non. report-build fonctionne hors ligne et n’utilise aucun fournisseur. Il écrit uniquement le fichier que vous indiquez avec --out, plus le dossier d’accompagnement pour un PDF.

Pour aller plus loin

Autres dans ce groupe · Résultats

Liste de tâches SEO pour développeursFonctionnalitéVisualisation du graphe de maillage interneFonctionnalité

Essayez-le sur votre site

Télécharger le ZIPToutes les fonctionnalités