Agent skill
Search and retrieve content from Reddit. Get posts, comments, subreddit info, and user profiles via the public JSON API. Use when user mentions Reddit, a subreddit, or r/ links.
Install this agent skill to your Project
npx add-skill https://github.com/ReScienceLab/opc-skills/tree/main/skills/reddit
SKILL.md
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:
cd <skill_directory>
python3 scripts/get_posts.py python --limit 3
Commands
All commands run from the skill directory.
Subreddit Posts
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
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
python3 scripts/get_subreddit.py python
python3 scripts/get_subreddit.py ClaudeAI
Post & Comments
python3 scripts/get_post.py abc123 # Get post by ID
python3 scripts/get_post.py abc123 --comments 50 # With more comments
User Profile
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
.jsonto any Reddit URL - Rate Limit: 100 requests/minute
- Docs: https://www.reddit.com/dev/api
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
skill-name
Clear description of what this skill does and when to use it. Include trigger keywords and contexts inline, e.g. "Use when user wants to X, Y, or Z."
seo-geo
SEO & GEO (Generative Engine Optimization) for websites. Analyze keywords, generate schema markup, optimize for AI search engines (ChatGPT, Perplexity, Gemini, Copilot, Claude) and traditional search (Google, Bing). Use when user wants to improve search visibility.
add-new-opc-skill
Checklist and automation guide for adding a new skill to the OPC Skills project. Ensures all required files, metadata, logos, and listings are created before release. Use when adding a new skill, publishing a skill, or preparing a skill for release.
archive
Archive session learnings, debugging solutions, and deployment logs to .archive/yyyy-mm-dd/ as indexed markdown with searchable tags. Use when completing a significant task, resolving a tricky bug, deploying, or when the user says "archive this". Maintains .archive/MEMORY.md index for cross-session knowledge reuse.
banner-creator
Create banners using AI image generation. Discuss format/style, generate variations, iterate with user feedback, crop to target ratio. Use when user wants to create a banner, header, hero image, cover image, GitHub banner, Twitter header, or readme banner.
seo-geo
SEO & GEO (Generative Engine Optimization) for websites. Analyze keywords, generate schema markup, optimize for AI search engines (ChatGPT, Perplexity, Gemini, Copilot, Claude) and traditional search (Google, Bing). Use when user wants to improve search visibility, search optimization, search ranking, AI visibility, ChatGPT ranking, Google AI Overview, indexing, JSON-LD, meta tags, or keyword research.
Didn't find tool you were looking for?