list_action_logs

list_action_logs retourne le journal d'actions du projet : la trace des optimisations réalisées (réécritures de pages, contenus publiés, outreach, corrections techniques). Chaque entrée porte un titre, une description optionnelle, le jour où l'action a été réalisée, et un indicateur source qui dit si elle a été loggée depuis l'app Mentionable ou par un agent IA via create_action_log.

Quand l'utiliser

Sortez-le dès que l'utilisateur demande "qu'est-ce qu'on a fait ce mois-ci ?" ou veut un rapport mensuel. Filtrez par plage de dates pour isoler exactement une période de facturation, puis combinez avec les stats de list_prompts pour montrer ce qui a été fait et ce que ça a changé. C'est aussi le bon tool pour une analyse avant/après : récupérez les actions des 60 derniers jours, comparez la visibilité entre la période avant et après chaque action, et attribuez les mouvements de mentions à du travail concret.

Paramètres

Champ	Type	Défaut	Description
projectId	string (CUID)	requis	Projet dont lire le journal.
cursor	string	aucun	Curseur de pagination d'un appel précédent (pageInfo.nextCursor).
limit	number	20	Taille de page, 1 à 100.
filters.from	string	aucun	Uniquement les actions réalisées ce jour ou après (YYYY-MM-DD).
filters.to	string	aucun	Uniquement les actions réalisées ce jour ou avant (YYYY-MM-DD).
sortBy	enum	recent	recent (plus récentes d'abord) ou oldest (chronologique).

Réponse

Shape paginé standard. date est le jour où l'action a été réalisée (antidatable par l'utilisateur), createdAt le moment où l'entrée a été écrite. source vaut app pour les entrées loggées manuellement dans le dashboard et mcp pour celles loggées par un agent IA.

{
  "data": [
    {
      "id": "clxaction001",
      "title": "Optimized /pricing page",
      "description": "Rewrote the H1, added FAQ schema markup, tightened the comparison table.",
      "date": "2026-05-12",
      "source": "app",
      "createdAt": "2026-05-12T10:00:00.000Z"
    },
    {
      "id": "clxaction002",
      "title": "Published comparison article vs Otterly",
      "description": null,
      "date": "2026-05-05",
      "source": "mcp",
      "createdAt": "2026-05-05T16:42:11.000Z"
    }
  ],
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": 2 },
  "summary": { "totalActions": 2 }
}

Astuces et patterns

• Rapport mensuel : un seul appel avec filters.from / filters.to sur le premier et le dernier jour du mois, sortBy: "oldest" pour un récit chronologique.
• Analyse d'impact : pour chaque action, interrogez list_prompts et comparez les taux de mention avant et après date. Le chart de performance du dashboard affiche les mêmes markers visuellement.
• Le journal est volontairement brut. Pas de scoring, pas de classification. L'agent qui le lit apporte son propre jugement sur les actions qui ont compté.
• Les entrées source: "mcp" ont été loggées par un agent. Si votre workflow réalise et logge des actions, dédupliquez sur titre + date avant de logger à nouveau.

Tools liés

• create_action_log — logger une nouvelle action après une optimisation.
• list_prompts — les statistiques de mentions à corréler avec les actions loggées.
• list_page_audits — les audits déjà lancés sur le projet, souvent l'action qui précède une réécriture de page.