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
memberminimum. Le rôlecustomerest 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
successd'abord, puisalreadyInProgresspour savoir si vous avez consommé un slot de quota ou des crédits. - Inspectez
enrichment.modepour 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ésSKIPPEDviabulk_update_reddit_thread_status. - En développement,
enrichmentrenvoie{ 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
- list_reddit_threads : lister les candidats avec
filters.status: ["NEW"]. - get_reddit_thread : poller le statut d'enrichissement.
- bulk_update_reddit_thread_status : marquer le thread après le scrape (commenté, ignoré).