{
  "markdown": "# Social Search MCP Server\n\n<!-- mcp-name: io.github.shubhamekapure/social-search-mcp -->\nA Model Context Protocol (MCP) server that empowers LLMs to search across specific social media platforms using the industry's best search engines.\n\n## Overview\nThis 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.\n\n## Search Providers\n\nYou can configure the backend by setting the `SEARCH_PROVIDER` environment variable. By default, it uses **SearXNG** since it is free and open-source.\n\n### 1. SearXNG (Default)\nSearXNG is a free, open-source internet metasearch engine.\n- `SEARCH_PROVIDER=searxng`\n- `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).\n\n### 2. Serper.dev\nA powerful Google Search wrapper API. Highly recommended for accurate results.\n- `SEARCH_PROVIDER=serper`\n- `SERPER_API_KEY=your_key` (Get one from [Serper.dev](https://serper.dev/))\n\n### 3. Google Custom Search\nThe official Google Custom Search API.\n- `SEARCH_PROVIDER=google`\n- `GOOGLE_API_KEY=your_key`\n- `GOOGLE_CX=your_cx_engine_id`\n\n## Setup\nEnsure you have Python 3.10+ installed.\n\n```bash\n# Clone or place in a directory, then:\npython -m venv venv\nsource venv/bin/activate\npip install -e .\n```\n\n## Usage with Claude Desktop\n\nAdd this to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"social-search-mcp\": {\n      \"command\": \"/ABSOLUTE/PATH/TO/venv/bin/social-search-mcp\",\n      \"args\": [],\n      \"env\": {\n        \"SEARCH_PROVIDER\": \"searxng\",\n        \"SEARXNG_URL\": \"http://localhost:8080\"\n      }\n    }\n  }\n}\n```\nReplace `/ABSOLUTE/PATH/TO/` with the actual path to this folder. Restart Claude Desktop after updating the config.\n",
  "bytes": 1936,
  "sha": "b0d410e5bd32c2ceb3fffa7dac1487ce8b073193a0635161f675adec2e4bea94",
  "repo_slug": "shubhamekapure/social-search-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_shubhamekapure_social_search_m_56150a31/readme"
}