| name | reddit-researcher |
| version | 1.0.0 |
| description | Search and read public Reddit posts, subreddits, and comments via the unauthenticated JSON API. Safe read-only access with SSRF-prevention hostname allowlist. |
| category | integration |
| trigger | when user wants to research Reddit discussions, find posts in a subreddit, search Reddit for topics, read Reddit comments, or gather community sentiment from Reddit |
| tools | ["WebFetch","WebSearch"] |
| dependencies | [] |
| tags | ["reddit","research","social-media","integration","read-only","public-api"] |
| model | sonnet |
| invoked_by | both |
| user_invocable | true |
| error_handling | graceful |
| verified | false |
| source | builtin |
| trust_score | 100 |
| provenance_sha | 9af60d6bb6fffa11 |
Reddit Researcher Skill
Purpose
Fetch and analyze public Reddit content without authentication using the Reddit public JSON API. Enables research agents to read subreddit posts, search Reddit globally or within a subreddit, and fetch individual post comments — all through the stable .json endpoint pattern.
No API key. No OAuth. No registration. Reddit's public JSON API is accessible anonymously for read-only operations.
When to Use
- Researching community sentiment on a topic
- Finding relevant discussions in a specific subreddit
- Gathering examples, opinions, or use cases from Reddit
- Monitoring a subreddit for recent posts
- Fetching comments on a specific post for analysis
Iron Laws
- ALWAYS validate Reddit URLs against the allowlist before WebFetch — only
reddit.com, www.reddit.com, and old.reddit.com are permitted; reject anything else to prevent SSRF attacks.
- ALWAYS append
.json to Reddit URLs before fetching — never fetch HTML pages; the .json suffix returns structured data that can be parsed reliably.
- ALWAYS include a User-Agent header — Reddit blocks requests without a proper User-Agent; use
agent-studio-reddit-researcher/1.0.
- NEVER make more than 10 WebFetch calls per minute — unauthenticated rate limit is 10 req/min; add 1-2 second delays for multi-call workflows; search endpoints are more restrictive (~3-5 req/min).
- NEVER write to Reddit — this skill is strictly read-only; no POST requests, no upvoting, no commenting, no authentication flows.
API Reference
| Endpoint | Description | Notes |
|---|
https://www.reddit.com/r/{sub}.json | Hot posts in subreddit | Default sort: hot |
https://www.reddit.com/r/{sub}/hot.json | Hot posts (explicit) | |
https://www.reddit.com/r/{sub}/new.json | New posts | |
https://www.reddit.com/r/{sub}/top.json?t=week | Top posts by time | t=hour/day/week/month/year/all |
