Skip to main content
skill CX Codex

reddit — Claude Code skill: what it does, how to install

Search Reddit through its public JSON API for posts, comments, subreddit details, and user profiles.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ReScienceLab/opc-skills --skill reddit -a claude-code
Open on GitHub

What reddit does

This skill calls Reddit's public JSON API to retrieve subreddit posts, search results, community details, individual posts with comments, and user profiles. It fits requests that mention Reddit, a subreddit, or an r/ link.

It includes get_posts.py, search_posts.py, get_subreddit.py, get_post.py, and get_user.py, run with python3 from the skill directory. Post feeds support hot, new, top, rising, and controversial sorting; some sorting modes also accept a time range.

No API key is required. The public API has a 100 requests/minute limit, so bulk retrieval needs to account for that cap.

What it helps with

  • retrieve hot or new posts from a subreddit
  • search Reddit posts by a phrase
  • fetch a post with its comments
  • inspect subreddit details
  • check a user profile and recent posts

Example prompts for the agent

  • Find Reddit posts about MCP server in the ClaudeAI subreddit.
  • Show new posts from the python subreddit.
  • Get post abc123 with its comments.

How to install reddit

1Skills CLI (Vercel)

npx skills add ReScienceLab/opc-skills --skill reddit -a claude-code

2Manually: put the files in place

~/.claude/skills/reddit/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/reddit/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about reddit

How do I install reddit in Claude Code?

Run npx skills add ReScienceLab/opc-skills --skill reddit -a claude-code. The skill is placed at ~/.claude/skills/reddit/SKILL.md.

What does the reddit skill do?

It retrieves Reddit posts, comments, subreddit information, and user profiles through the public JSON API. It can also search posts and sort subreddit feeds.

Does reddit require an API key?

No. Reddit's public JSON API works without authentication, with a limit of 100 requests/minute.

Source text

SKILL.md · Apache-2.0
---
name: reddit
description: Search and retrieve content from Reddit. Get posts, comments, subreddit info, and user profiles via the public JSON API. Use when user mentions Reddit, a subreddit, or r/ links.
---

# 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

© ReScienceLab · Apache-2.0 · ReScienceLab/opc-skills

Similar skills

All skills for Browser and scraping →

From the same set10

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor