By disable-model-invocation: true 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.
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
topbrowsing tends to surface better results for niche research. - Subreddit names: Pass without the
r/prefix (e.g.,cybersecuritynotr/cybersecurity).