Reddit Search and Thread Scraper MCP Server
A single read-only MCP tool, search_reddit, that searches Reddit and scrapes posts and comments through an Apify actor (Arctic Shift archive plus Reddit's embed page), and returns flat rows of results.
Keyword search inside chosen subreddits (Arctic Shift), or across all of Reddit with your own Serper or Brave key (
search_api_key).Read the newest posts of one or more subreddits when no search term is given.
Read thread URLs (up to 200) together with their top comments.
Filter and shape results:
time_window,since_days,require_term_match,sort,subreddit_sort,max_posts_per_query(up to 1,000).Optionally pull comments for every post found (
include_comments,max_comments_per_threadup to 500,comment_depth1–10).Choose the route (
arctic_shift,search_key,both) with automatic fallback, noted per row indata_route.Refresh each post's current title, score, and comment count from Reddit's public embed page (
read_current_state).Return one flat row per post/comment plus one free summary row per query.
Skip already-seen results with
only_newand astate_key.Cap run cost with
max_charge_usd; requiresAPIFY_TOKENand is billed per post and comment row.
Searches Reddit by keyword across all of Reddit or within specified subreddits, reads subreddit feeds (new, hot, top, rising), and scrapes thread URLs with their comments. Supports sorting, time-window and date filtering, term-match filtering, pagination limits, comment depth limits, and incremental 'only new results' retrieval, returning one flat row per post and comment plus a summary row.
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 Search and Thread Scraper MCP Server Find recent r/sales posts about cold email from the last week"
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 Search and Thread Scraper MCP Server
An MCP server for the Mamba Labs Reddit Search and Thread Scraper actor on Apify. Search Reddit by keyword, read subreddits, or read threads with their comments, and get one flat row per post and comment.
Status, 12 November 2026
Working: keyword search inside subreddits, subreddit reads, and thread URLs with comments, through Arctic Shift, a free public archive of Reddit. Keyword search across all of Reddit works with your own Serper or Brave search key. Each post's current title, score, and comment count are read from Reddit's public embed page.
Changed: Reddit closed logged out search on about 5 November 2026 and ends its RSS feeds on 13 November 2026, so the actor's version 0.1, which read those feeds, could no longer return posts. Actor version 0.2 and this server's version 1.1.0 do not use RSS. What to use instead: name a subreddit for every search (Arctic Shift needs one), or pass your own Serper or Brave key in
search_api_keyto search all of Reddit. A blocked run charges only the start fee.
What's Inside
Related MCP server: reddit-search
What it does
Each search term runs inside each subreddit you list through Arctic Shift, or across all of Reddit with your own Serper or Brave key. By default a result is kept only when the search term is in the post's title or text, so loosely related results are dropped and not charged. Subreddits with no search term return their newest posts. Thread URLs return the post and its top comments. Every row names its source in data_route, and each query also returns one free summary row with its counts. No Reddit account, login, or Reddit API key is used, and no RSS feed is read.
Routes and fallback
Route |
| What it reads | Needs | Comments |
Arctic Shift (default) |
| A free public archive of Reddit run by an independent open source project, about 15 minutes behind live Reddit | A subreddit for every search | Yes |
Your search key |
|
| Your own Serper or Brave key | Only when Arctic Shift has the post |
Reddit embed |
| A thread Arctic Shift has not stored yet: title and score from Reddit's public embed page, without text | Nothing | No |
reddit_route picks the main route: arctic_shift (default), search_key, or both. If the main route fails or cannot run, the actor switches to the other route when it can and says so in route_note. A search with no subreddit and no key returns one free row that says what to add. Your key goes only to the provider you picked, in a request header, and is never stored, logged, or written to a row. Search calls are billed to you by your provider.
All of the work runs on Apify. This package is a thin client that starts the actor run, waits for it, and hands back the dataset rows.
Quick start
You need Node.js 18 or newer and an Apify account with an API token.
Add this to your Claude Desktop config (claude_desktop_config.json), Cursor, or any MCP client:
{
"mcpServers": {
"mamba-reddit-search-thread-scraper": {
"command": "npx",
"args": [
"-y",
"@mambalabsdev/mcp-reddit-search-thread-scraper"
],
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
}
}Restart the client. The search_reddit tool appears.
Prerequisites
Node.js 18 or newer.
An Apify API token from console.apify.com/account/integrations, set as
APIFY_TOKEN. The server lists its tool without a token; a call needs one.
Example prompts
"Find Reddit posts from the last week in r/sales and r/startups that mention cold email."
"Search all of Reddit for posts asking for a cold email agency, using my Serper key."
"Pull the top comments from this Reddit thread into a table."
"What are people on r/SaaS posting about this month?"
Tool
search_reddit. One tool. Example arguments:
{
"search_terms": [
"cold email"
],
"subreddits": [
"sales"
],
"since_days": 7,
"max_posts_per_query": 50
}Inputs
Every buyer facing input of the actor. Omitted inputs take the actor's own defaults.
Input | Type | Required | Description |
| array | no | Keywords to search Reddit for. With subreddits, each term runs inside each subreddit. |
| array | no | Subreddits to search in, or to read when there is no search term. |
| array | no | Thread URLs to read with their comments, up to 200. |
| string | no | Main route: arctic_shift (default, needs a subreddit), search_key (your key, all of Reddit), or both. The other route takes over when the main one fails. |
| string | no | Provider of your key: serper or brave. Default serper. |
| string | no | Your own Serper or Brave key, for keyword search across all of Reddit. Never stored or logged. |
| boolean | no | Read each post's current title, score, and comment count from Reddit's embed page. Default true. |
| string | no | Search order: new, top, or comments (by stored score or comment count); relevance and hot read as new. Default new. |
| string | no | Subreddit read order: new, or top by stored score; hot and rising read as new. Default new. |
| string | no | For searches, only posts from the last hour, day, week, month, year, or all. Default month. |
| integer | no | Drop posts older than this many days. |
| integer | no | Posts per search or subreddit, up to 1,000. Default 50. |
| boolean | no | Keep a search result only when the term is in its title or text. Default true. |
| boolean | no | Also return the comments of every post found. Default false. |
| integer | no | Comments per thread, top first, up to 500. Default 25. |
| integer | no | Reply levels under each top level comment, 1 to 10. Default 3. |
| boolean | no | Skip posts and comments an earlier run returned for the same query. Default false. |
| string | no | Name for the only new results memory. |
| string | no | Optional cost cap for the run. |
| string | no | auto or residential, for the embed page reads. A reliability setting; it does not get around Reddit's block. Default auto. |
Pricing
Pay per event on Apify, billed to your Apify account. Prices in USD.
Event | Free plan | Bronze | Silver | Gold |
| $0.0015 | $0.001425 | $0.00135 | $0.001275 |
| $0.0015 | $0.001425 | $0.00135 | $0.001275 |
| $0.003144 | $0.003144 | $0.003144 | $0.003144 |
Summary rows, refused input, a query no route could answer, search results without the term, and already delivered rows are free. A blocked run charges only the start fee. Mamba Labs pays the platform costs of the run, Apify proxy traffic included. Calls on your own search key are billed to you by your provider.
FAQ
Why did runs return 0 posts in November 2026? Reddit closed logged out search on about 5 November 2026 and ends RSS on 13 November 2026. The actor's version 0.1 read those feeds. Version 0.2 reads Arctic Shift and, with your key, a search engine. Name a subreddit, or pass your search key.
Can I search all of Reddit without naming a subreddit? Yes, with your own Serper or Brave key in search_api_key. Arctic Shift cannot search without a subreddit.
What does a run cost when Reddit data cannot be reached? Only the start fee.
Why is a run slow sometimes? Arctic Shift is busy: on 12 November 2026 about 2 of 3 keyword searches were refused on the first try and answered on a retry. Each call is retried 5 times before the actor switches route.
Version notes
1.1.0, 12 November 2026. Matches actor version 0.2. Tool inputs: adds reddit_route, search_provider, search_api_key, and read_current_state; every earlier input still works. Output: rows add score, comment_count, removal_state, data_route, embed_checked, and route_note. Charges: unchanged.
1.0.0. First release.
Full actor documentation
apify.com/mambalabs/reddit-search-thread-scraper
License
MIT. See LICENSE.
Available Tools
1 toolsearch_redditSearch Reddit posts and commentsARead-onlyIdempotent
Search Reddit by keyword inside chosen subreddits, or across all of Reddit with the caller's own Serper or Brave search key; read the newest posts of subreddits; or read thread URLs with their comments. Returns one flat row per post (title, text, author, subreddit, publish date, score, comment count, post link, outbound link, the search term it matched, and data_route, the source of the row) and, when asked, one row per comment, plus one free summary row per query. Since 2026-11-12 Reddit is read through Arctic Shift, a free public archive of Reddit that needs a subreddit for searches, plus Reddit's public embed page for current score and comment count; Reddit ended RSS on 2026-11-13. reddit_route picks the main route (arctic_shift, search_key, or both) and the other route takes over when the main one fails. A search with no subreddit and no search key returns one free row that says what to add. No Reddit login. A run that does not succeed is returned as an error with its run ID. Read-only; requires an APIFY_TOKEN and is billed per post and comment row; a blocked run charges only the start fee.
Inputs: sort, only_new, state_key, proxy_mode, +16 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
There is only one tool, so there is no risk of picking the wrong one. Internally it conflates three modes (keyword search, newest-subreddit reads, thread+comment reads), but the description spells out how reddit_route and parameters select among them.
A single snake_case verb_noun name (search_reddit) is unambiguous and matches the convention expected of an Apify actor wrapper. There are no competing names to clash with.
One tool for a domain that clearly has several distinct operations (search, subreddit listing, thread fetch) is thin, and the single description has become a dense paragraph carrying route-selection logic. It is defensible as a unified scraper entry point, but borderline.
The surface covers the stated purpose: keyword search, newest posts per subreddit, and thread URL reads with comments, all read-only. Gaps exist around pagination, sorting, and any listing/lookup helpers, but core scraping workflows are covered.
Maintenance
Related MCP Connectors
Reddit posts and comments by keyword, subreddit or user. No login, no Reddit API key.
Search public Reddit posts, browse subreddit feeds, and read posts, comments, and profiles.
Search, monitor and measure Reddit posts and comments. Previews work with no API key.
Read-only Reddit search API for AI agents: posts, comments, comment trees, subreddit rules.
Related MCP Servers
- AlicenseAqualityAmaintenanceEnables AI assistants to browse Reddit, search posts, analyze user activity, and fetch comments without requiring API keys. Features smart caching, clean data responses, and optional authentication for higher rate limits.66,037 npm895MIT
- 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.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to access public Reddit data via JSON endpoints, including subreddit trending posts, keyword search, and post details with comments, without authentication.83 npmMIT
- AlicenseAqualityDmaintenanceProvides read-only access to public Reddit discussions via official OAuth, with tools to list posts, search subreddits, and retrieve posts and comments.4MIT