English Français العربية

io.github.shubhamekapure/social-search-mcp

السجل الرسمي البحث والويب

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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 (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>"
            }
        }
    }
}

متغيرات البيئة

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو io.github.shubhamekapure/social-search-mcp؟

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

كيف أثبّت io.github.shubhamekapure/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.shubhamekapure/social-search-mcp إلى مفتاح API؟

نعم. يتطلب SERPER_API_KEY، وتضبطها في إعداداته.

هل io.github.shubhamekapure/social-search-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.shubhamekapure/social-search-mcp؟

ينشره shubhamekapure. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.