reddit

name	reddit
description	Browse, search, post, and moderate Reddit. Read-only works without auth; posting and moderation require OAuth. Use this skill when the user wants to search Reddit, read subreddits, post content, reply to threads, or moderate communities. Also trigger for 'reddit', 'subreddit', 'post on reddit', 'check r/[subreddit]', or any Reddit-related task.
author	G-HunterAi
license	MIT
version	1.0.0
tags	["reddit","social","community","discussion"]
platforms	["macos","linux","windows"]
category	integration
emoji	📣
metadata	{"clawdbot":{"emoji":"📣","requires":{"bins":["node"]}}}

Reddit

Browse, search, post to, and moderate subreddits. Read-only actions work without auth; posting/moderation requires OAuth setup.

When to Use

• Browsing hot, new, or trending posts from subreddits
• Searching Reddit for discussions or specific content
• Posting new threads or replying to comments
• Moderating subreddits (if you have permissions)

When NOT to Use

• Engaging in platform-violating content or spam
• Accessing user private messages or private subreddits without permission
• Rate-limit intensive operations without delays

Setup (for posting/moderation)

1. Go to https://www.reddit.com/prefs/apps
2. Click "create another app..."
3. Select "script" type
4. Set redirect URI to http://localhost:8080
5. Note your client ID (under app name) and client secret
6. Set environment variables:

   export REDDIT_CLIENT_ID="your_client_id"
   export REDDIT_CLIENT_SECRET="your_client_secret"
   export REDDIT_USERNAME="your_username"
   export REDDIT_PASSWORD="your_password"
   

Read Posts (no auth required)

# Hot posts from a subreddit
node {baseDir}/scripts/reddit.mjs posts wallstreetbets

# New posts
node {baseDir}/scripts/reddit.mjs posts wallstreetbets --sort new

# Top posts (day/week/month/year/all)
node {baseDir}/scripts/reddit.mjs posts wallstreetbets --sort top --time week

# Limit results
node {baseDir}/scripts/reddit.mjs posts wallstreetbets --limit 5

Search Posts

# Search within a subreddit
node {baseDir}/scripts/reddit.mjs search wallstreetbets "YOLO"

# Search all of Reddit
node {baseDir}/scripts/reddit.mjs search all "stock picks"

Get Comments on a Post

# By post ID or full URL
node {baseDir}/scripts/reddit.mjs comments POST_ID
node {baseDir}/scripts/reddit.mjs comments "https://reddit.com/r/subreddit/comments/abc123/..."

Submit a Post (requires auth)

# Text post
node {baseDir}/scripts/reddit.mjs submit yoursubreddit --title "Weekly Discussion" --text "What's on your mind?"

# Link post
node {baseDir}/scripts/reddit.mjs submit yoursubreddit --title "Great article" --url "https://example.com/article"

Reply to a Post/Comment (requires auth)

node {baseDir}/scripts/reddit.mjs reply THING_ID "Your reply text here"

Moderation (requires auth + mod permissions)

# Remove a post/comment
node {baseDir}/scripts/reddit.mjs mod remove THING_ID

# Approve a post/comment
node {baseDir}/scripts/reddit.mjs mod approve THING_ID

# Sticky a post
node {baseDir}/scripts/reddit.mjs mod sticky POST_ID

# Unsticky
node {baseDir}/scripts/reddit.mjs mod unsticky POST_ID

# Lock comments
node {baseDir}/scripts/reddit.mjs mod lock POST_ID

# View modqueue
node {baseDir}/scripts/reddit.mjs mod queue yoursubreddit

Error Handling

Error	Cause	Solution
401 Unauthorized	Invalid API credentials	Verify REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, username, and password
403 Forbidden	Insufficient permissions (posting/moderation)	Ensure account is not suspended and you have mod rights for moderation commands
429 Too Many Requests	Rate limit exceeded (~60 req/min with auth, ~10 without)	Add delays between requests; implement exponential backoff
404 Not Found	Post/comment doesn't exist or is deleted	Verify post ID or URL is correct

Works Well With

• news-aggregator-skill — Combine Reddit search results with other news sources
• in-depth-research — Extract discussion threads for topic analysis
• web-scraper — Scrape additional metadata beyond Reddit API limits

Notes

• Read actions use Reddit's public JSON API (no auth needed)
• Post/mod actions require OAuth - run login command once to authorize
• Token stored at ~/.reddit-token.json (auto-refreshes)
• Rate limits: ~60 requests/minute for OAuth, ~10/minute for unauthenticated