reddit-reading

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

1|Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Chia1104/agent-air --skill reddit-reading-chia1104
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reddit-reading
Source: https://github.com/Chia1104/agent-air/tree/main/skills/hermes/social-media/reddit-reading
Command: npx skills add https://github.com/Chia1104/agent-air --skill reddit-reading-chia1104

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: Browse subreddit front pages by hot, new, top, or rising, and search all of Reddit or a single subreddit with sort and time filters. - Thread and Comment Reading: Fetch full threads with comments; anonymous feeds return top-level comments while OAuth credentials unlock nested comments, scores, and comment counts. - User Activity and Diagnostics: Read any user's recent posts and comments, and run a doctor command to check which backend is active and the current rate-limit window. - Use Case: A user asks what r/LocalLLaMA is saying about a new model. Run a search scoped to that subreddit, then read the top thread's comments and cite the permalink in a research report. ## Quick Start Ask the agent to search Reddit for a topic or summarize a specific Reddit thread URL, and it will run the reddit.py script with the appropriate subcommand.

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 subcommand followed by the thread URL. It fetches Reddit's public Atom .rss feeds, which remain accessible to server IPs even though .json endpoints and old.reddit.com return 403.

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

Run the search subcommand with a query and optional --sub flag to scope results to one subreddit. The anonymous Atom feed backend requires no account, login, cookie, or API key, though it is limited to about one request per minute per IP.

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

Reddit blocks non-residential IPs on www.reddit.com .json endpoints, api.reddit.com, and old.reddit.com, returning 403 or an empty shell. Spoofing a browser User-Agent does not help; the .rss Atom feeds are the only unauthenticated route that still works.

Does Reddit reading support comment scores and nested replies?▼

Scores and nested comment trees require OAuth app credentials. Register a free script-type app at reddit.com/prefs/apps and set REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET; the script then uses the client_credentials grant automatically without any user login.

What are the rate limits for anonymous Reddit access?▼

Anonymous Atom 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 of more than about ten calls requires registering OAuth app credentials.

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

No, it is strictly read-only and never posts, votes, messages, or acts as a user. The optional OAuth path uses app-only client_credentials with no username, password, or browser cookie involved.