Mentionable
Mentionable

list_competitors

Tool MCP list_competitors : concurrents trackés avec totaux de mentions, position moyenne, présence par LLM et couverture de prompts. Filtres status, source, mentions min.

Mis à jour le 2026-04-26

list_competitors

list_competitors retourne les concurrents trackés sur un projet, avec totaux de mentions, position moyenne, LLMs où ils sont mentionnés et nombre de prompts sur lesquels ils apparaissent. Trois statuts sont supportés : CONFIRMED, SUGGESTED (auto-détecté, en attente de modération), REJECTED.

Quand l'utiliser

Sortez ce tool quand l'utilisateur demande "contre qui je me bats dans les réponses IA ?", "qui prend de la visibilité sur mes prompts ?", "liste les nouveaux concurrents à modérer". Le filtre par défaut filters.status: ["CONFIRMED"] retourne les concurrents validés ; passez à ["SUGGESTED"] pour traiter la file d'auto-détection. Combinez avec bulk_update_competitor_status pour agir sur le résultat.

Paramètres

Champ Type Défaut Description
projectId string (CUID) requis Projet à interroger.
cursor string — Cursor de pagination.
limit integer 20 1 à 100.
filters.status enum[] ["CONFIRMED"] CONFIRMED, SUGGESTED, REJECTED.
filters.source string[] — Filtre par source de détection.
filters.minMentions integer 0 Mentions minimales totales.
filters.nameContains string — Match substring case-insensitive sur le nom canonique.
sortBy enum mentions_desc mentions_desc, recent, alphabetical.

Réponse

Chaque ligne est un concurrent avec ses aliases, son status, sa source et un bloc stats. Le summary.byStatus au niveau racine permet à l'agent de voir la file de modération sans second appel.

{
  "data": [
    {
      "id": "clxcomp001",
      "canonicalName": "Otterly",
      "aliases": ["Otterly.ai", "OtterlyAI"],
      "status": "CONFIRMED",
      "source": "auto-detected",
      "createdAt": "2026-02-15T00:00:00.000Z",
      "stats": {
        "totalMentions": 89,
        "averagePosition": 2.3,
        "llmsWhereMentioned": ["CHATGPT", "PERPLEXITY"],
        "promptCoverage": 12
      }
    }
  ],
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": 7 },
  "summary": {
    "totalCompetitors": 7,
    "byStatus": { "CONFIRMED": 7, "SUGGESTED": 12, "REJECTED": 3 }
  }
}

Conseils et patterns

  • Triez par mentions_desc pour de la veille concurrentielle ; triez par recent pour faire remonter les nouveaux entrants dans la file d'auto-détection.
  • averagePosition est calculée sur les runs où le concurrent était mentionné. Un faible totalMentions la rend bruitée.
  • promptCoverage est le nombre de prompts distincts où le concurrent apparaît. Croisez avec list_prompts pour voir lesquels se chevauchent avec votre couverture.
  • Tirez régulièrement filters.status: ["SUGGESTED"] et passez les IDs à bulk_update_competitor_status pour garder le dataset propre.

Tools liés