Mentionable
Mentionable

list_page_audits

Tool MCP list_page_audits : lister les Page Audits (OptimizationReports) d'un projet avec status, score et pageUrl, du plus récent au plus ancien.

Mis à jour le 2026-05-07

list_page_audits

list_page_audits retourne les Page Audits (lignes OptimizationReport) d'un projet, du plus récent au plus ancien, avec status, URL auditée, nombre de modifications et score GEO (quand l'audit est complet). Utilisez-le pour inspecter ce qui est déjà audité avant de déclencher un nouveau run avec run_page_audit.

Quand l'utiliser

  • Avant de queue un nouvel audit, pour skip les URL déjà couvertes.
  • Après un batch run, pour suivre lesquels sont passés à COMPLETED sans poll chaque auditId individuellement.
  • Pour reconstruire l'historique d'audits d'une page (filtrez le résultat côté client par pageUrl).

Input

Champ Type Défaut Description
projectId string (CUID) requis Projet ciblé.
cursor string — Cursor renvoyé dans pageInfo.nextCursor.
limit int 20 Items max, 1–100.
status enum — PENDING, GENERATING, COMPLETED, FAILED. Omettre pour tout retourner.

Response

{
  "data": [
    {
      "id": "clx_rep_42",
      "pageUrl": "https://example.com/features/integrations",
      "pageTitle": "Native integrations — Example",
      "keyword": "Native integrations — Example",
      "status": "COMPLETED",
      "totalModifications": 12,
      "geoScore": 71,
      "createdAt": "2026-05-05T09:00:00.000Z",
      "updatedAt": "2026-05-05T09:01:13.000Z"
    }
  ],
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": 1 }
}

Notes :

  • totalModifications et geoScore viennent du blob summary de l'audit et sont null tant que l'audit est PENDING/GENERATING ou en FAILED.
  • status reflète le cycle de vie OptimizationReport.status. Les états terminaux sont COMPLETED et FAILED.

Tips et patterns

  • Pagination : le cursor est l'id de l'audit. Stable entre pages.
  • À combiner avec get_page_audit : ce tool renvoie de la metadata uniquement. Pour lire le tableau modifications (le diff structuré), appelez get_page_audit avec l'id.
  • Polling status : plutôt que poll chaque audit pending un par un, listez avec status=PENDING ou status=GENERATING et walkez la page.

Tools liés