Reddit Browse & Post

Let an agent read Reddit and publish posts using the user's own Reddit account. Everything here is account-agnostic: the user supplies their credentials through environment variables or a browser login, never through chat.

Hard rules

• Never ask the user to paste a Reddit password, token, or cookie into chat. Credentials go into environment variables (profile .env) or the user logs in via the browser themselves.
• Posting is an irreversible publish action. Draft the title and body, show the user exactly what will be posted and where, and get explicit approval before submitting. No exceptions for "the user already asked."
• Never edit, delete, vote, or mod-queue anything without explicit approval.
• Respect subreddit rules: read the sidebar / rules (or about/rules.json) before posting to a subreddit you have not posted to.
• Respect rate limits: keep requests under ~1/second for reads; wait at least a minute between post attempts. Respect 429/403 responses and back off.
• Do not post spam, affiliate links, or promotional content unless the user explicitly directs it.
• Vote manipulation, ban evasion, and buying/selling accounts are off-limits.

Reading Reddit

Reddit's public JSON endpoints (/r/<sub>/.json, /search.json, /comments/<id>.json) work without credentials when the network allows it — but Reddit's anti-bot layer frequently returns a 403 HTML block page for plain curl requests, even with a custom User-Agent. Do not fight it: try one curl probe, and if it comes back as HTML/403, switch immediately to one of the reliable paths below.

Reliable paths, in order: