reddit-reading

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

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill reddit-reading-chenhui-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reddit-reading
Source: https://github.com/CHENHUI-X/toolbox/tree/main/custom-skills/social-media/reddit-reading
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill reddit-reading-chenhui-x

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 app-only OAuth credentials for higher rate limits and richer data. ## Core Features & Use Cases - Subreddit Listings & Search: Browse subreddit front pages (hot, new, top, rising) and search all of Reddit or a single subreddit without any account or API key. - Thread & User Reading: Fetch full threads with comments and user posting history; with OAuth app credentials you get nested comments, scores, and comment counts. - Automatic Backend Selection: The script detects REDDIT_CLIENT_ID/REDDIT_CLIENT_SECRET in the environment and switches between anonymous feeds (~1 request/minute) and the OAuth API (~100 requests/minute), with a doctor command to diagnose the active backend. - Use Case: Ask "what is r/LocalLLaMA saying about the new model release" from a server with no browser, and get thread bodies and top comments with permalink citations for a research report. ## Quick Start Ask the agent to run the reddit-reading skill's doctor command and then search r/LocalLLaMA for a topic you want summarized.

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 from a server without a browser?

Use Reddit's public Atom .rss endpoints, which remain accessible to datacenter IPs when .json and old.reddit.com return 403. This skill's script wraps those feeds with sub, search, thread, and user commands requiring no account or API key.

How to bypass Reddit 403 errors on datacenter IPs?

Reddit blocks .json endpoints, api.reddit.com, and old.reddit.com for server IPs, and spoofing browser User-Agents does not help. The working routes are the anonymous .rss Atom feeds or the official OAuth API with a free script-type app registration.

Do I need a Reddit account or API key to scrape Reddit?

No account, login, cookie, or key is needed for the anonymous Atom feeds, though they are throttled to about one request per minute per IP. Optionally registering a free script app at reddit.com/prefs/apps provides app-only credentials for roughly 100 requests per minute without ever logging in as a user.

Why does Reddit scraping return 429 rate limit errors?

Anonymous Reddit feeds allow roughly one request per minute per IP, so bursts of calls trigger 429 responses. The script sleeps until the rate-limit window resets and retries once; sustained use requires registering OAuth app credentials instead of retry loops or proxies.

What are the limitations of anonymous Reddit RSS feeds?

Anonymous feeds return only the post plus top-level comments with no scores, no reply nesting, and no comment counts, and Reddit caps results at roughly 5-25 entries regardless of the requested limit. Full nested comments and scores require OAuth app credentials.