reddit-skill

Run the reddit_reader.py script with the search subcommand, passing a query plus optional --subreddit, --sort, --time, and --limit flags. It authenticates via OAuth2 client credentials and prints results as structured Markdown.

Use the read subcommand with a post ID, full Reddit URL, or /s/ share link. The script calls the /comments/{post_id} endpoint and formats the post body plus the nested comment tree with configurable sort, limit, and depth.

Create a script-type app at reddit.com/prefs/apps to get a client_id and client_secret, then set them as REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET environment variables. The script exchanges them for a bearer token via client_credentials grant.

No, it is strictly read-only. It supports searching posts, listing subreddit content, reading threads and comments, and viewing subreddit info, but cannot submit posts, comment, or vote.

OAuth-authenticated requests are limited to 100 per minute, versus 10 per minute unauthenticated. The script tracks X-Ratelimit-Remaining headers, pauses when low, and retries after the reset window on HTTP 429 responses.

Reddit caps search pagination at roughly 1000 items, and results exclude private subreddits and deleted content. Narrowing with --subreddit, --time, or more specific queries often surfaces more relevant posts.