Mentionable
Mentionable

enrich_reddit_thread

Tool MCP enrich_reddit_thread : déclencher le scrape Bright Data d'un thread Reddit. Consomme 50 credits sur Agency ou un slot de quota mensuel sur Growth/Pro/Starter, idempotent sur les scrapes en cours, asynchrone (1-3 min).

Mis à jour le 2026-05-08

enrich_reddit_thread

enrich_reddit_thread déclenche un scrape Bright Data d'un thread Reddit pour récupérer le body, les top comments, les upvotes et la date du post dans la fiche du thread. Une fois le scrape posé, un appel suivant à get_reddit_thread (ou list_reddit_threads) renvoie le contenu complet pour que l'agent raisonne dessus. Mentionable ne renvoie pas de score de pertinence ni d'angle suggéré — l'agent qui appelle le MCP fait sa propre analyse.

Quand l'utiliser

Appelez-le quand list_reddit_threads retourne un thread en NEW et que votre agent décide qu'il mérite une lecture approfondie avant d'engager ou d'écarter. Boucle typique : lister les threads avec filters.status: ["NEW"], trier par score_desc, enrichir les N premiers, poller get_reddit_thread jusqu'à ENRICHED, puis lire content.postBody et content.topComments pour rédiger une réponse.

Exige le rôle member minimum. Le rôle customer est rejeté.

Limites par plan

L'enrichissement Reddit est gaté par plan. Deux modes de facturation cohabitent :

Plan Mode Allocation
Starter (legacy) Quota 2 enrichissements / mois
Growth Quota 4 enrichissements / mois
Pro Quota 16 enrichissements / mois
Agency Crédits Illimité, 50 crédits par enrichissement

Le quota mensuel compte chaque thread dont l'enrichissement s'est terminé (enrichedAt dans la période de facturation en cours) et chaque enrichissement en cours (status: "ENRICHING" déclenché ce mois-ci). Le compteur se réinitialise au renouvellement de la période de facturation du workspace.

Quand un workspace a dépassé son quota ou n'a plus assez de crédits, l'appel renvoie success: false avec un champ reason (voir les cas d'erreur ci-dessous) et aucun scrape n'est déclenché. Le check est bypassé en développement (NODE_ENV=development).

Idempotence

Si le thread est déjà en ENRICHING, l'appel est un no-op : il renvoie success: true, alreadyInProgress: true et ne re-débite pas (ni quota, ni crédits). C'est sûr de retry sur erreur transitoire. Si le thread est ENRICHED ou DELETED, l'appel re-débite et re-déclenche : appelez get_reddit_thread d'abord si vous voulez l'éviter.

Asynchrone

Le scrape est asynchrone et est typiquement posé en 1 à 3 minutes. Pollez get_reddit_thread avec un intervalle de 30 secondes jusqu'à status: "ENRICHED" (ou "DELETED" si le post est introuvable sur Reddit).

Paramètres

Champ Type Description
projectId string (CUID) Projet auquel le thread appartient.
redditPostId string (CUID) Thread à enrichir.

Réponse

Succès — plan à quota (Growth/Pro/Starter)

{
  "success": true,
  "alreadyInProgress": false,
  "thread": {
    "id": "clxred001",
    "url": "https://reddit.com/r/SEO/comments/abc123",
    "status": "ENRICHING"
  },
  "enrichment": {
    "mode": "quota",
    "quotaPerMonth": 4,
    "remainingThisMonth": 2
  },
  "message": "Enrichment started. Poll get_reddit_thread to watch for status: ENRICHED (typically 1-3 minutes)."
}

Succès — plan à crédits (Agency)

{
  "success": true,
  "alreadyInProgress": false,
  "thread": {
    "id": "clxred001",
    "url": "https://reddit.com/r/SEO/comments/abc123",
    "status": "ENRICHING"
  },
  "enrichment": {
    "mode": "credits",
    "charged": 50,
    "remaining": 1240
  },
  "message": "Enrichment started. Poll get_reddit_thread to watch for status: ENRICHED (typically 1-3 minutes)."
}

Succès — déjà en cours (pas de débit, ni quota ni crédits)

{
  "success": true,
  "alreadyInProgress": true,
  "thread": {
    "id": "clxred001",
    "url": "https://reddit.com/r/SEO/comments/abc123",
    "status": "ENRICHING"
  },
  "message": "Enrichment already in progress. Poll get_reddit_thread to watch for status: ENRICHED."
}

Erreur — quota atteint (Growth/Pro/Starter)

{
  "success": false,
  "error": "Reddit enrichment quota reached (4/mo). Upgrade your plan to enrich more.",
  "reason": "quota_reached",
  "plan": "GROWTH",
  "quotaPerMonth": 4,
  "enrichmentsThisPeriod": 4,
  "upgradeUrl": "/settings?tab=billing"
}

Erreur — crédits insuffisants (Agency)

{
  "success": false,
  "error": "Not enough credits (12 remaining, need 50). Raise your monthly overage cap or wait for the next renewal.",
  "reason": "insufficient_credits",
  "plan": "AGENCY",
  "credits": {
    "required": 50,
    "remaining": 12,
    "tier": "AGENCY"
  }
}

Erreur — feature désactivée

{
  "success": false,
  "error": "Reddit enrichment is not included in your plan. Upgrade to Growth or higher.",
  "reason": "disabled",
  "plan": "STARTER",
  "upgradeUrl": "/settings?tab=billing"
}

Erreur — thread introuvable ou cross-project

{
  "success": false,
  "error": "Reddit thread not found or does not belong to this project"
}

Conseils et patterns

  • Vérifiez success d'abord, puis alreadyInProgress pour savoir si vous avez consommé un slot de quota ou des crédits.
  • Inspectez enrichment.mode pour savoir si le workspace est sur un plan à quota ou paie en crédits — les agents sur Growth/Pro doivent respecter le petit budget mensuel et éviter de cramer les 4 à 16 enrichissements en un seul run.
  • Cappez votre boucle d'enrichissement. Cramer tout le budget mensuel sur des threads Reddit alors que l'utilisateur voulait de la recherche concurrentielle est un vrai mode de défaillance : posez une borne haute par run d'agent.
  • Après enrichissement, vérifiez content.isDeletedOnReddit. Les leads morts doivent être marqués SKIPPED via bulk_update_reddit_thread_status.
  • En développement, enrichment renvoie { mode: "dev_bypass" } pour que vous sachiez qu'aucun budget réel n'a été touché.
  • Le check de quota / crédits lit les mêmes compteurs que la feature in-app : une boucle d'enrichissement pilotée par MCP consomme du budget visible dans Settings → Billing.

Tools liés