reddit_skill

This skill retrieves posts, comments, subreddit data, and user profiles from Reddit using the public JSON API to inform research and content discovery.

Python

472

GitHub Stars

1

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill resciencelab/opc-skills --skill reddit

SKILL.md2.0 KB

Overview

This skill lets you search and retrieve content from Reddit using the public JSON API without requiring an API key. It fetches subreddit details, posts, comments, and user profiles and supports common Reddit sorting and time filters. Use it to quickly surface discussion, evidence, or community sentiment for research, content, or moderation tasks.

How this skill works

The skill appends .json to Reddit URLs and issues unauthenticated HTTP requests to fetch structured JSON for subreddits, posts, comments, and user profiles. It supports sorting (hot, new, top, rising, controversial) and time ranges for top/controversial queries, plus keyword and subreddit-scoped searches. Rate limits are respected (about 100 requests/minute) and responses are parsed into concise results for downstream use.

When to use it

You need recent posts or trending discussions from a subreddit (e.g., r/python).
You want to search Reddit for keyword mentions or community reactions.
You need post details and comments for research, moderation, or content sourcing.
You want basic user profile info and recent activity without OAuth.
You need to gather community sentiment or examples for SEO and content planning.

Best practices

Respect rate limits: batch requests and add delays to avoid hitting 100 req/min.
Use sorting and time filters to narrow results (e.g., top + week for evergreen content).
Limit comment depth and pagination to keep responses compact and fast.
Sanitize and deduplicate results when aggregating from multiple subreddits or searches.
Cache frequent queries to reduce requests and improve responsiveness.

Example use cases

Fetch hot posts from a niche subreddit to find topics for new articles or videos.
Search Reddit for user experiences about a product or feature to inform UX decisions.
Retrieve a post and its top comments to use as source material for a report or quote.
Collect subreddit stats and descriptions for competitor or community analysis.
Pull recent posts from a user to review activity patterns or contributions.

FAQ

No. The skill uses Reddit's public JSON endpoints, which are accessible without authentication for basic reads.

How do I control sorting and time ranges?

Use the sort parameter (hot, new, top, rising, controversial) and, for top/controversial, specify a time range like hour, day, week, month, year, or all.

What are common rate limits and how should I handle them?

Plan for roughly 100 requests per minute. Batch requests, implement backoff, and cache results to avoid throttling.