# Reddit Content Retrieval Agent Skill

> Retrieve posts, comments, subreddit information, and user profiles from Reddit using its public JSON API. Access real-time discussions and community insights without needing an API key.

- Canonical: https://nanoskill.ai/skills/reddit-content-retrieval
- Markdown: https://nanoskill.ai/skills/reddit-content-retrieval.md
- Author: ReScienceLab
- Published: 2026-06-14T02:30:00.000Z
- Updated: 2026-07-23T03:32:24.579Z
- Language: en
- Source type: github
- Popularity signal: 911

## Sources

- https://github.com/ReScienceLab/opc-skills

## Install

```shell
npx skills add https://github.com/ReScienceLab/opc-skills/tree/main/skills/reddit
```

## About

The Reddit Content Retrieval Skill provides a powerful and straightforward way to access the vast amount of information available on Reddit. By leveraging Reddit's public JSON API, this skill enables users to programmatically fetch posts, comments, subreddit details, and user profiles without the need for any API keys or complex authentication processes. It's an essential tool for anyone looking to analyze community discussions, track trends, or gather data from one of the internet's largest social platforms.

This skill offers a comprehensive suite of commands to interact with Reddit data. Users can retrieve posts from specific subreddits, sort them by various criteria like 'hot', 'new', or 'top', and apply time filters to narrow down results. Beyond general browsing, it supports keyword-based searches for posts, allowing for targeted research on specific topics. You can also delve into individual posts to extract comments or pull detailed information about subreddits and user profiles.

Ideal for researchers, data analysts, or developers, the Reddit Content Retrieval Skill simplifies the process of collecting Reddit content for sentiment analysis, trend monitoring, content aggregation, or building custom applications. Its ease of use, combined with the depth of data it can access, makes it a valuable asset for understanding public discourse and community dynamics on Reddit.

## Key features

- **No API Key Required**: Access Reddit's public JSON API directly without the need for authentication or an API key, simplifying setup and immediate use.
- **Comprehensive Content Retrieval**: Effortlessly fetch various types of Reddit content, including individual posts, associated comments, detailed subreddit information, and user profiles.
- **Flexible Search and Sorting**: Utilize diverse sorting options like 'hot', 'new', 'top', 'rising', and 'controversial' for posts, along with time filters (hour, day, week, month, year, all) to refine your Reddit content searches.
- **Direct Subreddit and User Data Access**: Quickly retrieve information for specific subreddits or user profiles, including recent posts for users, to gain insights into community and individual activity.

## Use cases

- **Monitor Subreddit Discussions**: Track trending topics, new posts, or top discussions within specific subreddits to stay informed about community sentiment and popular content.
- **Analyze User Activity**: Retrieve user profiles and their recent posts to understand contributions, interests, or engagement patterns of specific Reddit users.
- **Research Specific Topics**: Search for posts across Reddit or within particular subreddits using keywords to gather information and insights on any given topic.

## Result preview

Explore a production-ready Reddit market intelligence report powered by this Skill.

![Clean minimalist cover page for a confidential strategy document titled FlowMind Reddit Market Intelligence Report. The layout features large bold black typography for 'FlowMind' and a subtitle describing Reddit-based market intelligence, with a supporting line 'Turn community intelligence into product advantage'. A small header reads 'CONFIDENTIAL STRATEGY ARTIFACT'. On the right side is a geometric network visualization representing connected Reddit community insights and discussion graphs. Footer tags include 'June 2026' and 'Reddit sentiment analysis'. The overall style resembles a modern consulting-grade research report cover with strong whitespace and data-network aesthetics.](https://file.nanoskill.ai/reddit-retrieval-outcome1.png)

![Insight dashboard from a Reddit-based market intelligence report showing four key findings in a clean card grid layout. Insight 1 states 'Fragmentation is the wedge', describing how users manage knowledge across 3–5 tools and add AI agents as another silo. Insight 2 highlights 'AI fatigue is rising', noting users spend increasing time configuring prompts and automations, turning convenience into cognitive load. Insight 3 states 'Trust is the adoption ceiling', explaining that reliability issues, hallucinations, and opaque agent behavior reduce user confidence in AI tools. Insight 4 shows 'Integrated products win comparisons', stating that all-in-one solutions reduce tool switching and are preferred in 73% of comparisons. Below the insights are metric cards showing 68% of users frustrated with current AI productivity tools, 42% reporting fragmented workflows, and 57% wanting AI that understands their knowledge base.](https://file.nanoskill.ai/reddit-retrieval-outcome2.png)

![Data visualization slide titled 'Community signal is polarized, active, and unusually diagnostic.' The graphic shows a segmented donut chart representing thread-level sentiment distribution: Positive 35%, Mixed 30%, Negative 20%, and Neutral 15%. To the right, observed communities are listed as pill tags including r/ClaudeAI, r/ChatGPT, r/Productivity, r/Notion, r/ObsidianMD, r/zapier, r/SaaS, r/automation, and r/Artificial. The overall layout presents Reddit community sentiment analysis across AI and productivity-related subreddits, emphasizing polarized but highly active discussion patterns.](https://file.nanoskill.ai/reddit-retrieval-outcome3.png)

![A trend analysis dashboard showing emerging AI technology categories ranked by signal velocity and month-over-month growth. The vertical list includes Multi-Agent Workflows (+45% MoM, Early stage), Personal Knowledge Graphs (+38% MoM, Growing), On-Device AI Processing (+28% MoM, Niche), AI-Native Collaboration (+52% MoM, Early stage), and Voice-First Interfaces (+20% MoM, Niche). Each category is displayed with a horizontal signal velocity bar on the right indicating momentum strength, using gradient progress bars in blue, purple, and orange tones. The layout presents a comparative overview of AI innovation trends and adoption maturity levels.](https://file.nanoskill.ai/reddit-retrieval-outcome4.png)

## Result walkthrough

### Install

Add the Reddit Market Intelligence Skill to your AI agent.

![Terminal-based AI agent interface showing installation of a Reddit retrieval skill from the ReScienceLab opc-skills repository using an npx skills add command. The system processes an interactive agent selection prompt, selects Claude Code, retries installation with an auto-confirm flag, and successfully installs the Reddit skill. The output confirms symlink setup for Hermes Agent and shows capability details including accessing Reddit via public JSON endpoints without API keys. A command reference table lists available scripts such as get\_posts, search\_posts, get\_subreddit, get\_post by ID, and get\_user profile data, enabling Reddit content search, retrieval, and analysis workflows.](https://file.nanoskill.ai/reddit-retrieval-install.png)

### Analyze Data

Provide a topic or product to extract Reddit insights.

![AI agent interface showing a detailed prompt for generating a Reddit-based market intelligence report for FlowMind, an AI productivity startup. The instructions describe extracting and analyzing real Reddit discussions across relevant subreddits to understand user sentiment, pain points, feature requests, adoption barriers, and competitor comparisons. The workflow specifies structured output sections including sentiment analysis, key frustrations, feature expectations, competitor mentions, emerging trends, and direct user quotes. A follow-up section shows the agent planning research, critiquing subreddit selection strategy, and preparing to launch parallel data collection and synthesis for high-confidence insights.](https://file.nanoskill.ai/reddit-retrieval-task)

### Generate Insights

Produce structured reports with key findings and recommendations.

![Clean executive cover page for a confidential strategy document titled FlowMind Reddit Market Intelligence Report. The design uses a minimalist white background with bold black typography for 'FlowMind' and a subtitle describing Reddit-based market intelligence. A small label indicates 'CONFIDENTIAL STRATEGY ARTIFACT' at the top. The page includes a visual network graph on the right representing community connections and Reddit discussion networks, along with tags such as June 2026 and Reddit sentiment analysis. The layout resembles a consulting-style research report cover focused on turning community intelligence into product advantage.](https://file.nanoskill.ai/reddit-retrieval-outcome.png)

## Skill definition

# 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

## FAQ

### What is the Reddit Content Retrieval Skill?

The Reddit Content Retrieval Skill allows you to programmatically access and retrieve various types of content from Reddit, such as posts, comments, subreddit details, and user profiles, using its public JSON API.

### Do I need an API key to use this skill?

No, you do not need an API key. This skill leverages Reddit's public JSON API, which does not require authentication for basic content retrieval.

### What kind of Reddit content can I retrieve?

You can retrieve subreddit posts (hot, new, top, rising, controversial), search for posts by keywords, get detailed subreddit information, fetch individual posts with their comments, and access user profiles including their recent posts.

### How can I sort the retrieved Reddit posts?

Posts can be sorted by 'hot' (default), 'new', 'top', 'rising', or 'controversial'. For 'top' and 'controversial' sorts, you can also specify timeframes like hour, day, week, month, year, or all time.

### Is there a rate limit for using the Reddit public JSON API?

Yes, Reddit's public JSON API has a rate limit of 100 requests per minute. It's important to respect this limit to ensure continued access.

### Can I get comments for a specific post?

Yes, you can retrieve a specific post by its ID and also specify the number of comments you wish to fetch along with it.
