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.0.tar.gz (160.6 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.0-py3-none-any.whl (30.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: supermcp-0.9.0.tar.gz
  • Upload date:
  • Size: 160.6 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.0.tar.gz
Algorithm Hash digest
SHA256 0a175ab5b9c89be695945639ffdf939ad51aaee8ffed9e7c0730a9701b54d48b
MD5 e2ee34f4b0d5aa3b19684bf2d0441b4c
BLAKE2b-256 35210d0ff37b5aaf85cfa72b804a2be926f671b863d5fb0a5143a06217d4d363

See more details on using hashes here.

File details

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

File metadata

  • Download URL: supermcp-0.9.0-py3-none-any.whl
  • Upload date:
  • Size: 30.8 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ac4ddb1fa88d93c38c0c96badb30f98e35f23aa3b53f71310a9e4c5696a1a5c7
MD5 6e1441d31dcdba76f685877fe4559775
BLAKE2b-256 22e027342790c125a7b1482a0af90e562e84510765593d8fee9f99cb52c99a8e

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