list_site_issues

list_site_issues liste les problèmes du dernier crawl du site, une ligne par page et par check, avec la façon de corriger chacun et les faits qui le fondent. C'est le tool qu'utilise un agent qui travaille dans un éditeur de code (Claude Code, Cursor) pour corriger le site lui-même : filtrer sur une page, lire ce qui ne va pas, modifier le gabarit ou le contenu.

Quand l'utiliser

Après get_site_health, pour obtenir les pages d'un correctif (filters.check), ou tous les problèmes d'une page que vous allez modifier (filters.pageUrl). Chaque problème est listé, avec la façon de le corriger. Sur n'importe quelle page crawlée, run_page_fix va plus loin : JSON-LD prêt à coller et liens internes à ajouter.

Input

Réponse

{
  "data": [
    {
      "id": "robots-ai-blocked|",
      "url": null,
      "check": "robots-ai-blocked",
      "level": "BLOCKING",
      "title": "AI robots blocked by robots.txt",
      "howToFix": "Remove the Disallow rules that apply to these robots in robots.txt, or add an Allow rule for them.",
      "details": { "bots": ["GPTBot", "ClaudeBot"] }
    },
    {
      "id": "js-only-content|https://example.com/pricing",
      "url": "https://example.com/pricing",
      "check": "js-only-content",
      "level": "BLOCKING",
      "title": "Content only visible with JavaScript",
      "howToFix": "Render the main content on the server (SSR or static generation) so it is in the HTML before any JavaScript runs.",
      "details": { "rawWords": 12, "renderedWords": 640 }
    }
  ],
  "pageInfo": { "hasMore": true, "nextCursor": "20", "totalCount": 57 },
  "summary": { "crawlId": "cmg8a1k2p0001l70f3b9c4d2e", "checkedAt": "2026-10-01T04:12:00.000Z" }
}

• Les lignes sont triées par level (le plus grave d'abord), les problèmes du site entier (url: null) en tête de chaque niveau, puis par check et par URL.
• title et howToFix sont en anglais. details porte les faits du problème (robots bloqués, URLs en double, champs manquants) ou null.
• summary donne le crawl d'où viennent les problèmes : crawlId et checkedAt.
• summary vaut null et data est vide tant que le site n'a pas de diagnostic.

Conseils et patterns

• Une page à la fois. Avant de modifier une page, appelez le tool avec filters.pageUrl et traitez les lignes dans l'ordre.
• Corrigez le gabarit, pas la page. Quand le même check touche des dizaines de pages (title-duplicate, heading-skip), la cause est en général un seul gabarit : corrigez-le une fois.
• Journalisez ce qui est en ligne. Appelez create_action_log une fois le correctif publié, puis comparez au crawl suivant avec comparison de get_site_health.

Tools liés

• get_site_health : les scores et tous les correctifs.
• list_priority_pages : le plan, dans l'ordre où traiter les correctifs.
• get_page_fix : le correctif complet d'une page, avec JSON-LD et liens.