Skip to main content
Glama
Reddit Search and Thread Scraper MCP Server

Reddit Search and Thread Scraper MCP Server

Reddit Search and Thread Scraper MCP Server

npm version license

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_key to 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

data_route

What it reads

Needs

Comments

Arctic Shift (default)

arctic_shift

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

search_serper or search_brave

site:reddit.com results from Serper (Google) or Brave Search, each post then read through Arctic Shift for its text

Your own Serper or Brave key

Only when Arctic Shift has the post

Reddit embed

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

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

search_terms

array

no

Keywords to search Reddit for. With subreddits, each term runs inside each subreddit.

subreddits

array

no

Subreddits to search in, or to read when there is no search term.

thread_urls

array

no

Thread URLs to read with their comments, up to 200.

reddit_route

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.

search_provider

string

no

Provider of your key: serper or brave. Default serper.

search_api_key

string

no

Your own Serper or Brave key, for keyword search across all of Reddit. Never stored or logged.

read_current_state

boolean

no

Read each post's current title, score, and comment count from Reddit's embed page. Default true.

sort

string

no

Search order: new, top, or comments (by stored score or comment count); relevance and hot read as new. Default new.

subreddit_sort

string

no

Subreddit read order: new, or top by stored score; hot and rising read as new. Default new.

time_window

string

no

For searches, only posts from the last hour, day, week, month, year, or all. Default month.

since_days

integer

no

Drop posts older than this many days.

max_posts_per_query

integer

no

Posts per search or subreddit, up to 1,000. Default 50.

require_term_match

boolean

no

Keep a search result only when the term is in its title or text. Default true.

include_comments

boolean

no

Also return the comments of every post found. Default false.

max_comments_per_thread

integer

no

Comments per thread, top first, up to 500. Default 25.

comment_depth

integer

no

Reply levels under each top level comment, 1 to 10. Default 3.

only_new

boolean

no

Skip posts and comments an earlier run returned for the same query. Default false.

state_key

string

no

Name for the only new results memory.

max_charge_usd

string

no

Optional cost cap for the run.

proxy_mode

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

post-row, per Reddit post

$0.0015

$0.001425

$0.00135

$0.001275

comment-row, per Reddit comment

$0.0015

$0.001425

$0.00135

$0.001275

apify-actor-start, per run start

$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 tool
search_redditSearch Reddit posts and commentsA
Read-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

    A4.4/5.0

    Scored across 1 tool

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      Enables 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.
      6
      6,037 npm
      895
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to access public Reddit data via JSON endpoints, including subreddit trending posts, keyword search, and post details with comments, without authentication.
      83 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides read-only access to public Reddit discussions via official OAuth, with tools to list posts, search subreddits, and retrieve posts and comments.
      4
      MIT