io.github.shubhamekapure/social-search-mcp
Deep social media search for LLMs: Facebook, Reddit, LinkedIn, Instagram & more.
Ask AI about io.github.shubhamekapure/social-search-mcp
Powered by Claude · Grounded in docs
I know everything about io.github.shubhamekapure/social-search-mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Social Search MCP Server
A Model Context Protocol (MCP) server that empowers LLMs to search across specific social media platforms using the industry's best search engines.
Overview
This server provides a search_social tool that accepts a query and an optional list of platforms (facebook, reddit, linkedin, etc.). It filters results exclusively to those domains and returns them directly to the LLM context.
Search Providers
You can configure the backend by setting the SEARCH_PROVIDER environment variable. By default, it uses SearXNG since it is free and open-source.
1. SearXNG (Default)
SearXNG is a free, open-source internet metasearch engine.
SEARCH_PROVIDER=searxngSEARXNG_URL=http://localhost:8080(Defaults to localhost, specify a remote public instance if you don't host your own, but note that public instances often limit automated JSON requests).
2. Serper.dev
A powerful Google Search wrapper API. Highly recommended for accurate results.
SEARCH_PROVIDER=serperSERPER_API_KEY=your_key(Get one from Serper.dev)
3. Google Custom Search
The official Google Custom Search API.
SEARCH_PROVIDER=googleGOOGLE_API_KEY=your_keyGOOGLE_CX=your_cx_engine_id
Setup
Ensure you have Python 3.10+ installed.
# Clone or place in a directory, then:
python -m venv venv
source venv/bin/activate
pip install -e .
Usage with Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"social-search-mcp": {
"command": "/ABSOLUTE/PATH/TO/venv/bin/social-search-mcp",
"args": [],
"env": {
"SEARCH_PROVIDER": "searxng",
"SEARXNG_URL": "http://localhost:8080"
}
}
}
}
Replace /ABSOLUTE/PATH/TO/ with the actual path to this folder. Restart Claude Desktop after updating the config.
