reddit-browse-and-post

Browse Reddit threads and publish posts via OAuth API or browser session.

115|9|Updated Aug 5, 2026
One-click install
npx skills add https://github.com/AtlasOmnia/donna-starter --skill reddit-browse-and-post-atlasomnia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reddit-browse-and-post
Source: https://github.com/AtlasOmnia/donna-starter/tree/main/skills/social-media/reddit-browse-and-post
Command: npx skills add https://github.com/AtlasOmnia/donna-starter --skill reddit-browse-and-post-atlasomnia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reading Reddit from scripts often fails because Reddit's anti-bot layer blocks plain curl requests, and publishing posts safely requires authenticated access, subreddit rule checks, and explicit user approval before anything goes live. ## Core Features & Use Cases - Reddit Reading: Fetch subreddit listings, search results, threads, and comments through public JSON endpoints, the authenticated OAuth API, or a logged-in browser session. - Authenticated Posting: Create text or link posts (with optional flair) through a Reddit script app using the password grant, with credentials kept only in environment variables. - Safe Publishing Workflow: Drafts are shown for explicit approval, subreddit rules are checked first, and the live post is verified afterward. - Use Case: Ask the agent to research a topic across relevant subreddits, summarize the top threads, then draft and publish a discussion post to r/yourcommunity after you approve the exact title and body. ## Quick Start Ask the agent to search Reddit for discussions about your topic and draft a post to a chosen subreddit for your approval.

Frequently Asked Questions about reddit-browse-and-post

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

FAQPage Schema
How do I read Reddit threads from a script without getting blocked?

Use Reddit's JSON endpoints with a unique descriptive User-Agent, but expect 403 HTML block pages from some networks. The reliable path is an OAuth token against oauth.reddit.com, or a logged-in browser session for JS-gated pages.

How do I post to Reddit using the API?

Create a script app at reddit.com/prefs/apps, store the client ID, secret, username, and password in environment variables, then request a token via the password grant and POST to oauth.reddit.com/api/submit with api_type=json.

Why does curl return a 403 HTML page from Reddit?

Reddit's anti-bot layer blocks requests at the IP level regardless of User-Agent on some networks. Do not retry endlessly; switch to the authenticated OAuth API path or use a browser session instead.

Can I post to Reddit without creating an OAuth app?

Yes, the user can log into Reddit once in the Hermes browser and the agent uses that session to fill the submit form. The user clicks Submit themselves or explicitly authorizes the agent to click it.

Why did my Reddit post disappear right after submitting?

New or low-karma accounts often hit RATELIMIT errors or shadow-removal, so a post that 404s after success was likely removed. Check the errors array in the API response and report removal honestly rather than claiming success.