Reddit Skill 📰
Read and search Reddit posts using the public JSON API. No API key required.
Quick Start
bash
# 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
bash
# 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
bash
# 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
bash
# 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.