run_page_fix

run_page_fix liste tout ce qu'il faut corriger sur une page du site pour que Google et les IA puissent la lire. Il ne réécrit pas la page. Il vérifie ce qui se dresse entre la page et une citation, puis renvoie une liste de points à corriger, triée par gravité :

• Indexation : code HTTP, noindex (en-tête X-Robots-Tag compris), canonical, sitemap, hreflang.
• Accès des robots IA : robots.txt sur le chemin exact pour chaque robot de réponse, un test en direct en robot de recherche IA pour repérer un pare-feu qui le refuse, et le contenu qui disparaît sans JavaScript.
• Structure et données structurées : le type JSON-LD attendu pour ce genre de page, ses champs requis et leur cohérence avec ce que voit le visiteur. Les blocs manquants reviennent prêts à coller, dont un BreadcrumbList construit à partir des pages parentes et un FAQPage construit à partir des questions visibles sur la page.
• Liens internes : les pages qui pointent vers celle-ci, et les pages proches qui devraient le faire.
• Doublons et cannibalisation : les autres pages du site qui visent les mêmes prompts.
• Fraîcheur : date de mise à jour et contenu ancien, sur les pages éditoriales seulement.
• Ce qu'une IA comprend de la page : qui, quoi, pour qui, où. Plus les faits que votre projet affirme et que la page ne dit pas (zone desservie, prix, public, horaires), et les sujets que les IA cherchent sur les prompts liés et que la page ne couvre pas. Ces sujets viennent des fan-out queries que Mentionable a déjà collectées : aucune extraction n'est lancée.

Le tool renvoie tout de suite un fixId. Le travail tourne en asynchrone, en général en moins d'une minute : interrogez get_page_fix avec la même pageUrl jusqu'à ce que status vaille COMPLETED.

Rôle member minimum. Le rôle customer est refusé. Le MCP est disponible sur les plans Pro et Agency.

Quand l'utiliser

Utilisez-le sur une page que les IA ouvrent sans la citer, avant de réécrire quoi que ce soit : une page bloquée par robots.txt ou par un pare-feu ne sera jamais citée, aussi bon que soit son texte. get_recommendation renvoie ces pages sous forme d'étapes de kind fix, avec tool: "run_page_fix". Relancez-le après le crawl suivant, une fois les changements mis en ligne par le développeur, pour vérifier que la liste a raccourci.

Crédits et limites

Un correctif de page ne coûte aucun crédit, dans toutes les formules et sur toutes les pages du dernier crawl du site. Il n'y a pas de quota mensuel : lancez-le sur autant de pages que nécessaire.

Une page reçoit un correctif par crawl du site. Si un correctif tourne déjà sur la page, ou s'il est déjà fait sur le dernier crawl, le tool renvoie celui-là au lieu d'en lancer un autre. Le crawl suivant rouvre la page, et un nouvel appel la revérifie alors.

La page doit faire partie du dernier crawl du site. L'URL est rapprochée de celle crawlée : http:// au lieu de https://, un slash final en trop ou en moins et des paramètres utm_ sont tolérés.

Input

Réponse

{
  "success": true,
  "fixId": "cmg8k2x1p0004l70f9d3h2a1b",
  "pageUrl": "https://example.com/services/seo-audit",
  "message": "Fix queued, or already done on the latest crawl. Poll get_page_fix with this pageUrl until status is COMPLETED (typically under a minute)."
}

pageUrl est l'URL telle que crawlée, qui peut différer de celle passée. Utilisez-la pour les appels suivants. fixId est le nouveau correctif, ou celui qui tourne déjà ou qui est déjà fait sur le dernier crawl : get_page_fix le dit par son status.

Erreurs

Les erreurs métier reviennent avec success: false, un code machine dans error et un message :

{
  "success": false,
  "error": "page_not_crawled",
  "message": "This page is not in the latest site crawl."
}

Les erreurs d'accès sont levées comme sur tous les autres tools : Project not found quand le projet n'est pas dans votre workspace ou votre périmètre de membre, Project not in API key scope quand la clé est restreinte à d'autres projets, et un refus pour le rôle customer.

Conseils et patterns

• Partez du plan. Appelez get_recommendation sur un prompt et lancez le correctif sur l'url de son étape fix. Ce sont les citations les moins chères à gagner.
• Interrogez, ne bloquez pas. Appelez get_page_fix toutes les 15 secondes. La plupart des correctifs finissent en moins d'une minute.
• Pas besoin de demander. Le correctif est gratuit : lancez-le sur chaque page du plan sans attendre l'accord de l'utilisateur.
• Bouclez la boucle. Une fois les changements en ligne, loggez-les avec create_action_log pour voir leur effet sur le graphique du dashboard, puis relancez le correctif après le crawl suivant.

Tools liés

• get_page_fix : lire le résultat.
• get_recommendation : le plan d'un prompt, dont les étapes fix renvoient ici.
• get_ai_crawler_page : vérifier que les robots IA passent vraiment sur la page.
• create_action_log : logger les corrections une fois en ligne.