🤖 Reddit MCP Server

An MCP (Model Context Protocol) server that provides Reddit scraping tools for AI agents. 🔓 No Reddit API key required.

🚀 What is this?

This is an Apify Actor that runs as an MCP server, exposing Reddit scraping capabilities to AI agents like Claude, GPT, and other MCP-compatible clients. It enables AI assistants to search, browse, and extract data from Reddit in real-time.

🛠️ Available Tools

Tool	Description
scrape_subreddit	Scrape posts from any subreddit with optional comments
scrape_user	Scrape posts from a Reddit user's profile
search_reddit	Search Reddit for posts matching a query
get_post_comments	Get comments from a specific post
get_subreddit_info	Get subreddit metadata (subscribers, description, etc.)

📊 Tool Details

scrape_subreddit

Scrape posts from a Reddit subreddit.

Parameters:

• subreddit (required): Subreddit name without r/ prefix (e.g., "python", "askreddit")
• limit: Maximum posts (1-100, default: 25)
• sort: Sort order - "hot", "new", "top", "rising" (default: "hot")
• timeframe: For "top" sort - "hour", "day", "week", "month", "year", "all"
• include_comments: Fetch comments for each post (default: false)

scrape_user

Scrape posts from a Reddit user's profile.

Parameters:

• username (required): Reddit username without u/ prefix
• limit: Maximum posts (1-100, default: 25)
• sort: Sort order - "hot", "new", "top" (default: "new")
• timeframe: For "top" sort - "hour", "day", "week", "month", "year", "all"

search_reddit

Search Reddit for posts matching a query.

Parameters:

• query (required): Search query
• subreddit: Limit search to specific subreddit (optional)
• limit: Maximum results (1-100, default: 25)
• sort: "relevance", "hot", "top", "new", "comments" (default: "relevance")
• timeframe: "hour", "day", "week", "month", "year", "all"

get_post_comments

Get comments from a specific Reddit post.

Parameters:

• post_url (required): Full Reddit post URL or post ID
• limit: Maximum comments (1-200, default: 50)

get_subreddit_info

Get metadata about a subreddit.

Parameters:

• subreddit (required): Subreddit name without r/ prefix

💡 Use Cases

• 🔍 Research - AI agents can search and analyze Reddit discussions
• 📊 Trend Analysis - Monitor trending topics in specific communities
• 💬 Sentiment Analysis - Gather opinions and feedback from Reddit
• 📰 Content Discovery - Find relevant posts and discussions
• 🤖 Automated Monitoring - Track brand mentions and keywords

🔧 Configuration

Input Parameters

Parameter	Type	Description
proxy	object	Proxy configuration (RESIDENTIAL recommended for Reddit)

Proxy Configuration

Reddit blocks most datacenter IPs. For reliable access, enable Apify Proxy:

{
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

🚀 How to Use

With Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-shell",
        "https://actors-mcp-server.apify.actor",
        "--actors", "abotapi/reddit-mcp-server"
      ]
    }
  }
}

With Apify MCP Client

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
actor = client.actor("abotapi/reddit-mcp-server")

# Start in standby mode
run = actor.start(run_input={}, wait_for_finish=False)

📤 Output Examples

Post Output

{
  "id": "1hj2abc",
  "title": "What's your favorite Python library?",
  "author": "pythonista123",
  "subreddit": "python",
  "created_utc": "2024-12-20T15:30:00",
  "permalink": "https://reddit.com/r/python/comments/1hj2abc/...",
  "score": 1542,
  "num_comments": 234,
  "selftext": "I've been exploring different libraries...",
  "post_type": "text",
  "media_urls": {
    "images": [],
    "videos": [],
    "galleries": []
  }
}

Comment Output

{
  "id": "kx7y9z",
  "author": "dev_guru",
  "body": "Pandas is absolutely essential for data work.",
  "score": 89,
  "created_utc": "2024-12-20T16:45:00",
  "depth": 0
}

✅ Features

Feature	Supported
🏠 Subreddit scraping	✅
👤 User profile scraping	✅
🔍 Reddit search	✅
💬 Comments extraction	✅
📊 Subreddit metadata	✅
🖼️ Media URL extraction	✅
🌐 Proxy support	✅
🔓 No API key needed	✅
⚡ MCP Protocol	✅

⚠️ Limitations

• 🚦 Reddit rate limits apply (~100 requests per minute)
• 🔒 Private subreddits not accessible
• 📜 Limited to publicly available content
• 📊 Results limited to 100 items per request