Redd Archiver
A PostgreSQL-backed archive generator that creates browsable HTML archives from link aggregator platforms including Reddit, Voat, and Ruqqus.
What is Redd Archiver?
Redd Archiver is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to postgresql-backed archive generator that creates browsable html archives from link aggregator platforms including reddit, voat, and ruqqus.
A PostgreSQL-backed archive generator that creates browsable HTML archives from link aggregator platforms including Reddit, Voat, and Ruqqus.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A PostgreSQL-backed archive generator that creates browsable
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx redd-archiverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Redd Archiver
Redd Archiver is a PostgreSQL-backed archive generator that ingests link aggregator dump files from Reddit, Voat, and Ruqqus and produces fully self-contained, browsable HTML archives with full-text search, theme support, and 30+ REST API endpoints. It operates via Docker or a local Python environment, and exposes 29 MCP tools that give AI agents direct access to archived posts, comments, users, and subreddits — enabling conversational exploration of billions of archived social media posts without relying on live platform APIs.
Prerequisites
- Docker and Docker Compose (recommended) or Python 3.10+ with PostgreSQL 14+
- At least 4 GB RAM for processing large dump files
- Archive dump files in .zst format (Reddit), SQL dump (Voat), or .7z (Ruqqus) from Academic Torrents or archive.org
- An MCP-compatible client such as Claude Desktop or Claude Code
- No external API keys required
Clone the repository and configure environment
Clone the repo and create your .env file from the example template. Edit the database credentials and any serving configuration you want to customize.
git clone https://github.com/19-84/redd-archiver.git
cd redd-archiver
mkdir -p data output/.postgres-data logs tor-public
cp .env.example .env
nano .envStart the Docker stack
Bring up the full stack with Docker Compose. This starts the PostgreSQL database, the archive builder, and the web serving layer.
docker compose up -dImport an archive dump
Run the archive builder to import a subreddit dump file. This example imports a Reddit privacy subreddit archive in .zst format.
docker compose exec reddarchiver-builder python reddarc.py /data \
--subreddit privacy \
--comments-file /data/privacy_comments.zst \
--output /output/Configure the MCP server
Add the redd-archiver MCP server to your client configuration. The server.py file in the mcp_server directory connects to your running archive via REDDARCHIVER_API_URL.
{
"mcpServers": {
"reddarchiver": {
"command": "uv",
"args": ["--directory", "/path/to/redd-archiver/mcp_server", "run", "python", "server.py"],
"env": {
"REDDARCHIVER_API_URL": "http://localhost:5000"
}
}
}
}Optional: set serving and theme preferences
Customize the archive appearance and serving behavior via environment variables. The server supports 11 color themes and hybrid or dynamic serving modes.
REDDARCHIVER_THEME=nord
REDDARCHIVER_SERVE_MODE=hybrid
REDDARCHIVER_HTTP_CACHE_MAX_AGE=3600Redd Archiver Examples
Client configuration
MCP client configuration connecting to a locally running redd-archiver instance. Adjust the directory path to match where you cloned the repository.
{
"mcpServers": {
"reddarchiver": {
"command": "uv",
"args": ["--directory", "/home/user/redd-archiver/mcp_server", "run", "python", "server.py"],
"env": {
"REDDARCHIVER_API_URL": "http://localhost:5000"
}
}
}
}Prompts to try
Example prompts for exploring archived social media data through the 29 MCP tools.
- "Search the privacy subreddit archive for posts about VPNs from 2020"
- "List the top 10 most upvoted posts in the archive"
- "Find all comments by user throwaway12345 in the archive"
- "Show posts about data breaches and summarize the main concerns"
- "Export all posts from the programming subreddit to CSV"Troubleshooting Redd Archiver
Docker Compose fails to start with database connection errors
Ensure the .postgres-data directory exists inside the output folder (`mkdir -p output/.postgres-data`). Check that the DATABASE_URL in your .env matches the PostgreSQL credentials configured in docker-compose.yml.
Import takes extremely long or runs out of memory
Reddit dumps can be terabytes in size. Process one subreddit at a time and ensure you have at least 4 GB RAM. Increase REDDARCHIVER_MAX_PARALLEL_WORKERS in .env to speed up batch processing on machines with more cores.
MCP server cannot reach the archive API
Verify the archive web server is running and accessible at the URL set in REDDARCHIVER_API_URL. If using Docker, the service may be on a different port or bind address — check `docker compose ps` to confirm the port mapping.
Frequently Asked Questions about Redd Archiver
What is Redd Archiver?
Redd Archiver is a Model Context Protocol (MCP) server that postgresql-backed archive generator that creates browsable html archives from link aggregator platforms including reddit, voat, and ruqqus. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Redd Archiver?
Follow the installation instructions on the Redd Archiver GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Redd Archiver?
Redd Archiver works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Redd Archiver free to use?
Yes, Redd Archiver is open source and available under the Unlicense license. You can use it freely in both personal and commercial projects.
Redd Archiver Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Redd Archiver? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Redd Archiver in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Redd Archiver?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.