enrich_reddit_thread

Tool MCP enrich_reddit_thread : déclencher le scrape Bright Data d'un thread Reddit. Débite 50 credits par enrichissement sur tous les plans, idempotent sur les scrapes en cours, asynchrone (1-3 min).

Mis à jour le 2026-05-08

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é.

Billing

Tous les plans sont credit-based. enrich_reddit_thread débite 50 crédits par enrichissement sur Growth, Pro et Agency, prélevés sur le pool de crédits mensuel du workspace (Growth 1 500, Pro 3 000, Agency 5 000 crédits par mois). Au-delà des crédits inclus, l'overage est facturé 0,02 € par crédit, plafonné par le monthly overage cap configurable du workspace.

Quand un workspace n'a plus assez de crédits ou est plafonné par son overage cap, l'appel renvoie success: false avec reason: "insufficient_credits" (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 de 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: enrichissement démarré

{
  "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)

{
  "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: crédits insuffisants

Le workspace n'a plus assez de crédits ou est plafonné par son monthly overage cap. reason est toujours insufficient_credits, sur tous les plans.

{
  "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": "GROWTH",
  "credits": {
    "required": 50,
    "remaining": 12,
    "tier": "GROWTH"
  }
}

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é des crédits.
  • Tous les plans paient en crédits (50 par enrichissement). Les agents doivent respecter le pool de crédits mensuel du workspace et éviter de le cramer sur des threads Reddit en un seul run.
  • Cappez votre boucle d'enrichissement. Cramer tout le pool de crédits 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 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