Metadata-Version: 2.4
Name: social-trends-mcp-server
Version: 0.1.0
Summary: MCP-Server der AI-Agents Zugriff auf Social-Media-Trends gibt (Reddit, HackerNews)
Project-URL: Homepage, https://github.com/AiAgentKarl/social-trends-mcp-server
Project-URL: Repository, https://github.com/AiAgentKarl/social-trends-mcp-server
Project-URL: Issues, https://github.com/AiAgentKarl/social-trends-mcp-server/issues
Author: AiAgentKarl
License: MIT
License-File: LICENSE
Keywords: ai-agent,hackernews,mcp,reddit,social-media,tech-pulse,trending-topics,trends
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Description-Content-Type: text/markdown

# Social Trends MCP Server

MCP server that gives AI agents access to trending topics from **Reddit** and **HackerNews** — both using free, public APIs with no authentication required.

## Tools (6)

| Tool | Description |
|------|-------------|
| `get_trending_hackernews` | Top HN stories with title, score, comments, URL |
| `get_subreddit_hot` | Hot posts from any subreddit |
| `search_reddit` | Search across all of Reddit |
| `get_trending_topics` | Aggregated trends from HN + Reddit front page |
| `get_tech_pulse` | Quick pulse: top 5 from HN + r/technology + r/programming |
| `search_mentions` | Check if a topic is being discussed on HN or Reddit |

## Installation

```bash
pip install social-trends-mcp-server
```

## Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "social-trends": {
      "command": "social-trends-server"
    }
  }
}
```

## Usage with Claude Code

```bash
claude mcp add social-trends -- social-trends-server
```

## Examples

**"What's trending on HackerNews right now?"**
→ Uses `get_trending_hackernews`

**"Give me a tech pulse"**
→ Uses `get_tech_pulse` — top 5 from HN, r/technology, r/programming

**"Is anyone talking about Rust on social media?"**
→ Uses `search_mentions("Rust")` — searches HN + Reddit

**"What's hot on r/machinelearning?"**
→ Uses `get_subreddit_hot("machinelearning")`

## Data Sources

- **Reddit** — Public JSON API (no auth required)
- **HackerNews** — Firebase REST API (no auth required)
- **HN Search** — Algolia API (no auth required)

## No API Keys Needed

This server uses only public, free APIs. No configuration or API keys required.

## License

MIT
