create_action_log

create_action_log écrit une nouvelle entrée dans le journal d'actions du projet. Appelez-le juste après avoir terminé un travail (optimiser une page, publier un article, corriger un schema markup) pour que l'action soit enregistrée avec sa date. Les actions loggées apparaissent dans la page Activity de l'app, en markers sur le chart de performance du dashboard, et dans tout rapport mensuel construit avec list_action_logs.

Quand l'utiliser

Utilisez-le comme dernière étape de tout workflow d'agent qui change quelque chose pour le projet. Boucle typique : run_page_audit sur une URL, application des modifications, puis create_action_log avec un titre comme "Optimized /pricing page from audit". Ça boucle le reporting : l'utilisateur (ou son client) voit ce qui a été fait et quand, et peut le corréler avec les mouvements de mentions sur le chart.

Exige le rôle member minimum. Le rôle customer est rejeté. Les entrées créées ici sont marquées source: "mcp" pour que l'app montre qu'elles ont été loggées par un agent IA.

Paramètres

Champ	Type	Défaut	Description
projectId	string (CUID)	requis	Projet sur lequel logger l'action.
title	string	requis	Libellé court de l'action, 1 à 200 caractères. Nommez la page ou l'asset touché.
description	string	aucun	Détail optionnel, jusqu'à 2000 caractères. Ce qui a été changé et pourquoi.
date	string	aujourd'hui	Jour où l'action a été réalisée (YYYY-MM-DD). Antidatable.

Réponse

Retourne l'entrée créée. date est le jour de l'action, createdAt l'horodatage d'écriture.

{
  "success": true,
  "actionLog": {
    "id": "clxaction003",
    "title": "Optimized /pricing page from audit",
    "description": "Applied 12 modifications from the page audit: H1 rewrite, FAQ schema, answer-first intro.",
    "date": "2026-06-03",
    "source": "mcp",
    "createdAt": "2026-06-03T14:21:08.000Z"
  }
}

Astuces et patterns

• Écrivez des titres qu'un client peut lire dans un rapport : "Optimized /pricing page" vaut mieux que "edits applied".
• Une entrée par action significative. Regroupez les micro-modifications d'une même page dans une seule entrée, avec le détail en description.
• Antidatez avec date quand vous loggez un travail réalisé plus tôt, pour que le marker tombe sur le bon jour du chart de performance.
• Vérifiez d'abord list_action_logs si votre workflow peut se relancer : il n'y a pas de déduplication intégrée.

Tools liés

• list_action_logs — relire le journal pour le reporting et l'analyse d'impact.
• run_page_audit — l'audit qui précède généralement l'optimisation que vous loggez.
• get_page_audit — les modifications appliquées, matière utile pour le champ description.