# Reddit Public JSON MCP Server

A specialized Model Context Protocol (MCP) server designed for YouTube creators, audience researchers, and AI agents. It extracts public discussions, emerging questions, and community pain points directly from Reddit without requiring developer API credentials.

## 🚀 Key Features

1. **
eddit_browse_subreddit**
   - Explores posts from any public subreddit (
/technology, 
/ArtificialInteligence, 
/SaaS, etc.).
   - Supports sorting modes (hot, 	op, 
ew, 
ising) and time filters (day, week, month, year, ll).
   - Cleans HTML markup into plain, LLM-ready text with permalinks and metadata.

2. **
eddit_search_discussions**
   - Real-time search across 
/all or within a specific target community.
   - Intelligent rate-limit handling with automatic x-ratelimit-reset negotiation.

3. **
eddit_get_post_and_comments**
   - Retrieves full post contents along with top discussions and community comments.
   - Extracts genuine sentiment, unanswered questions, and user feedback.

4. **
eddit_viral_ideas_generator**
   - Transforms community pain points into structured YouTube video concepts:
     - Suggested high-CTR titles (*" La Verdad sobre...\*).
 - Hook script based on real community debates.
 - 4-part video outline ready for scripting and production.

## 🛠️ Architecture & Resilience

- **Runtime:** Node.js (v20+ or v24+ with native --experimental-strip-types)
- **Protocol:** Model Context Protocol (MCP) via @modelcontextprotocol/sdk
- **Rate-Limit Engine:** Compliant Reddit user-agent formatting, in-memory TTL caching (120s), and automatic pause/retry on x-ratelimit-reset.
- **Zero API Keys:** Completely independent of developer portal credentials.

## 📦 Installation & Setup

`ash
# Clone the repository
git clone https://github.com/ramedina-ia/reddit-public-json-mcp.git
cd reddit-public-json-mcp

# Install dependencies
npm install

# Run tests
npm test

# Run MCP server
npm run dev
`

### Claude Desktop / Antigravity MCP Configuration

Add to your mcp_config.json:

`json
{
 mcpServers: {
 reddit-public-json-mcp: {
 command: cmd.exe,
 args: [/c, path\\to\\reddit-public-json-mcp\\run.cmd]
 }
 }
}
`

## 📄 License

MIT License. Developed by Ramiro Medina.