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.
