Social Search Mcp

io.github.shubhamekapurePublished by GitHub account shubhamekapurev0.1.3Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyWeb Search & ScrapingCommunication & Collaboration

Overview

AI-generated overview

Lets an assistant run web searches restricted to social media domains such as Facebook, Reddit, LinkedIn and Instagram.

What you can do
Exposes a search_social tool that takes a query and an optional list of platforms, then filters results to those social domains and returns them to the model's context. The search backend is configurable: SearXNG by default, or Serper.dev or Google Custom Search. It runs locally over stdio and is intended for desktop MCP clients.
When to use it
Useful when an assistant needs social media posts, discussions or profiles rather than general web results, for example researching community sentiment on Reddit or public LinkedIn and Facebook content. Not needed if you only require ordinary web search.
Requirements
Python 3.10+ and a local install of the social-search-mcp package. A reachable SearXNG instance via SEARXNG_URL (defaults to localhost:8080), or SERPER_API_KEY when SEARCH_PROVIDER=serper, or GOOGLE_API_KEY and GOOGLE_CX for the Google provider. Network access to the chosen backend.
Before you install
The Serper and Google providers require API keys (SERPER_API_KEY, GOOGLE_API_KEY) that may be billed per request, so usage can cost money. Queries are sent to the configured third-party search backend, and public SearXNG instances often limit automated JSON requests. No write or delete actions are described.

Installation

In SourceWeft

  1. Open Social Search Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

bash
# Clone or place in a directory, then:python -m venv venvsource venv/bin/activatepip install -e .

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

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.

Source: README.md at commit 0c6a9dc

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.3LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.