brianrwagner/ai-marketing-claude-code-skills4 files

Reddit Insights

|

Specification
Skill ID
brianrwagner/ai-marketing-claude-code-skills/reddit-insights
Publisher
brianrwagner
Repository
ai-marketing-claude-code-skills
Installs
0
Files
4
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

brianrwagner/ai-marketing-claude-code-skills/reddit-insightsInstalls these files
  • .clawdhub/origin.json
  • README.md
  • SKILL-OC.md
  • SKILL.md

What this skill tells the agent

Reddit Insights MCP

Semantic search across millions of Reddit posts. Unlike keyword search, this understands intent and meaning.

Mode

Detect from context or ask: "Quick pulse, full research, or strategic intelligence report?"

ModeWhat you getBest for
quick1 query, top 5 insights, no synthesisFast pain point check, content spark
standard3–5 queries, full synthesis with themes and patternsProduct validation, content research
deepMulti-angle research + sentiment analysis + content angles + competitive intelligenceBusiness decisions, campaign strategy

Default: `standard` — use quick for a fast read. Use deep if they're validating a product idea or building a content strategy.


Why This vs ChatGPT?

Problem with ChatGPT: It has no real-time Reddit access. It can't search current discussions, can't filter by engagement, and can't show you what people are saying RIGHT NOW about your topic.

This skill provides:

  1. Live semantic search - Searches millions of Reddit posts with AI-powered intent matching (not just keywords)
  2. Engagement filtering - Sort by upvotes/comments to find validated pain points
  3. Sentiment analysis - Automatically tags posts as Discussion/Q&A/Story/News
  4. Relevance scoring - Shows 0-1 match score so you know which results matter
  5. Subreddit intelligence - Browse communities, see trending topics, get recent posts
  6. Direct links - Every result includes Reddit URL for full context

You can replicate this by manually browsing Reddit, searching multiple subreddits, reading hundreds of posts, taking notes, and synthesizing patterns. Takes 1-2 hours per research query. This skill does it in 15-20 seconds.

Setup

1. Get API Key (free tier available)

  1. Sign up at https://reddit-insights.com
  2. Go to Settings → API
  3. 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

ToolPurposeKey Params
reddit_searchSemantic search across postsquery (natural language), limit (1-100)
reddit_list_subredditsBrowse available subredditspage, limit, search
reddit_get_subredditGet subreddit details + recent postssubreddit (without r/)
reddit_get_trendsGet trending topicsfilter (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 CaseEffectivenessWhy
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

GoalPatternRelevance
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 text
  • subreddit - Source community
  • upvotes, comments - Engagement metrics
  • relevance (0-1) - Semantic match score (0.5+ is good, 0.6+ is strong)
  • sentiment - Discussion/Q&A/Story Sharing/Original Content/News
  • url - 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"
}

Real Case Study

User: SaaS founder validating a new project management tool idea

Challenge: Needed to understand real frustrations with existing PM tools (Asana, Monday, ClickUp) to find positioning angle.

Research Query:

reddit_search("I hate my project management tool it's so frustrating for remote teams", limit=50)

What They Found (in 18 seconds):

  • 42 posts with 0.60+ relevance
  • Top pain points (mentioned 15+ times):
  • "Too complicated for simple projects"
  • "Mobile app is terrible"
  • "Hard to see the big picture"
  • "Notifications are overwhelming"
  • "Pricing jumps too fast with team size"

Most upvoted insight (+347 upvotes, r/startups):

"We switched from Monday to a Notion template because Monday felt like learning a new language just to assign a task. Sometimes simple beats powerful."

Positioning Decision: Built messaging around: "Project management that feels like a shared doc, not enterprise software."

Product Changes Made:

Use this skill in a project

Open any RiverX project, search the Skills panel for brianrwagner/ai-marketing-claude-code-skills/reddit-insights, and install it in one click.

Use this skill