---
name: Reddit
slug: reddit
category: Automation
description: "Reddit searches and retrieves posts, comments, subreddit info, and user profiles from Reddit's public JSON API. Use it when a user mentions Reddit, a subreddit, or r/ links."
github: "https://github.com/ReScienceLab/opc-skills/tree/main/skills/reddit"
language: Python
stars: 1594
forks: 148
install: "npx degit https://github.com/ReScienceLab/opc-skills/tree/main/skills/reddit ~/.claude/skills/reddit"
installs_to: ~/.claude/skills/reddit
source_path: skills/reddit/SKILL.md
collection_size: 13
category_size: 1523
collection_url: "https://dirskills.com/collections/ReScienceLab/opc-skills"
added: 2026-08-19T07:26:15.738Z
last_synced: 2026-08-19T07:26:15.738Z
canonical_url: "https://dirskills.com/skills/reddit"
---

# Reddit

Reddit searches and retrieves posts, comments, subreddit info, and user profiles from Reddit's public JSON API. Use it when a user mentions Reddit, a subreddit, or r/ links.

**Install:**

```bash
npx degit https://github.com/ReScienceLab/opc-skills/tree/main/skills/reddit ~/.claude/skills/reddit
```

## README

# Reddit Skill

Get posts, comments, subreddit info, and user profiles from Reddit via the public JSON API.

## Prerequisites

**No API key required!** Reddit's public JSON API works without authentication.

**Quick Check**:
```bash
cd <skill_directory>
python3 scripts/get_posts.py python --limit 3
```

## Commands

All commands run from the skill directory.

### Subreddit Posts
```bash
python3 scripts/get_posts.py python --limit 20           # Hot posts (default)
python3 scripts/get_posts.py python --sort new --limit 20
python3 scripts/get_posts.py python --sort top --time week
python3 scripts/get_posts.py python --sort top --time all --limit 10
```

### Search Posts
```bash
python3 scripts/search_posts.py "AI agent" --limit 20
python3 scripts/search_posts.py "MCP server" --subreddit ClaudeAI --limit 10
python3 scripts/search_posts.py "async python" --sort top --time year
```

### Subreddit Info
```bash
python3 scripts/get_subreddit.py python
python3 scripts/get_subreddit.py ClaudeAI
```

### Post & Comments
```bash
python3 scripts/get_post.py abc123                       # Get post by ID
python3 scripts/get_post.py abc123 --comments 50         # With more comments
```

### User Profile
```bash
python3 scripts/get_user.py spez
python3 scripts/get_user.py spez --posts 10              # Include recent posts
```

## Sort Options

| Sort | Description | Time Options |
|------|-------------|--------------|
| `hot` | Trending posts (default) | - |
| `new` | Latest posts | - |
| `top` | Highest voted | hour, day, week, month, year, all |
| `rising` | Gaining traction | - |
| `controversial` | Mixed votes | hour, day, week, month, year, all |

## API Info
- **Method**: Public JSON API (no auth needed)
- **Trick**: Append `.json` to any Reddit URL
- **Rate Limit**: 100 requests/minute
- **Docs**: https://www.reddit.com/dev/api