supermcp

# 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. **Includes [LinkedIn MCP](#linkedin-mcp), [Reddit MCP](#reddit-mcp), [Twitter MCP (X)](#twitter--x-mcp), [Medium MCP](#medium-mcp), [Dev.to MCP](#devto-mcp), [BlackHatWorld MCP](#blackhatworld-mcp), and [Google Trends/News MCP](#google-trends--news-mcp) — all in one install.** ## 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 MCP Search Reddit, read posts with their comment trees, list subreddit feeds (hot/top/new/rising), and pull a user's recent activity — all without registering a Reddit API app or paying for the new API tiers. Reads your existing reddit.com Chrome session. | 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 MCP Search tweets, fetch a tweet plus its reply tree, and pull a user's recent timeline. Bypasses the X API's $200/month minimum tier — uses your existing x.com Chrome session. | 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 MCP LinkedIn pain-point mining and B2B research from inside Claude or Cursor. Search posts by keyword, pull your algorithmic home feed, and read comments on any specific post — without LinkedIn's enterprise Marketing API, Phantombuster, or any paid scraper. Uses your linkedin.com Chrome session. | 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 | **Use cases:** B2B pain-point mining ("find SaaS founders complaining about onboarding"), competitor research, prospecting, content-trend monitoring, audience research. ### Dev.to MCP Search Dev.to articles via Algolia, fetch trending posts, and pull article comment threads. No login needed — uses Dev.to's public API. | 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 MCP Search Medium articles (login recommended for full results), and follow tag/user feeds via RSS — no Medium Partner API required. | 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 MCP Mine SEO, affiliate, and digital-marketing pain points from BlackHatWorld threads. Headless browser handles Cloudflare; structured metadata included. | 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 MCP Trending search terms by region, Google News search, and topical news feeds — all without API keys. | 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). ## FAQ **What is a LinkedIn MCP server?** An MCP (Model Context Protocol) server that lets Claude, Cursor, or any MCP-compatible AI tool read LinkedIn directly — search posts, pull your feed, fetch comments. SuperMCP's LinkedIn MCP uses your existing LinkedIn login session in Chrome, so there are no API keys to register and no OAuth flow. **How is this different from Phantombuster, Apify, or the LinkedIn Marketing API?** The LinkedIn Marketing API is enterprise-gated (you need an approved use case). Phantombuster starts at $69/month. Apify and Bright Data charge per request. SuperMCP runs locally on your machine using your own session — $0 for 100 requests/day, $9 one-time for unlimited. **Does the Reddit MCP need a Reddit API key?** No. The Reddit MCP uses your existing reddit.com Chrome session. No client secret, no OAuth refresh tokens, no API tier limits. **Does the Twitter / X MCP need an X API subscription?** No. The X API now starts at $200/month for the Basic tier. SuperMCP's Twitter MCP uses your existing x.com Chrome session — no subscription needed. **Which AI tools support this?** Any MCP-compatible client: Claude Desktop, Claude Code, Cursor, Windsurf, Cline, GitHub Copilot Agent, Continue, and others. SuperMCP is a standard stdio MCP server. **Is it open source?** Yes — MIT licensed. Audit the code yourself before installing (recommended for any tool that touches your browser session). **Where do I get an API key?** Run `supermcp setup` after `pip install supermcp`. Free tier (100 requests/day) is automatic. Unlimited tier is $9 one-time at [webmatrices.com/supermcp](https://webmatrices.com/supermcp). ## Made by [Webmatrices](https://webmatrices.com)