reddit-scraper-mcp
You can search, scrape, and bulk-collect Reddit content as structured JSON using three MCP tools without a Reddit API key or login.
search_reddit: Run keyword searches across Reddit or one subreddit with sorting, time windows, date ranges, NSFW control, and optional matching comments or full comment threads.scrape_reddit_urls: Scrape specific Reddit post permalinks, user profiles, subreddit listing URLs, or search-result pages, returning posts, comments, users, or communities.scrape_subreddit: Bulk-pull posts from one or more subreddits, optionally date-bounded and optionally with comment threads.Use filters like
maxPosts,maxCommentsPerPost,postedAfter,postedBefore, andincludeNsfwto control result size and scope.Get structured rows with fields such as
dataType,title,body,postUrl,communityName,authorName,score,commentsCount,createdAt, andflair.
Provides tools for searching Reddit by keyword, scraping post URLs with full comment threads, and bulk pulling posts from subreddits as structured JSON.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@reddit-scraper-mcp search Reddit for recent mentions of 'OpenAI' and include comments"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Reddit Scraper MCP server
MCP server for the Reddit Scraper Apify Actor. Gives Claude, Cursor, Codex, Windsurf, ChatGPT and any other MCP client three tools for Reddit as structured JSON: keyword search, URL scraping with full comment threads, and bulk subreddit pulls. No Reddit API key, no login. Billed per result on Apify ($2 per 1,000 results, less with Apify plan discounts; the free plan covers small runs).
Reddit API and RSS shutdown. Reddit stops accepting new API access requests on 2026-10-31. Reddit RSS feeds stop on 2026-11-13. This server does not use a Reddit API key, a Reddit app or RSS, so neither date changes your setup.
Two ways to connect. Both need an Apify token. No Apify account yet? Sign up free, then copy the token from https://console.apify.com/account/integrations.
Option A — remote (nothing to install)
Apify hosts the Actor as an MCP tool:
{
"mcpServers": {
"reddit-scraper": {
"url": "https://mcp.apify.com/?tools=harshmaur/reddit-scraper",
"headers": { "Authorization": "Bearer <APIFY_TOKEN>" }
}
}
}Stdio-only clients can bridge with npx mcp-remote https://mcp.apify.com/?tools=harshmaur/reddit-scraper. This is the endpoint registered in the official MCP Registry as io.github.harshmaur/reddit-scraper.
Related MCP server: reddit-search
Option B — local stdio server (this repo)
Purpose-built tools with typed arguments, so the model fills in queries, subreddit, postedAfter instead of a raw Actor input object.
{
"mcpServers": {
"reddit-scraper": {
"command": "npx",
"args": ["-y", "reddit-scraper-mcp"],
"env": { "APIFY_TOKEN": "<APIFY_TOKEN>" }
}
}
}Published on npm as reddit-scraper-mcp. Or clone and run node index.js. Node 20+.
Tool | Use it for |
| Keyword search across Reddit or one subreddit; sort, time window, date range; matching comments and post threads on by default. Brand monitoring, lead discovery, "what is Reddit saying about X". |
| Post permalinks (with the full thread), |
| Bulk posts from one or more subreddits, optionally date-bounded; comment threads on by default. |
Environment:
Variable | Default | Meaning |
| required | Apify API token |
|
| Set to |
|
| Seconds to wait for a run |
Every item carries dataType (post, comment, community, user_profile); posts include title, body, postUrl, communityName, authorName, score, commentsCount, createdAt, flair. Field reference: https://apify.com/harshmaur/reddit-scraper#output-example
Automation templates
templates/n8n/— importable n8n workflows: Reddit mentions → Slack, Reddit lead alerts → Google Sheets.templates/make/— Make scenario recipe for Slack, Notion or Sheets.Published n8n templates: new subreddit posts to Slack, Reddit keyword mentions to Slack and Gmail.
Published Make templates: daily Reddit keyword alerts to Slack, AI lead scoring to Slack.
The Actor can also deliver results itself (Slack, Notion, Airtable, Sheets) through its mcpConnector input, with an Apify Schedule as the trigger, if you prefer no middleware.
Files
index.js— the stdio serverserver.json— official MCP Registry manifest for Pro;server-reddit-scraper.json— same for the flagshipDockerfile,glama.json— for directory indexers
MIT. Built by Harsh Maur.
Available Tools
3 toolsscrape_reddit_urlsScrape Reddit URLsAInspect
Scrape specific Reddit URLs: post permalinks (optionally with the full comment thread), user profile URLs (/user// returns the user's posts and comments), subreddit listing URLs (/r//new/, /r//top/?t=week) or Reddit search-result page URLs. Returns structured JSON rows with a dataType of post, comment, user or community.
Inputs: urls (required), maxPosts, includeNsfw, maxCommentsPerPost, +1 more.
scrape_subredditScrape a subreddit in bulkBInspect
Pull posts from one or more subreddits in bulk (far more than a single listing page), optionally limited to a date window and optionally with each post's comments. Use for building a dataset of a community, trend analysis, or 'what has r/X been discussing since '. Subreddit names only, not post links.
Inputs: subreddits (required), maxPosts, includeNsfw, postedAfter, +3 more.
search_redditSearch RedditAInspect
Keyword search across Reddit (or inside one subreddit) and return matching posts as structured JSON: title, body, postUrl, communityName, authorName, score, commentsCount, createdAt. Use for brand monitoring, lead generation, market research, 'what is Reddit saying about X'. Search is literal keyword matching, so pass short terms (several are fine) rather than sentences.
Inputs: queries (required), sort, time, maxPosts, +7 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools have largely distinct purposes: keyword search, arbitrary URL scraping, and bulk subreddit harvesting. There is some overlap because scrape_reddit_urls accepts subreddit listing and search-result URLs, but the descriptions clarify the use cases well enough.
Two tools use the clear verb_noun pattern scrape_*, while the third uses search_reddit instead of a scrape_* variant. This is a minor deviation rather than a real inconsistency, and all names are readable and predictable.
Three tools is appropriately scoped for a Reddit scraper: keyword search, general URL scraping, and bulk subreddit collection each cover a distinct scraping need without bloat or redundancy.
The toolset covers the main Reddit scraping workflows: searching by keywords, scraping arbitrary post/user/subreddit/search URLs, and bulk-collecting subreddit data with optional comments. No obvious dead ends or critical missing operations are apparent.
Related MCP Connectors
Reddit posts, comments, keyword search and historical archives as tools. Runs on Apify.
Reddit MCP server: search posts, subreddit feeds, comments & user profiles as JSON. No API key.
Real-time Reddit posts, subreddit search, comments & mentions MCP. Local npx or hosted OAuth.
Find high-intent Reddit conversations and manage lead workflows from MCP-compatible AI agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI agents to search Reddit for posts, comments, and users or monitor for high-intent leads and brand mentions. It functions by delegating scraping tasks to high-performance Apify cloud actors.269 npm7MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching Reddit posts, fetching subreddit content, and retrieving post comments without requiring an API key. It uses public JSON endpoints to provide seamless access to Reddit data for LLM-based applications.3 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to research customer voice by searching Reddit and extracting structured comments from supported community platforms via MCP.MIT
- AlicenseNot gradedqualityDmaintenanceEnables MCP clients to scan, search, and read Reddit posts and comments using Reddit's public JSON endpoints, with no API credentials required.32 npmMIT