Is Social Search free?

Yes, Social Search is free to use.

How do I install Social Search?

Social Search is a local plugin. Install it using PyPI package: social-search-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Social Search need?

Social Search requires the following credentials or environment variables: SEARCH_PROVIDER, SERPER_API_KEY, SEARXNG_URL. You can find setup instructions on the server detail page.

What AI apps work with Social Search?

Social Search uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Social Search MCP Server

by Shubham Ekapure

Developer ToolsUse Caution4.0Local

Free

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

About

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

Security Report

4.0

Use Caution4.0High Risk

Valid MCP server (2 strong, 1 medium validity signals). 9 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.

10 files analyzed · 10 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Search backend: 'serper', 'searxng', or 'google'. Default: searxngOptional

Environment variable: SEARCH_PROVIDER

API key from serper.dev. Required if SEARCH_PROVIDER=serper.Required

Environment variable: SERPER_API_KEY

URL of your SearXNG instance. Default: http://localhost:8080Optional

Environment variable: SEARXNG_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-shubhamekapure-social-search-mcp": {
      "env": {
        "SEARXNG_URL": "your-searxng-url-here",
        "SERPER_API_KEY": "your-serper-api-key-here",
        "SEARCH_PROVIDER": "your-search-provider-here"
      },
      "args": [
        "social-search-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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)

3. Google Custom Search

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.