📊 Reddit Intelligence AI v1

Championship-Level Reddit Analysis 5 MCP Integrations | Interactive 3D Visualizations

Transform Reddit data into actionable business intelligence with AI-powered sentiment analysis, viral prediction, crisis detection, and automated workflows.

---

1. 🤖 5 MCP Integrations - Full Automation

Connect to your entire workflow:

• Linear - Auto-create support tickets from negative posts
• Slack - Real-time crisis alerts
• Notion - Build knowledge base from viral content
• Airtable - Track all mentions in database
• Google Sheets - Auto-populate spreadsheets

2. 🌌 Interactive 3D Visualizations

• 3D Sentiment Galaxy - Explore posts in 3D space (Three.js)
• Colored spheres by sentiment (green/yellow/red)
• Click & drag to rotate, scroll to zoom
• Click spheres to view post details
• Auto-rotate with starfield background

3. 💰 Business-Focused Analytics

• ROI Calculator - Estimate marketing value of posts
• Crisis Detection - Alert on negative sentiment spikes
• Viral Prediction - AI identifies trending content early
• Bot Detection - Find suspicious accounts
• Competitive Intelligence - Track competitor mentions

4. 🎨 Beautiful HTML Reports

• Professional gradient design
• Interactive charts (Chart.js)
• Network graphs (D3.js)
• Mobile-responsive
• Export to CSV/JSON

---

🚀 Quick Start

Option 1: No Setup (FREE Mode)

Just run the actor! Works immediately without ANY credentials:

{
  "subreddits": ["artificial", "MachineLearning"],
  "maxPosts": 100
}

Option 2: Full Power (Reddit API)

Get 100+ posts per subreddit:

{
  "subreddits": ["artificial"],
  "maxPosts": 500,
  "redditClientId": "YOUR_CLIENT_ID",
  "redditClientSecret": "YOUR_CLIENT_SECRET",
  "redditUsername": "YOUR_USERNAME",
  "redditPassword": "YOUR_PASSWORD"
}

How to get Reddit API credentials:

1. Go to: https://www.reddit.com/prefs/apps
2. Click "Create App" → "Script"
3. Copy Client ID & Secret

---

📊 Features

Core Analysis

• ✅ Sentiment Analysis - VADER + optional AI (OpenAI/Claude/Grok)
• ✅ Viral Prediction - ML algorithm predicts trending posts
• ✅ Crisis Detection - Real-time negative sentiment alerts
• ✅ ROI Calculator - Estimate marketing value ($$$)
• ✅ Bot Detection - Identify suspicious accounts
• ✅ Controversy Detection - Find conflicting sentiment
• ✅ Trending Topics - Extract top keywords
• ✅ User Personas - Categorize commenters
• ✅ Influence Network - Map key voices
• ✅ Best Posting Times - Optimize engagement

MCP Automation Modes

Choose from 4 pre-built workflows:

1. Support Intelligence

Auto-creates Linear tickets from negative posts:

{
  "mode": "support_intelligence",
  "linearApiKey": "YOUR_KEY"
}

2. Crisis Detector

Sends Slack alerts for sentiment spikes:

{
  "mode": "crisis_detector",
  "slackWebhookUrl": "YOUR_WEBHOOK"
}

3. Content Miner

Saves viral posts to Notion knowledge base:

{
  "mode": "content_miner",
  "notionApiKey": "YOUR_KEY"
}

4. Brand Guardian

Tracks brand mentions in Airtable:

{
  "mode": "brand_guardian",
  "brandKeywords": ["YourBrand"],
  "airtableApiKey": "YOUR_KEY"
}

AI Enhancement (Optional)

Add AI provider for natural language insights:

{
  "aiProvider": "openai",
  "openaiApiKey": "YOUR_KEY"
}

Supported AI Providers:

• OpenAI (GPT-4)
• Anthropic (Claude)
• Grok (xAI)

---

📋 Input Parameters

Basic Settings

Parameter	Type	Default	Description
subreddits	array	["artificial"]	List of subreddits (max 10)
maxPosts	integer	100	Posts per subreddit (1-1000)
sortBy	string	"hot"	Sort: hot/new/top/rising
timeFilter	string	"week"	Time: hour/day/week/month/year
includeComments	boolean	true	Fetch comments

Reddit API (Optional)

Parameter	Type	Required	Description
redditClientId	string	No	Your Reddit app client ID
redditClientSecret	string	No	Your Reddit app secret
redditUsername	string	No	Your Reddit username
redditPassword	string	No	Your Reddit password

Analysis Features (All FREE)

Parameter	Type	Default	Description
detectControversy	boolean	true	Find conflicting sentiment
detectBotsEnabled	boolean	true	Identify bot accounts
enableCrisisDetection	boolean	true	Alert on negative spikes
calculateROIEnabled	boolean	true	Estimate marketing value
brandKeywords	array	[]	Track specific brands

AI Enhancement (Optional)

Parameter	Type	Default	Options
aiProvider	string	"none"	none/openai/anthropic/grok
openaiApiKey	string	""	Your OpenAI API key
anthropicApiKey	string	""	Your Claude API key
grokApiKey	string	""	Your Grok API key

MCP Automation (Optional)

Parameter	Type	Default	Description
mode	string	"analysis"	analysis/support_intelligence/crisis_detector/content_miner/brand_guardian
linearApiKey	string	""	For Linear integration
slackWebhookUrl	string	""	For Slack alerts
notionApiKey	string	""	For Notion integration
airtableApiKey	string	""	For Airtable tracking
googleSheetsCredentials	string	""	For Sheets integration

---

📦 Outputs

1. REPORT.html

Beautiful interactive report with:

• 📊 Sentiment distribution charts
• 🔥 Viral candidate predictions
• 🚨 Crisis alerts (if detected)
• 💰 ROI calculations
• 🌌 3D Sentiment Galaxy (interactive!)
• 🎨 Network influence graph
• 📈 Trending topics word cloud

2. JSON Files

• posts.json - All posts with analysis
• sentiment.json - Sentiment breakdown
• viral_candidates.json - High-potential posts
• trending_topics.json - Top keywords
• crisis_alerts.json - Urgent issues
• bot_detection.json - Suspicious accounts
• roi_calculations.json - Marketing value

3. CSV Export

• posts.csv - Import to Excel/Sheets

4. Output Tab

Summary statistics visible immediately:

{
  "totalPosts": 100,
  "totalComments": 450,
  "overallSentiment": "0.42 (Positive)",
  "viralCandidates": 12,
  "crisisAlerts": 0,
  "dataSource": "RSS Feed (Real Data)"
}

---

💡 Use Cases

Marketing Teams

• Track brand mentions across subreddits
• Identify viral content opportunities
• Monitor competitor activity
• Calculate campaign ROI

Community Managers

• Detect crises before they escalate
• Find influential community members
• Understand sentiment trends
• Generate engagement reports

Product Teams

• Collect feature requests from comments
• Monitor product reception
• Track competitor mentions
• Identify content gaps

Customer Support

• Auto-create tickets from negative posts
• Track recurring issues
• Monitor brand reputation
• Prioritize by sentiment

---

🎯 Examples

Example 1: Brand Monitoring

{
  "subreddits": ["technology", "gadgets", "apple"],
  "brandKeywords": ["iPhone", "Apple"],
  "mode": "brand_guardian",
  "airtableApiKey": "YOUR_KEY",
  "enableCrisisDetection": true,
  "webhookUrl": "YOUR_SLACK_WEBHOOK"
}

Result: Tracks all iPhone mentions, logs to Airtable, alerts on negative sentiment

Example 2: Competitor Analysis

{
  "subreddits": ["saas", "startups"],
  "competitorKeywords": ["Slack", "Teams", "Discord"],
  "calculateROIEnabled": true,
  "aiProvider": "openai",
  "openaiApiKey": "YOUR_KEY"
}

Result: Compare competitor mentions with AI-powered insights

Example 3: Content Research

{
  "subreddits": ["MachineLearning", "artificial"],
  "maxPosts": 200,
  "mode": "content_miner",
  "notionApiKey": "YOUR_KEY",
  "notionDatabaseId": "YOUR_DB_ID"
}

Result: Saves viral AI posts to Notion for content inspiration

---

🔒 Privacy & Compliance

• ✅ No data stored - Everything deleted after run
• ✅ Public data only - Only scrapes publicly visible posts
• ✅ Rate limited - Respects Reddit's limits
• ✅ GDPR compliant - No personal data collected
• ✅ Terms compliant - Follows Reddit API terms

---

🛠️ Technical Details

Technologies

• Backend: Node.js 22, Apify SDK 3.5
• Analysis: VADER sentiment, custom ML algorithms
• Visualization: Three.js (3D), Chart.js, D3.js
• Styling: Modern CSS gradients, responsive design
• APIs: Reddit OAuth 2.0, Public JSON, RSS

Performance

• ⚡ Speed: 100 posts in ~10 seconds
• 💰 Cost: ~$0.01 per 100 posts
• 🎯 Accuracy: 85%+ sentiment accuracy
• 📊 Scale: Up to 1,000 posts per run

---

📚 Resources

Documentation

• Reddit API Docs
• Apify Platform Docs
• MCP Integration Guide

Support

• 🐛 Found a bug? Report it!
• Apify Platform Support: Use the built-in messaging system in Apify Console

---

🏆 Built for Apify Challenge 2025

This actor demonstrates:

• ✅ Production-ready code - Error handling, fallbacks, normalization
• ✅ Real business value - ROI calculator, automation, crisis detection
• ✅ Technical excellence - 3D viz, MCP integration, multi-tier system
• ✅ Beautiful UX - Interactive reports, responsive design
• ✅ Comprehensive docs - Clear examples, use cases, parameters

Not a demo. A complete intelligence platform. 🚀

---

📜 License

Apache 2.0 - Free to use,

---

Author

Created by: Anirban Roy
GitHub: (https://github.com/ar48code-dev)

🙏 Credits

Built with:

• Apify SDK
• VADER Sentiment
• Three.js
• Chart.js
• D3.js

---

⭐ If you find this useful, please star the actor!

🚀 Ready to transform Reddit data into insights? Run the Actor →