get_site_health

get_site_health renvoie la santé technique du site du projet à son dernier crawl mensuel : un score par niveau de gravité, chaque correctif trouvé (un correctif = un check, sur toutes les pages qu'il touche) du plus urgent au moins urgent, et ce qui a changé depuis le crawl précédent. C'est le même diagnostic que la page Santé du site du dashboard.

Quand l'utiliser

Commencez ici quand un agent doit savoir si le site lui-même empêche Google et les IA de le lire ou de le citer : robots IA bloqués, pages qui ne s'affichent qu'avec JavaScript, canoniques cassées, données structurées absentes, titres en double. Lisez ensuite les pages et la façon de corriger chaque problème avec list_site_issues, et l'ordre dans lequel les traiter avec list_priority_pages.

Input

Réponse

Pas encore de diagnostic

{ "success": true, "state": "running", "running": true }

state vaut none (le site n'a jamais été crawlé), running (le premier crawl ou son diagnostic est en cours) ou failed (le dernier crawl a échoué).

Prêt

{
  "success": true,
  "state": "ready",
  "running": false,
  "crawl": {
    "id": "cmg8a1k2p0001l70f3b9c4d2e",
    "checkedAt": "2026-10-01T04:12:00.000Z",
    "pageCount": 212,
    "pagesDiscovered": 230,
    "maxPages": 250
  },
  "scores": [
    { "level": "BLOCKING", "score": 100, "fixes": 0 },
    { "level": "AI_IMPACT", "score": 64, "fixes": 5 },
    { "level": "CONSISTENCY", "score": 91, "fixes": 2 },
    { "level": "SEO_HYGIENE", "score": 72, "fixes": 6 }
  ],
  "comparison": { "previousAt": "2026-09-01T04:10:00.000Z", "fixed": 4, "added": 1 },
  "fixes": [
    {
      "check": "jsonld-missing",
      "title": "No structured data for this kind of page",
      "level": "AI_IMPACT",
      "pages": 18,
      "siteWide": false,
      "isNew": false
    },
    {
      "check": "title-duplicate",
      "title": "Same title on several pages",
      "level": "SEO_HYGIENE",
      "pages": 34,
      "siteWide": false,
      "isNew": true
    }
  ]
}

• running : un nouveau crawl est en cours. Le diagnostic affiché reste le précédent jusqu'à sa fin.
• crawl.pageCount : pages retenues dans le diagnostic. pagesDiscovered face à maxPages indique si la limite de pages du plan a coupé le crawl.
• scores : un score sur 100 par niveau. BLOCKING (les moteurs ne peuvent ni lire ni indexer les pages), AI_IMPACT, CONSISTENCY (des faits qui se contredisent), SEO_HYGIENE (Google et Bing, dont les IA interrogent l'index).
• comparison : causes corrigées et causes apparues depuis le crawl précédent. null au premier diagnostic.
• fixes : du plus urgent au moins urgent. check est un code machine stable, title est en anglais, pages compte les pages touchées, siteWide signale un problème du site entier (robots.txt, page À propos absente). Chaque correctif est ouvert : ses pages et la façon de corriger sont dans list_site_issues.

Conseils et patterns

• Les bloquants d'abord. Un correctif BLOCKING est toujours en tête : rien d'autre ne compte tant que les moteurs ne lisent pas les pages.
• Corrigez la cause une fois. Un correctif avec beaucoup de pages vient en général d'un seul gabarit : lisez ses pages avec list_site_issues et filters.check, puis corrigez le gabarit.
• Rythme mensuel. Le site est crawlé une fois par mois. Appeler ce tool plus souvent renvoie le même diagnostic jusqu'au crawl suivant.

Tools liés

• list_site_issues : les pages de chaque correctif, avec la façon de les corriger.
• list_priority_pages : le plan, dans l'ordre où traiter les correctifs.
• run_page_fix : la to-do complète d'une page.