| 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)
- Go to https://www.reddit.com/prefs/apps
- Click "create another app..."
- Select "script" type
- Set redirect URI to
http://localhost:8080
- Note your client ID (under app name) and client secret
- 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)
node {baseDir}/scripts/reddit.mjs posts wallstreetbets
node {baseDir}/scripts/reddit.mjs posts wallstreetbets --sort new
node {baseDir}/scripts/reddit.mjs posts wallstreetbets --sort top --time week
node {baseDir}/scripts/reddit.mjs posts wallstreetbets --limit 5
Search Posts
node {baseDir}/scripts/reddit.mjs search wallstreetbets "YOLO"
node {baseDir}/scripts/reddit.mjs search all "stock picks"
Get Comments on a Post
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)
node {baseDir}/scripts/reddit.mjs submit yoursubreddit --title "Weekly Discussion" --text "What's on your mind?"
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)
node {baseDir}/scripts/reddit.mjs mod remove THING_ID
node {baseDir}/scripts/reddit.mjs mod approve THING_ID
node {baseDir}/scripts/reddit.mjs mod sticky POST_ID
node {baseDir}/scripts/reddit.mjs mod unsticky POST_ID
node {baseDir}/scripts/reddit.mjs mod lock POST_ID
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
