reddit

# 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](references/TECHNICAL.md) for implementation details.