Mentionable
Mentionable

run_page_audit

Tool MCP run_page_audit : queue un Page Audit sur une URL. Débite 100 credits par audit sur tous les plans, prélevés sur le pool de credits du workspace. Retourne un auditId ; l'audit complète en async.

Mis à jour le 2026-05-07

run_page_audit queue un Page Audit sur une URL et renvoie un auditId immédiatement. L'audit tourne en async (typiquement 30–90 secondes) et passe par PENDING → GENERATING → COMPLETED. Pollez get_page_audit pour récupérer les modifications quand prêt.

Requiert au moins le rôle member. Le rôle customer est rejeté.

Billing

Tous les plans sont credit-based. run_page_audit débite 100 credits par audit sur Growth, Pro et Agency, prélevés sur le pool de credits mensuel du workspace (Growth 1 500, Pro 3 000, Agency 5 000 credits par mois). Au-delà des credits inclus, l'overage est facturé 0,02 € par credit, plafonné par le monthly overage cap configurable du workspace.

L'éligibilité est vérifiée avant que l'audit soit queue. Si le workspace n'a plus assez de credits ou est plafonné par son overage cap, le tool retourne une erreur quota_exceeded structurée (reason: "insufficient_credits") et aucun travail n'est démarré.

En dev (NODE_ENV=development), l'éligibilité et le débit credits sont bypass.

Cycle de vie async

  1. run_page_audit renvoie { success: true, auditId, status: "PENDING" }.
  2. Pollez get_page_audit avec l'auditId. Tant que PENDING/GENERATING, la réponse est minimale.
  3. À COMPLETED, get_page_audit renvoie le summary complet et les modifications.
  4. À FAILED, get_page_audit renvoie un errorMessage.

Input

Champ Type Description
projectId string (CUID) Projet ciblé.
pageUrl string (URL) URL complète de la page à auditer. Doit être en https:// et publiquement accessible.

Response

Succès — audit queue

{
  "success": true,
  "auditId": "clx_rep_42",
  "status": "PENDING",
  "plan": "AGENCY",
  "mode": "credits",
  "creditsCharged": 100,
  "remainingCredits": 4900,
  "message": "Audit queued. Poll get_page_audit with this auditId to fetch results when status transitions to COMPLETED."
}

Tous les plans renvoient la même forme : mode: "credits" avec creditsCharged et remainingCredits.

Erreur — quota dépassé

{
  "success": false,
  "ok": false,
  "error": "quota_exceeded",
  "plan": "GROWTH",
  "reason": "insufficient_credits",
  "creditsRequired": 100,
  "remainingCredits": 40,
  "upgradeUrl": "/billing",
  "message": "Workspace does not have enough credits to run another page audit. Raise the monthly overage cap or wait for the next billing period."
}

reason est toujours insufficient_credits : le workspace n'a plus assez de credits ou est plafonné par son monthly overage cap. Augmentez monthlyOverageCapEuros ou attendez la période de facturation suivante.

Erreur — fetch échoué

{
  "success": false,
  "ok": false,
  "error": "fetch_failed",
  "message": "Could not fetch the page. The URL may be private, redirecting, or blocking crawlers."
}

Aucun credit n'est débité si la page ne peut pas être fetched.

Tips et patterns

  • Toujours check success d'abord, puis brancher sur error pour les cas structurés ci-dessus.
  • De-dup avant de queue. Appelez d'abord list_page_audits et skippez les URL qui ont déjà un audit COMPLETED récent.
  • Pollez, ne bloquez pas. Bouclez get_page_audit toutes les 10–20 secondes. Plus serré ne sert à rien — l'audit est borné par un appel LLM, pas par le polling.
  • Surfacez le coût à l'user. Sur tous les plans, creditsCharged et remainingCredits donnent à l'agent tout pour rendre une ligne "100 credits utilisés, 4 900 restants".

Tools liés