English Français العربية

io.github.shubhamekapure/social-search-mcp

Official registry Search and web

Deep social media search for LLMs: Facebook, Reddit, LinkedIn, Instagram & more.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package social-search-mcp
Claude Code 
claude mcp add social-search-mcp -e 'SEARCH_PROVIDER=<SEARCH_PROVIDER>' -e 'SERPER_API_KEY=<your serper_api_key>' -e 'SEARXNG_URL=<SEARXNG_URL>' -- uvx social-search-mcp==0.1.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "social-search-mcp": {
            "command": "uvx",
            "args": [
                "social-search-mcp==0.1.3"
            ],
            "env": {
                "SEARCH_PROVIDER": "<SEARCH_PROVIDER>",
                "SERPER_API_KEY": "<your serper_api_key>",
                "SEARXNG_URL": "<SEARXNG_URL>"
            }
        }
    }
}

Environment variables

  • SEARCH_PROVIDER Search backend: 'serper', 'searxng', or 'google'. Default: searxng
  • SERPER_API_KEY secret API key from serper.dev. Required if SEARCH_PROVIDER=serper.
  • SEARXNG_URL URL of your SearXNG instance. Default: http://localhost:8080

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Social Search MCP Server
  2. Overview
  3. Search Providers
  4. Setup
  5. Usage with Claude Desktop

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=searxng
  • SEARXNG_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=serper
  • SERPER_API_KEY=your_key (Get one from Serper.dev)

The official Google Custom Search API.

  • SEARCH_PROVIDER=google
  • GOOGLE_API_KEY=your_key
  • GOOGLE_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.

Frequently asked questions

What is io.github.shubhamekapure/social-search-mcp?

Deep social media search for LLMs: Facebook, Reddit, LinkedIn, Instagram & more.

How do I install io.github.shubhamekapure/social-search-mcp?

It runs on your machine. In Claude Code: claude mcp add social-search-mcp -e 'SEARCH_PROVIDER=<SEARCH_PROVIDER>' -e 'SERPER_API_KEY=<your serper_api_key>' -e 'SEARXNG_URL=<SEARXNG_URL>' -- uvx social-search-mcp==0.1.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.shubhamekapure/social-search-mcp need an API key?

Yes. It expects SERPER_API_KEY, which you set in its configuration.

Is io.github.shubhamekapure/social-search-mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.shubhamekapure/social-search-mcp?

It is published by shubhamekapure. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.