reddit-reading

Read Reddit subreddits, search results, threads, and user activity via Atom feeds or OAuth API.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill reddit-reading-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reddit-reading
Source: https://github.com/loteiron/ZeusAgent/tree/main/skills/social-media/reddit-reading
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill reddit-reading-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Reddit blocks datacenter and server IPs from its .json endpoints, old.reddit.com, and browser-based access with 403 errors and humanity checks, making it impossible to read Reddit content from headless machines. This Skill provides a working read-only path using Reddit's public Atom feeds, with an optional upgrade to the OAuth API for full data. ## Core Features & Use Cases - Subreddit Listings and Search: Read subreddit front pages (hot, new, top, rising) and search all of Reddit or a single subreddit without any account or API key. - Full Thread Reading: Fetch a thread's post body plus comments, with nested replies and scores when OAuth app credentials are configured. - User Activity Lookup: Review recent posts and comments from any public Reddit user. - Use Case: A user asks "What is r/LocalLLaMA saying about the new model release?" The agent runs a subreddit search, reads the top thread bodies, and cites the permalinks in its report. ## Quick Start Ask the agent to summarize what r/LocalLLaMA is discussing about a topic, and it will run the reddit.py script to fetch and read the relevant threads.

Frequently Asked Questions about reddit-reading

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read Reddit threads from a server without a browser?▼

Use the reddit.py script with the thread command and a reddit.com URL. It fetches Reddit's public Atom feeds, which remain accessible to server IPs, or the OAuth API when app credentials are configured, returning the post body and comments.

How to search Reddit without an API key or account?▼

Run the search command with a query and optional --sub flag. The script uses Reddit's unauthenticated .rss endpoints, which require no account, login, cookie, or key, though they are throttled to roughly one request per minute per IP.

Why does Reddit return 403 or a humanity check from datacenter IPs?▼

Reddit blocks .json endpoints, api.reddit.com, old.reddit.com, and browser user-agents from non-residential IPs. The only unauthenticated route still served is the public Atom feed, which this script uses as its default backend.

Does reading Reddit anonymously support comment scores and nesting?▼

No. Anonymous Atom feeds return only the post plus top-level comments without scores. Registering a free script-type app at reddit.com/prefs/apps and setting REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET enables nested comments, scores, and higher rate limits.

What are the rate limits for anonymous Reddit access?▼

Anonymous feeds allow roughly one request per minute per IP. On a 429 response the script sleeps until the rate-limit window resets and retries once; sustained use beyond about ten calls requires the free OAuth app credentials.

Can this tool post, vote, or log into a Reddit account?▼

No. The script is strictly read-only and never uses a username, password, or browser cookie. The optional OAuth credentials use the app-only client_credentials grant, so it never acts as any user.