Reddit Skill 📰

Read and search Reddit posts using the public JSON API. No API key required.

Quick Start

# Read top posts from a subreddit
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit LocalLLaMA --limit 5

# Search for posts
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --search "clawdbot" --limit 5

# Read newest posts
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit ClaudeAI --sort nuevos --limit 5

Options

| Option | Short | Description | Default | |--------|-------|-------------|---------| | --subreddit | -s | Subreddit name (without r/) | - | | --search | -q | Search query | - | | --sort | - | Sort: hot, new, top, populares, nuevos, rising | top | | --time | -t | Time filter: hour, day, week, month, year, all | day | | --limit | -n | Number of posts (max 100) | 25 | | --json | -j | Output as JSON | false | | --verbose | -v | Show post preview text | false |

Examples

Read subreddit posts

# Top posts of the day (default)
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit programming

# Hot posts
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit programming --sort hot

# New posts
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit programming --sort nuevos

# Top posts of the week
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit programming --sort top --time week

Search posts

# Search all of Reddit
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --search "machine learning"

# Search within a subreddit
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit selfhosted --search "docker"

# Search with time filter
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --search "AI news" --time week

JSON output

# Get raw JSON data for processing
python3 /root/clawd/skills/reddit/scripts/reddit_scraper.py --subreddit technology --limit 3 --json

Output Fields (JSON)

• title: Post title
• author: Username
• score: Upvotes (net)
• num_comments: Comment count
• url: Link URL
• permalink: Reddit discussion URL
• subreddit: Subreddit name
• created_utc: Unix timestamp
• selftext: Post text (first 200 chars)
• upvote_ratio: Upvote percentage (0-1)

Limitations

• Read-only: Cannot post, comment, or vote
• Rate limits: Reddit may rate-limit if too many requests
• No auth: Some content may be restricted

Technical Details

See TECHNICAL.md for implementation details.