Allows reading Reddit posts by URL, returning parsed post metadata and body, with optional comments. It handles Reddit's JavaScript proof-of-work challenge and humanity gate to retrieve post content.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ScrapeReddit is an MCP (Model Context Protocol) server that reads Reddit posts by URL, bypassing Reddit's JavaScript proof-of-work challenge and "prove your humanity" gate. It exposes one tool:
read_reddit_post(url, includeComments?, maxComments?)
Reddit front-ends ordinary HTTP fetches with a JS challenge and a CAPTCHA.
Generic tools (curl, webfetch, web search) often receive only the challenge
page. This server solves the challenge (jsc_token + doubled seed), replays the
request with the same cookie jar, and returns parsed post metadata + body.
Related MCP server: LinkDigest
Node.js >= 18
node index.jsThe server speaks MCP over stdio.
opencode mcp add ScrapeReddit --global -- node /absolute/path/to/index.jsOptionally copy opencode-skill/SKILL.md to
~/.config/opencode/skills/reddit/SKILL.md so agents are instructed to prefer
ScrapeReddit whenever a Reddit URL is involved.
scripts/read_reddit.sh is a standalone bash reader using the same flow.
# Installer prompt: ScrapeReddit MCP
Copy the block below and give it to your coding agent.
---
You are an AI coding agent. Install and configure the ScrapeReddit MCP server for
this environment, then verify it works.
Repository: https://github.com/NotAndrej/scrape-reddit-mcp
License: GPL-3.0-or-later
Steps:
1. Clone the repository to a persistent local path, for example `~/scrape-reddit-mcp`,
and ensure `node --version` is 18 or newer.
2. Test the server starts:
- Send one JSON-RPC `initialize` request to `node index.js` over stdin.
- Confirm it responds with `serverInfo.name == "ScrapeReddit"`.
3. Register it with the current harness:
- OpenCode: run `opencode mcp add ScrapeReddit --global -- node <path>/index.js`,
then copy `opencode-skill/SKILL.md` to `~/.config/opencode/skills/reddit/SKILL.md`,
then run `opencode reload`.
- Claude Code: ensure `.mcp.json` in the project/workspace points `ScrapeReddit` to
`node <path>/index.js`.
- Codex: append an `[mcp_servers.ScrapeReddit]` block (`command = "node"`,
`args = ["<path>/index.js"]`) to `~/.codex/config.toml`.
- Other agent: register the stdio server command `node <path>/index.js` as an MCP
server named `ScrapeReddit`.
4. Verify with the MCP `tools/list` that `read_reddit_post` is available, and call it on:
`https://www.reddit.com/r/opensource/comments/1xelcuf/your_tokens_arent_valuable_no_more_ai/`
5. Report the post title and author after a successful read.
Constraints:
- Do not use curl/webfetch/websearch against reddit.com as a substitute.
- Preserve existing user configuration; only add the ScrapeReddit entry.
- Prefer absolute paths in harness configs.
---
File lives in the repository as `INSTALL_PROMPT.md`.
GPL-3.0-or-later (GNU General Public License v3.0 or later).
See LICENSE for full text.
This repo ships shared instructions in AGENTS.md. Harness-specific files:
Claude Code (CC): .mcp.json
OpenCode (OC): .opencode/opencode.json + opencode-skill/SKILL.md
Codex: .codex/config.toml
Pi / others: follow AGENTS.md and register the stdio server node index.js
This server cannot be deployed
Reddit posts, full comment trees, searches, subreddits and users, as JSON or Markdown for LLMs.
Read-only Reddit search API for AI agents: posts, comments, comment trees, subreddit rules.
Reddit posts, comments, keyword search and historical archives as tools. Runs on Apify.
Scrape X, Reddit, LinkedIn, GitHub, Instagram and TikTok data as tools for AI agents.
