Awesome-openclaw-skills reddit-2

Read and search Reddit posts via web scraping of old.reddit.com. Use when Clawdbot needs to browse Reddit content - read posts from subreddits, search for topics, monitor specific communities. Read-only access with no posting or comments.

install

source · Clone the upstream repo

git clone https://github.com/sundial-org/awesome-openclaw-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/reddit-2" ~/.claude/skills/sundial-org-awesome-openclaw-skills-reddit-2 && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/reddit-2" ~/.openclaw/skills/sundial-org-awesome-openclaw-skills-reddit-2 && rm -rf "$T"

manifest: skills/reddit-2/SKILL.md

source content

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.