| name | reddit-digest |
| description | Fetch and summarize top posts from your favorite subreddits using Reddit's public JSON API -- no API key or account required. |
| metadata | {"openclaw":{"emoji":"📰","requires":{"bins":["uv"]},"install":[{"id":"uv-brew","kind":"brew","formula":"uv","bins":["uv"],"label":"Install uv (brew)"}]}} |
Reddit Digest
Fetch top posts from any subreddit via Reddit's public JSON API.
No API key, no account, no authentication required.
Quick Start
uv run {baseDir}/scripts/fetch_reddit.py --subreddits "python,machinelearning"
Multiple Subreddits
uv run {baseDir}/scripts/fetch_reddit.py -s "selfhosted,homelab,LocalLLaMA,singularity"
Sort & Filter
Top posts from the past week with at least 100 upvotes:
uv run {baseDir}/scripts/fetch_reddit.py -s "worldnews" --sort top --time week --min-score 100
Rising posts (good for catching trends early):
uv run {baseDir}/scripts/fetch_reddit.py -s "technology" --sort rising --limit 5
New posts:
uv run {baseDir}/scripts/fetch_reddit.py -s "programming" --sort new --limit 15
With Comments
Fetch top 3 comments per post for richer context:
uv run {baseDir}/scripts/fetch_reddit.py -s "AskReddit" --limit 5 --include-comments
JSON Output
uv run {baseDir}/scripts/fetch_reddit.py -s "python" --sort top --time day --json
Cron Setup
Daily morning digest at 7 AM:
cron add "0 7 * * *" "Fetch my Reddit digest from r/selfhosted, r/LocalLLaMA, r/machinelearning (top posts, last 24h, min 50 upvotes) and summarize the most interesting posts." --name "reddit-morning"
Weekly deep dive on Saturdays:
cron add "0 9 * * 6" "Fetch top posts from r/programming, r/python, r/golang for the past week (min 200 upvotes, include comments) and write a summary of key discussions." --name "reddit-weekly"
Flags
| Flag | Default | Description |
|---|
--subreddits, -s | (required) | Comma-separated subreddit list |
--sort | hot | hot, top, new, rising |
--time, -t | day | Time window for top: hour, day, week, month, year, all |
--limit, -l | 10 | Posts per subreddit |
--min-score | 0 | Minimum upvotes to include |
--include-comments, -c | off | Fetch top 3 comments per post |
--json | off | Raw JSON output |
Notes
- Uses Reddit's public
.json endpoints (no OAuth, no API key).
- Rate-limited to ~1 request/second to respect Reddit's limits.
- Stickied/pinned posts are automatically excluded.
- The agent can summarise the digest further in conversation.
- For private or quarantined subreddits, the public API will return empty results.
