Reddit Scraper MCP Server

An MCP (Model Context Protocol) server that scrapes Reddit posts and comments using Cheerio (lightweight HTTP scraping, no Puppeteer/Playwright needed). Scrapes old.reddit.com for reliable, fast data extraction.

Tools

1. search_reddit

Search Reddit posts by keyword.

Parameters:

Name	Type	Required	Description
query	string	✅	Search query/keyword
limit	number	❌	Max results (default: 25, max: 100)

Example:

{
  "query": "typescript programming",
  "limit": 10
}

2. get_subreddit_posts

Get posts from a subreddit with optional sorting.

Parameters:

Name	Type	Required	Description
subreddit	string	✅	Subreddit name (without r/)
sort	string	❌	Sort: hot, top, new, or rising (default: hot)
limit	number	❌	Max results (default: 25, max: 100)

Example:

{
  "subreddit": "node",
  "sort": "top",
  "limit": 10
}

3. get_post_comments

Get top comments from a Reddit post.

Parameters:

Name	Type	Required	Description
post_url	string	✅	Full Reddit post URL (any format: www, old, new.reddit.com)
limit	number	❌	Max comments (default: 25, max: 100)

Example:

{
  "post_url": "https://www.reddit.com/r/typescript/comments/1abcd/example_post/",
  "limit": 10
}

Usage

Claude Desktop / MCP Client

Add to your MCP client configuration:

{
  "mcpServers": {
    "reddit-scraper": {
      "command": "node",
      "args": ["/path/to/mcp-reddit-scraper/build/index.js"]
    }
  }
}

Direct command line

$node build/index.js

The server communicates over stdio (JSON-RPC). The Express HTTP server on port 3000 provides health check and tool listing endpoints:

• GET /health — Health check
• GET /tools — List available tools

Example Response (search_reddit)

[
  {
    "title": "TypeScript 5.7 Released",
    "url": "https://dev.to/example/typescript-5-7",
    "permalink": "https://old.reddit.com/r/typescript/comments/abc123/",
    "subreddit": "typescript",
    "score": 342,
    "comments": 87,
    "author": "example_user",
    "domain": "dev.to",
    "created": "2024-01-15T10:30:00+00:00"
  }
]

Development

# Install dependencies
npm install

# Build
npm run build

# Run
npm start

Deploy to Apify

# Login
apify login

# Push to Apify
apify push

How It Works

• Scrapes old.reddit.com (lighter, no JavaScript rendering)
• Uses cheerio for HTML parsing (fast, no browser needed)
• No API keys required — works with Reddit's public HTML interface
• Respects rate limits with a reasonable User-Agent header

License

MIT