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 titleauthor: Usernamescore: Upvotes (net)num_comments: Comment counturl: Link URLpermalink: Reddit discussion URLsubreddit: Subreddit namecreated_utc: Unix timestampselftext: 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.