Metadata-Version: 2.4
Name: supermcp
Version: 0.9.2
Summary: Reddit, Twitter, LinkedIn, BlackHatWorld, Dev.to, Medium & Google Trends/News MCP server for AI tools. Markdown output, 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, LinkedIn, BlackHatWorld, Dev.to, Medium, and Google Trends/News — one MCP server for Claude Code, Cursor, and any AI tool that speaks MCP.

Uses your Chrome login session automatically — no API keys, no OAuth dance, no manual cookie copying. Just be logged into the sites you want to read 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, FastMCP)
                          │
                          ├── Playwright (headless Chromium)
                          │     ├── reddit.com         (Chrome login)
                          │     ├── x.com              (Chrome login)
                          │     ├── linkedin.com       (Chrome login)
                          │     ├── medium.com         (Chrome login, search only)
                          │     └── blackhatworld.com  (no login, search via browser)
                          │
                          └── Direct httpx (no browser)
                                ├── dev.to API + Algolia search
                                ├── Medium RSS feeds (tag, user)
                                ├── BlackHatWorld threads + RSS
                                ├── Google Trends   (trendspy)
                                └── Google News     (gnews)
```

No browser extension. No WebSocket bridge. SuperMCP launches a headless Chromium and reuses your existing Chrome cookies for sites that need login.

All tools return **token-efficient markdown** (~35% smaller than JSON, native to Claude) with stable IDs and URLs so the LLM can chain follow-up calls.

## Tools (26 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 / X
| 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 |

### LinkedIn
| Tool | Description |
|------|-------------|
| `linkedin_search` | Search posts by keyword (great for pain-point research) |
| `linkedin_feed` | Posts from your home feed |
| `linkedin_post_comments` | Comments on a specific post |

### Dev.to
| Tool | Description |
|------|-------------|
| `devto_search` | Search articles via Algolia |
| `devto_trending` | Trending articles (overall or by tag) |
| `devto_article` | Article + nested comments |
| `devto_user_articles` | A user's published articles |

### Medium
| Tool | Description |
|------|-------------|
| `medium_search` | Search articles (login recommended) |
| `medium_tag_feed` | Latest articles by tag (RSS, no login) |
| `medium_user_feed` | A user's latest articles (RSS, no login) |

### BlackHatWorld
| Tool | Description |
|------|-------------|
| `bhw_search` | Search posts (SEO/affiliate/marketing pain points) |
| `bhw_get_thread` | Thread with OP + replies, structured metadata |
| `bhw_latest` | Latest posts site-wide via RSS |

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

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

## Output format

Every tool returns markdown structured like this:

```markdown
## Post 1 · r/buildinpublic
**Built my SaaS in 3 weekends, hit $5k MRR**
by u/alice · 542↑ · 87💬 · 2026-04-29 · flair: AMA
https://reddit.com/r/buildinpublic/comments/abc123/built/
**id:** abc123

I had this idea for...
```

Stable IDs and URLs are always preserved so Claude can chain follow-up calls
(`reddit_get_post(post_id="abc123")` to read full comments). Errors begin with
`**Error:**` for easy detection.

## Pricing

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

## Troubleshooting

- **"No API key"** — Run `supermcp setup` to get your key.
- **Reddit/Twitter/LinkedIn 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.
- **BHW search returns nothing** — Cloudflare occasionally rate-limits the headless browser. Retry, or use `bhw_latest` + `bhw_get_thread` to drill down manually.

## Privacy

SuperMCP runs entirely on your machine. Cookies stay in Chrome — they're read fresh from disk each request and never leave your laptop. The only network call to Webmatrices is the API key validation (so we can rate-limit the free tier).

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