Browse, search, post, and moderate Reddit. Read-only works without auth; posting/moderation requires OAuth setup.
When & Why to Use This Skill
This Claude skill enables comprehensive interaction with Reddit, empowering users to automate subreddit browsing, content searching, and community management. It bridges the gap between AI reasoning and social media engagement by supporting both public data retrieval and authenticated actions like posting, replying, and moderation. It is an essential tool for developers and marketers looking to integrate real-time social data and community interaction into their AI workflows.
Use Cases
- Market Research & Trend Analysis: Automatically monitor specific subreddits to identify emerging trends, consumer sentiment, or viral topics within niche communities.
- Automated Community Moderation: Streamline subreddit management by using the AI to filter the mod queue, remove spam, or sticky important announcements based on context.
- Social Listening & Brand Engagement: Search all of Reddit for brand mentions and use the AI to draft and submit helpful, context-aware replies to users.
- Content Aggregation & Summarization: Fetch the top posts from multiple subreddits daily to generate summarized reports on industry news or community discussions.
- Automated Content Distribution: Programmatically post updates, links, or discussion threads to relevant subreddits to drive engagement and traffic.
| name | |
|---|---|
| description | Browse, search, post, and moderate Reddit. Read-only works without auth; posting/moderation requires OAuth setup. |
| metadata | {"clawdbot":{"emoji":"📣","requires":{"bins":["node"]}}} |
Browse, search, post to, and moderate subreddits. Read-only actions work without auth; posting/moderation requires OAuth setup.
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)
# 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
Notes
- Read actions use Reddit's public JSON API (no auth needed)
- Post/mod actions require OAuth - run
logincommand once to authorize - Token stored at
~/.reddit-token.json(auto-refreshes) - Rate limits: ~60 requests/minute for OAuth, ~10/minute for unauthenticated