reddit-readonly

Overview

Browse and search Reddit in read-only mode using public JSON endpoints. Use when the user asks to browse subreddits, search for posts by topic, inspect comment threads, or build a shortlist of links to review and reply to manually.

Key Features

• Find posts in one or more subreddits (hot/new/top/controversial/rising)
• Search for posts by query (within a subreddit or across all)
• Pull a comment thread for context
• Produce a shortlist of permalinks so the user can open Reddit and reply manually

How It Works

1. Clarify scope if needed: subreddits + topic keywords + timeframe.
2. Start with find (or posts/search) using small limits.
3. For 1–3 promising items, fetch context via thread.
4. Present the user a shortlist:
   • title, subreddit, score, created time
   • permalink
   • a brief reason why it matched

Use Cases

• Find posts about Python in r/learnpython and r/python
• Search for posts about fastapi deployment in r/Python and r/fastapi
• Inspect a comment thread for a post about Docker and Uvicorn