Skip to main content

Reddit, Twitter, LinkedIn, BlackHatWorld, Dev.to, Medium & Google Trends/News MCP server for AI tools. Markdown output, reads your Chrome login session.

Project description

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

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

Add to your AI tool

Claude Code:

claude mcp add supermcp -- supermcp

Cursor: Add to settings.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:

## 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

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

supermcp-0.9.2.tar.gz (163.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

supermcp-0.9.2-py3-none-any.whl (32.7 kB view details)

Uploaded Python 3

File details

Details for the file supermcp-0.9.2.tar.gz.

File metadata

  • Download URL: supermcp-0.9.2.tar.gz
  • Upload date:
  • Size: 163.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for supermcp-0.9.2.tar.gz
Algorithm Hash digest
SHA256 27f2a9a2867b9a55c24949f795a0436a742f14c55082e3f0f5ff74576c90dace
MD5 822ed8961fd1dcd06debe47e9c432ec9
BLAKE2b-256 a4b3cf4365a1fa2f5a018ad147f10d8d86cbcbc436b1965f3166aba5f7e0a10c

See more details on using hashes here.

File details

Details for the file supermcp-0.9.2-py3-none-any.whl.

File metadata

  • Download URL: supermcp-0.9.2-py3-none-any.whl
  • Upload date:
  • Size: 32.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for supermcp-0.9.2-py3-none-any.whl
Algorithm Hash digest
SHA256 8deeffac035e60e2551b15491c44d673ddf7781be7ebde191743210f47393e02
MD5 31a3fc44f7cc3bd7a92c71be830fc8c3
BLAKE2b-256 01569a2ef33d02b83f614a62884f547dbeac277f73b2d571273d66c091fb7566

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page