redd-archiver

Overview

Redd-Archiver transforms compressed data dumps into browsable HTML archives with flexible deployment options. It supports offline browsing via sorted index pages or full-text search with Docker deployment. The project features mobile-first design, multi-platform support (Reddit, Voat, Ruqqus), and enterprise-grade performance with PostgreSQL full-text indexing. The MCP server provides 29 tools for AI assistants to query posts, comments, users, and search across the archives.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• query_posts

  Query posts with filtering options for subreddit, author, date range, and sorting

  Try:Show me the top posts from r/privacy this monthTry:Find all posts by user 'dataprivacy' in 2020
• get_post

  Retrieve a specific post by its ID

  Try:Get post with ID t3_abc123Try:Show me details of the post about GDPR
• query_comments

  Query comments with filtering options for subreddit, author, date range

  Try:Show comments on posts from r/technology in the last weekTry:Find all comments by user 'privacyexpert'
• get_comment

  Retrieve a specific comment by its ID

  Try:Get comment with ID t1_abc123Try:Show me the comment on post t3_xyz789
• search_posts

  Full-text search across all posts using PostgreSQL FTS with Google-style operators

  Try:Search for posts about data privacy regulationsTry:Find posts mentioning 'GDPR' and 'CCPA' in r/privacy
• get_user

  Retrieve user profile information and activity summary

  Try:Get profile for user 'dataprivacy'Try:Show me statistics for user 'privacyexpert'
• query_subreddits

  Query subreddits with filtering options and get statistics

  Try:Show me subreddits with more than 100K subscribersTry:List subreddits related to data privacy
• get_stats

  Get archive statistics including total posts, comments, users, and database metrics

  Try:Show me overall archive statisticsTry:How many posts are in the r/privacy subreddit?
• get_top_posts

  Get top posts by various metrics (score, comments, date) with optional filtering

  Try:Show me the top posts by score across all subredditsTry:Get the most commented posts in r/technology this month
• export_posts

  Export posts in CSV or NDJSON format with filtering options

  Try:Export all posts from r/privacy to CSVTry:Get posts about data privacy in NDJSON format
• get_help

  Get help and guidance on using search operators and available fields

  Try:Help me with search operatorsTry:Show me available fields for filtering posts
• get_archives

  Get information about available archive instances in the registry

  Try:Show me all available archive instancesTry:Find archives focused on privacy topics

Comparable tools

Installation

git clone https://github.com/19-84/redd-archiver.git
cd redd-archiver

# Create required directories
mkdir -p data output/.postgres-data logs tor-public

# Configure environment (IMPORTANT: change passwords!)
cp .env.example .env
nano .env  # Edit POSTGRES_PASSWORD and DATABASE_URL

# Start services
docker compose up -d

# Generate archive (after downloading .zst files to data/)
python reddarc.py data/ \
  --subreddit privacy \
  --comments-file data/privacy_comments.zst \
  --submissions-file data/privacy_submissions.zst \
  --output output/

{
  "mcpServers": {
    "reddarchiver": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp_server", "run", "python", "server.py"],
      "env": { "REDDARCHIVER_API_URL": "http://localhost:5000" }
    }
  }
}

FAQ

What platforms does Redd-Archiver support?

Redd-Archiver supports Reddit (with Pushshift .zst JSON Lines), Voat (SQL dumps), and Ruqqus (.7z JSON Lines). It can create unified archives from multiple platforms.

How do I deploy the MCP server?

The MCP server is included in the mcp_server/ directory. Configure it with your API URL and start the server.py script. Claude Desktop configuration is provided in the documentation.

On Hacker News

Recent discussion from the developer community.

• Show HN: Self-host Reddit – 2.38B posts, works offline, yours forever▲ 286💬 64
  Story by 19-84 · 2026-01-13

Compare redd-archiver with