Reddit Insights MCP
Semantic search across millions of Reddit posts. Unlike keyword search, this understands intent and meaning.
Ecommerce Seller Research Workflow (Deliverable)
Goal: produce a market research / pain-point opportunity report for ecommerce sellers.
1) Define scope
- Category seed(s): category / niche / use case (e.g., "under desk treadmill", "portable blender", "pet grooming")
- Target persona: who is buying/using (e.g., new parents, renters, office workers)
- Price band: low/mid/high (optional)
- Geography / constraints: US/EU, small apartment, travel, etc. (optional)
2) Tool decision flow
- If you already know what to search:
- Use
reddit_search
- Use
- If you need communities first:
- Use
reddit_list_subreddits→ pick 3-10 relevant subs - Then
reddit_get_subredditon 2-3 key subs to understand what’s being discussed
- Use
- If you need what’s hot right now:
- Use
reddit_get_trends→ convert trends intoreddit_searchqueries
- Use
3) Execute searches (batch)
- Run 6-15
reddit_searchqueries covering:- complaints / failures / returns
- comparisons / alternatives
- “best” / recommendations
- “worth it” / regret / buyer’s remorse
- gifts / seasonal intent
4) Filter + cluster
- Keep results where
relevance >= 0.60(0.55-0.59 only as supporting context) - Prioritize evidence with engagement signals:
- Upvotes and/or comments are non-trivial (relative to the subreddit)
- Cluster posts into themes:
- complaints about quality/durability
- usability/friction
- missing features/accessories
- sizing/fit/compatibility
- shipping/packaging/returns
- safety/health concerns
5) Produce the output document
- Use the formats below.
- Requirement:
- “原句” uses English with Chinese in parentheses.
- All other fields are Chinese.
Output Document Formats
机会点(Pain-point Opportunities)
| 场景+抱怨 | 设计机会点 | 原句(英文(中文)) | 帖子链接 |
|---|
Rules:
- “场景+抱怨” should be concrete (who/where/when + what went wrong).
- “设计机会点” should translate the complaint into a solution direction (not a full product spec).
- “原句” should be verbatim from the post/comment when possible.
趋势产品(Trending Products)
| 产品名称 | 说明(卖点) | 证据原句(英文(中文)) | 帖子链接 |
|---|
Rules:
- “产品名称” should be the common name used by users (include brand if repeatedly mentioned).
- “说明(卖点)” should be based on what users praise (time-saving, compact, durable, etc.).
- “证据原句” should be verbatim from the post/comment when possible, and should support the stated selling point.
- If a product has multiple evidence posts, put multiple links in the same “帖子链接” cell using line breaks (e.g.,
link1<br>link2<br>link3).
Ecommerce Query Playbook
Use natural-language queries a real shopper would write.
Category opportunity (complaints / gaps)
- "I hate my [product] because it keeps breaking"
- "[product] is so frustrating to use"
- "what do you wish [product] had"
- "returned my [product] because"
- "[product] alternatives that actually work"
- "problems with [product] for small apartment"
Buyer intent (recommendations / comparisons)
- "best [product] under $[X]"
- "[brand A] vs [brand B] which should I buy"
- "is [product] worth it"
- "buy it for my [persona]" (e.g., baby, dog, elderly parent)
Trend discovery (what’s being adopted)
- "what did you buy recently that you love"
- "products that actually improved my [routine]"
- "gift ideas for [persona] that people actually use"
Notes for Ecommerce Sellers
- Reddit evidence is strongest for:
- comparisons, switching stories, and candid complaints
- Be careful with:
- regulated categories (health claims, safety)
- one-off viral posts (validate across multiple posts/subreddits)
Setup
1. Get API Key (free tier available)
- Sign up at https://reddit-insights.com
- Go to Settings → API
- Copy your API key
2. Install MCP Server
For Claude Desktop - add to claude_desktop_config.json:
{
"mcpServers": {
"reddit-insights": {
"command": "npx",
"args": ["-y", "reddit-insights-mcp"],
"env": {
"REDDIT_INSIGHTS_API_KEY": "your_api_key_here"
}
}
}
}
For Clawdbot - add to config/mcporter.json:
{
"mcpServers": {
"reddit-insights": {
"command": "npx reddit-insights-mcp",
"env": {
"REDDIT_INSIGHTS_API_KEY": "your_api_key_here"
}
}
}
}
Verify installation:
mcporter list reddit-insights
Available Tools
| Tool | Purpose | Key Params |
|---|---|---|
reddit_search | Semantic search across posts | query (natural language), limit (1-100) |
reddit_list_subreddits | Browse available subreddits | page, limit, search |
reddit_get_subreddit | Get subreddit details + recent posts | subreddit (without r/) |
reddit_get_trends | Get trending topics | filter (latest/today/week/month), category |
Performance Notes
- Response time: 12-25 seconds (varies by query complexity)
- Simple queries: ~12-15s
- Complex semantic queries: ~17-20s
- Heavy load periods: up to 25s
- Best results: Specific products, emotional language, comparison questions
- Weaker results: Abstract concepts, non-English queries, generic business terms
- Sweet spot: Questions a real person would ask on Reddit
Best Use Cases (Tested)
| Use Case | Effectiveness | Why |
|---|---|---|
| Product comparisons (A vs B) | ⭐⭐⭐⭐⭐ | Reddit loves debates |
| Tool/app recommendations | ⭐⭐⭐⭐⭐ | High-intent discussions |
| Side hustle/money topics | ⭐⭐⭐⭐⭐ | Engaged communities |
| Pain point discovery | ⭐⭐⭐⭐ | Emotional posts rank well |
| Health questions | ⭐⭐⭐⭐ | Active health subreddits |
| Technical how-to | ⭐⭐⭐ | Better to search specific subreddits |
| Abstract market research | ⭐⭐ | Too vague for semantic search |
| Non-English queries | ⭐ | Reddit is English-dominant |
Query Strategies (Tested with Real Data)
✅ Excellent Queries (relevance 0.70+)
Product Comparisons (best results!):
"Notion vs Obsidian for note taking which one should I use"
→ Relevance: 0.72-0.81 | Found: Detailed comparison discussions, user experiences
"why I switched from Salesforce to HubSpot honest experience"
→ Relevance: 0.70-0.73 | Found: Migration stories, feature comparisons
Side Hustle/Money Topics:
"side hustle ideas that actually make money not scams"
→ Relevance: 0.70-0.77 | Found: Real experiences, specific suggestions
Niche App Research:
"daily horoscope apps which one is accurate and why"
→ Relevance: 0.67-0.72 | Found: App recommendations, feature requests
✅ Good Queries (relevance 0.60-0.69)
Pain Point Discovery:
"I hate my current CRM it is so frustrating"
→ Relevance: 0.60-0.64 | Found: Specific CRM complaints, feature wishlists
"cant sleep at night tried everything what actually works"
→ Relevance: 0.60-0.63 | Found: Sleep remedies discussions, medical advice seeking
Tool Evaluation:
"AI tools that actually save time not just hype"
→ Relevance: 0.64-0.65 | Found: Real productivity gains, tool recommendations
❌ Weak Queries (avoid these patterns)
Too Abstract:
"business opportunity growth potential"
→ Relevance: 0.52-0.58 | Returns unrelated generic posts
Non-English:
"学习编程最好的方法" (Chinese)
→ Relevance: 0.45-0.51 | Reddit is English-dominant, poor cross-lingual results
Query Formula Cheat Sheet
| Goal | Pattern | Relevance |
|---|---|---|
| Compare products | "[Product A] vs [Product B] which should I use" | 0.70-0.81 |
| Find switchers | "why I switched from [A] to [B]" | 0.70-0.73 |
| Money/hustle topics | "[topic] that actually [works/makes money] not [scam/hype]" | 0.70-0.77 |
| App recommendations | "[category] apps which one is [accurate/best] and why" | 0.67-0.72 |
| Pain points | "I hate my current [tool] it is so [frustrating/slow]" | 0.60-0.64 |
| Solutions seeking | "[problem] tried everything what actually works" | 0.60-0.63 |
Response Fields
Each result includes:
title,content- Post textsubreddit- Source communityupvotes,comments- Engagement metricsrelevance(0-1) - Semantic match score (0.5+ is good, 0.6+ is strong)sentiment- Discussion/Q&A/Story Sharing/Original Content/Newsurl- Direct Reddit link
Example response:
{
"id": "1oecf5e",
"title": "Trying to solve the productivity stack problem",
"content": "The perfect productivity app doesn't exist. No single app can do everything well, so we use a stack of apps. But this creates another problem: multi app fragmentation...",
"subreddit": "productivityapps",
"upvotes": 1,
"comments": 0,
"relevance": 0.631,
"sentiment": "Discussion",
"url": "https://reddit.com/r/productivityapps/comments/1oecf5e"
}
Tips
- Natural language works best - Ask questions like a human would
- Include context - "for small business" or "as a developer" improves results
- Combine emotion words - "frustrated", "love", "hate", "wish" find stronger opinions
- Filter by engagement - High upvotes/comments = validated pain points
- Check multiple subreddits - Same topic discussed differently in r/startups vs r/smallbusiness
Example Workflows
Find SaaS opportunity:
reddit_search: "frustrated with project management tools for remote teams"- Filter results with high engagement
- Identify recurring complaints → product opportunity
Validate idea:
reddit_search: "[your product category] recommendations"- See what alternatives people mention
- Note gaps in existing solutions
Content research:
reddit_get_subreddit: Get posts from target communityreddit_search: Find specific questions/discussions- Create content answering real user questions