reddit

name	reddit
description	Search Reddit and browse subreddit posts using the public JSON API. Use when you need to find Reddit discussions, community reactions, or story leads from specific subreddits.

Reddit

Search Reddit, browse subreddit top posts, and read individual posts with comments. No API key required.

Tool

Use reddit.js from this skill directory:

node reddit.js <command> [options]

Commands

Search all of Reddit

reddit.js search "query" [-n count] [-t period] [-s sort]

Top posts from a subreddit

reddit.js top <subreddit> [-n count] [-t period]

Read a post with top comments

reddit.js post <url> [-c comment_count]

Options

Flag	Default	Values
-n	10	Number of results (max 100)
-t	year	hour, day, week, month, year, all
-s	top	relevance, hot, top, new, comments
-c	5	Number of comments to show

Output

Each post shows: score, comment count, title, subreddit, author, date, link, and a text preview. The post command additionally shows top comments with scores.

Notes

• Rate limiting: Reddit rate-limits unauthenticated requests. Add a small delay between rapid successive calls if needed.
• Search relevance: Global search can be noisy. Subreddit-specific top browsing tends to surface better results for niche research.
• Subreddit names: Pass without the r/ prefix (e.g., cybersecurity not r/cybersecurity).