# Reddit Marketing MCP Server

AI-powered Reddit marketing automation via Model Context Protocol (MCP).

Connect your AI assistant (Claude, Cursor, or any MCP client) to Reddit with intelligent analysis powered by DeepSeek AI.

## Features

- **Smart Search** — Search Reddit with engagement-sorted results
- **Audience Analysis** — AI-powered subreddit culture and demographic insights
- **Engagement Finder** — Discover natural opportunities to mention your product
- **Content Calendar** — Generate multi-day content plans tailored to each subreddit
- **Competitor Tracking** — Monitor and analyze competitor mentions
- **Comment Generator** — Draft authentic, non-spammy comments with subtle product mentions

## Tools Provided

| Tool | Description |
|------|-------------|
| `search_reddit` | Search posts by keyword across any subreddit |
| `get_hot_posts` | Get trending posts from a subreddit |
| `get_subreddit_info` | Get subscriber count, active users, description |
| `analyze_subreddit` | AI analysis of audience, culture, marketing opportunities |
| `find_engagement_opportunities` | Find posts where your product fits naturally |
| `analyze_opportunity` | Score a specific post's marketing potential (1-10) |
| `generate_content_calendar` | Create a content plan with mix of value + promo |
| `track_competitors` | Find and analyze competitor mentions |
| `generate_comment` | Draft authentic comments that mention your product |

## Quick Start

### 1. Get API Keys

**Reddit API (free):**
1. Go to https://www.reddit.com/prefs/apps
2. Click "create another app"
3. Choose "script" type
4. Set name and redirect URI (use `http://localhost`)
5. Copy your `client_id` and `client_secret`

**DeepSeek API (cheap):**
1. Go to https://platform.deepseek.com
2. Create an API key
3. Copy your key

### 2. Install

```bash
# Clone
git clone https://github.com/1036007003-wq/reddit-mcp-server.git
cd reddit-mcp-server

# Install with uv (recommended)
uv pip install -e .

# Or with pip
pip install -e .
```

### 3. Configure

```bash
cp .env.example .env
# Edit .env with your API keys
```

### 4. Connect to Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "reddit-marketing": {
      "command": "reddit-mcp-server",
      "env": {
        "REDDIT_CLIENT_ID": "your_id",
        "REDDIT_CLIENT_SECRET": "your_secret",
        "REDDIT_USER_AGENT": "reddit-mcp-server/1.0",
        "DEEPSEEK_API_KEY": "your_key"
      }
    }
  }
}
```

Restart Claude Desktop and you're ready!

### 5. Connect to Cursor

Add to `.cursor/mcp.json` in your project:

```json
{
  "mcpServers": {
    "reddit-marketing": {
      "command": "reddit-mcp-server",
      "env": {
        "REDDIT_CLIENT_ID": "your_id",
        "REDDIT_CLIENT_SECRET": "your_secret",
        "REDDIT_USER_AGENT": "reddit-mcp-server/1.0",
        "DEEPSEEK_API_KEY": "your_key"
      }
    }
  }
}
```

## Usage Examples

Ask your AI assistant:

- "Analyze r/Entrepreneur for marketing opportunities for my CRM tool"
- "Find Reddit posts where someone is asking about email marketing tools"
- "Track mentions of my competitor 'Notion' on Reddit"
- "Generate a 7-day content calendar for r/SaaS"
- "Find engagement opportunities for my productivity app in r/productivity"

## How It Works

```
User → MCP Client (Claude/Cursor) → MCP Server → Reddit API + DeepSeek AI
                                                         ↓
                                              Analysis & Content Generation
```

The server uses PRAW (Python Reddit API Wrapper) for Reddit data retrieval and DeepSeek's AI for intelligent analysis, content generation, and strategy recommendations.

## Tech Stack

- **MCP Protocol** — Anthropic's Model Context Protocol
- **PRAW** — Python Reddit API Wrapper
- **DeepSeek AI** — Cost-effective LLM for analysis (OpenAI-compatible API)
- **httpx** — Async HTTP client
- **Python 3.10+**

## Why DeepSeek instead of OpenAI?

DeepSeek API is **10-20x cheaper** than OpenAI GPT-4 while delivering comparable quality for analysis tasks. Perfect for high-volume Reddit monitoring.

## License

MIT — Use it, fork it, sell it. Just don't blame me.

## Sponsor

If this tool saves you time, consider [sponsoring on GitHub](https://github.com/sponsors/1036007003-wq).

---

Built for marketers who understand that Reddit rewards authenticity, not spam.