reddit-reader

Search Reddit posts and comments via OAuth2 API calls.

2|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/imsatoshi/bot_article --skill reddit-reader-imsatoshi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reddit-reader
Source: https://github.com/imsatoshi/bot_article/tree/main/skills/reddit-skill
Command: npx skills add https://github.com/imsatoshi/bot_article --skill reddit-reader-imsatoshi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

It solves the problem of finding relevant Reddit discussions and quickly understanding what people are saying without manually browsing posts and comment threads.

Core Features & Use Cases

It helps you search across all Reddit or within a specific subreddit with time and sort filters, list posts by category, read full post details plus a nested comment tree, and fetch subreddit metadata for context. Common use cases include gathering community sentiment on topics like “AI agents”, tracking recent trends in a subreddit such as r/ClaudeAI, and summarizing what contributors think from both the post and top comments.

Quick Start

Ask: “Search Reddit for Claude Code discussions from the last week sorted by hot and return the top 15 posts with links and previews.”

Frequently Asked Questions about reddit-reader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search and summarize Reddit discussions using natural language?

You can filter Reddit searches by sort order and time range to scan trends. The Skill applies query filters to OAuth2 API calls, allowing you to list posts by category, discover recent trends within specific subreddits, and fetch subreddit metadata for context.

Do I need API credentials to read subreddit posts and comments?

Yes, you can gather community sentiment on specific topics by reading full post details and nested comment trees. The Skill searches across all Reddit or within a specific subreddit, applying time and sort filters to summarize what contributors think from both the post body and top comments.

What's the best way to extract subreddit insights and recent trends?

You can filter Reddit searches by sort order and time range to scan trends. The Skill applies query filters to OAuth2 API calls, allowing you to list posts by category, discover recent trends within specific subreddits, and fetch subreddit metadata for context.

Do I need API credentials to read subreddit posts and comments?

Yes, reading subreddit posts requires REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET environment variables. The Python requests-based client uses these OAuth2 credentials to authenticate API calls, handle pagination, and maintain read-only access for fetching post details and nested comment trees.

Can I get structured Markdown output from Reddit post bodies and comment trees?

Yes, Reddit post bodies and nested comment trees are formatted into structured Markdown. After fetching content via OAuth2 API calls, the Skill applies structured Markdown summarization to organize post details and nested comments for easy reading and analysis.