Metadata-Version: 2.4
Name: supermcp
Version: 0.6.0
Summary: Reddit, Twitter & Google Trends MCP server for AI tools. Reads your Chrome login session.
Requires-Python: >=3.10
Requires-Dist: fastmcp>=3.2.4
Requires-Dist: gnews>=0.4.3
Requires-Dist: httpx>=0.28.1
Requires-Dist: playwright>=1.58.0
Requires-Dist: pycookiecheat>=0.8.0
Requires-Dist: trendspy>=0.1.6
Description-Content-Type: text/markdown

# SuperMCP

Reddit, Twitter & Google Trends MCP server for Claude, Cursor, and AI tools.

Reads your Chrome login session automatically — no API keys, no tokens, no manual setup. Just be logged into Reddit and Twitter in Chrome.

## Install

```bash
pip install supermcp
supermcp setup          # get your API key, auto-installs Chromium
```

## Add to your AI tool

**Claude Code:**
```bash
claude mcp add supermcp -- supermcp
```

**Cursor:** Add to settings.json:
```json
{ "supermcp": { "command": "supermcp" } }
```

## How it works

```
Claude/Cursor ←stdio→ SuperMCP (Python)
                        ├── Playwright (headless Chromium)
                        │   ├── reddit.com (your Chrome cookies)
                        │   └── x.com (your Chrome cookies)
                        ├── trendspy (Google Trends via RSS)
                        └── gnews (Google News via RSS)
```

No browser extension. No WebSocket bridge. SuperMCP runs a headless Chromium that uses your existing Chrome login sessions.

## Tools (13 total)

### Reddit
| Tool | Description |
|------|-------------|
| `reddit_search` | Search all of Reddit |
| `reddit_search_subreddit` | Search within a specific subreddit |
| `reddit_get_post` | Get a post with its top comments |
| `reddit_get_subreddit_posts` | List posts (hot/top/new/rising) |
| `reddit_get_user_activity` | Get a user's recent posts and comments |

### Twitter
| Tool | Description |
|------|-------------|
| `twitter_search` | Search tweets |
| `twitter_get_tweet` | Get a tweet with its replies |
| `twitter_get_user_tweets` | Get a user's recent tweets |

### Google Trends & News
| Tool | Description |
|------|-------------|
| `trends_get_trending` | Get trending search terms by region |
| `news_search` | Search Google News by keyword |
| `news_top` | Get top/trending news stories |
| `news_by_topic` | Get news by topic (TECHNOLOGY, SPORTS, etc.) |

### Utility
| Tool | Description |
|------|-------------|
| `supermcp_status` | Check login status and source readiness |

## Pricing

- **Free:** 100 requests/day
- **Unlimited:** $9 at [webmatrices.com/supermcp](https://webmatrices.com/supermcp)

## Troubleshooting

- **"No API key"** — Run `supermcp setup` to get your key.
- **Reddit/Twitter errors** — Make sure you're logged into those sites in Chrome.
- **"Can't read Chrome cookies"** — Chrome must be installed. On macOS, grant Keychain access when prompted.

## Made by [Webmatrices](https://webmatrices.com)
