SerpApi MCP

आधिकारिक

Google और अन्य सर्च इंजन परिणामों के लिए SerpApi MCP सर्वर

GitHub

165

SerpApi MCP के साथ आप क्या कर सकते हैं?

एक साथ कई सर्च इंजनों पर खोजें — search टूल में params.engine सेट करके Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay और अन्य पर एक ही क्वेरी चलाएँ।
रीयल-टाइम मौसम और स्टॉक डेटा प्राप्त करें — “weather in London” या “AAPL stock” जैसी प्राकृतिक क्वेरी का उपयोग करके स्थान के अनुसार वर्तमान मौसम या कंपनी के वित्तीय आंकड़े पूछें।
संक्षिप्त या पूर्ण JSON परिणाम प्राप्त करें — mode पैरामीटर से प्रतिक्रिया का आकार नियंत्रित करें, पूर्ण विवरण या सारांशित परिणाम प्राप्त करने के लिए।
परिणामों को इंटरैक्टिव तालिका या डैशबोर्ड के रूप में देखें — search_table या search_dashboard का उपयोग करके खोज परिणामों को MCP होस्ट में सॉर्ट करने योग्य UI के रूप में प्रस्तुत करें।
उपलब्ध इंजन और उनके पैरामीटर खोजें — serpapi://engines और serpapi://engines/<engine> पर MCP संसाधनों के माध्यम से प्रति-इंजन पैरामीटर स्कीमा तक पहुँचें।

दस्तावेज़

SerpApi MCP सर्वर

एक मॉडल संदर्भ प्रोटोकॉल (MCP) सर्वर कार्यान्वयन जो व्यापक खोज इंजन परिणामों और डेटा निष्कर्षण के लिए SerpApi के साथ एकीकृत होता है।

विशेषताएँ

बहु-इंजन खोज: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay, और अधिक
इंजन संसाधन: MCP संसाधनों के माध्यम से प्रति-इंजन पैरामीटर स्कीमा उपलब्ध (खोज उपकरण देखें)
वास्तविक समय मौसम डेटा: खोज प्रश्नों के माध्यम से पूर्वानुमान के साथ स्थान-आधारित मौसम
शेयर बाज़ार डेटा: खोज एकीकरण के माध्यम से कंपनी वित्तीय और बाज़ार डेटा
गतिशील परिणाम प्रसंस्करण: विभिन्न परिणाम प्रकारों का स्वचालित रूप से पता लगाता है और उन्हें प्रारूपित करता है
लचीली प्रतिक्रिया मोड: पूर्ण या संक्षिप्त JSON प्रतिक्रियाएँ
JSON प्रतिक्रियाएँ: पूर्ण या संक्षिप्त मोड के साथ संरचित JSON आउटपुट
इंटरैक्टिव UI (MCP ऐप्स): वैकल्पिक search_table और search_dashboard उपकरण जो समर्थन करने वाले होस्ट में एक इंटरैक्टिव UI के रूप में परिणाम प्रस्तुत करते हैं

त्वरित शुरुआत

SerpApi MCP सर्वर mcp.serpapi.com पर एक होस्टेड सेवा के रूप में उपलब्ध है। इससे जुड़ने के लिए, आपको एक API कुंजी प्रदान करनी होगी। आप अपनी API कुंजी अपने SerpApi डैशबोर्ड पर पा सकते हैं।

आप होस्टेड सर्वर का उपयोग करने के लिए Claude Desktop को कॉन्फ़िगर कर सकते हैं:

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

आप इन MCP क्लाइंट में होस्टेड सर्वर भी जोड़ सकते हैं:

OpenClaw

openclaw mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp --transport streamable-http

Claude Code

claude mcp add --transport http serpapi https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp

Hermes

hermes mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp

Codex

codex mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp

स्व-होस्टिंग

git clone https://github.com/serpapi/serpapi-mcp.git
cd serpapi-mcp
uv sync && uv run src/server.py

Claude Desktop कॉन्फ़िगर करें:

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "http://localhost:8000/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

अपनी API कुंजी प्राप्त करें: serpapi.com/manage-api-key

प्रमाणीकरण

दो विधियाँ समर्थित हैं:

पथ-आधारित: /YOUR_API_KEY/mcp (अनुशंसित)
हेडर-आधारित: Authorization: Bearer YOUR_API_KEY

उदाहरण:

# Path-based
curl "https://mcp.serpapi.com/your_key/mcp" -d '...'

# Header-based  
curl "https://mcp.serpapi.com/mcp" -H "Authorization: Bearer your_key" -d '...'

खोज उपकरण

MCP सर्वर में एक मुख्य खोज उपकरण है जो सभी SerpApi इंजन और परिणाम प्रकारों का समर्थन करता है। आप सभी उपलब्ध पैरामीटर SerpApi API संदर्भ पर पा सकते हैं। इंजन पैरामीटर स्कीमा MCP संसाधनों के रूप में भी उजागर होते हैं: serpapi://engines (सूचकांक) और serpapi://engines/<engine>।

आप जो पैरामीटर प्रदान कर सकते हैं वे प्रत्येक API इंजन के लिए विशिष्ट हैं। कुछ नमूना पैरामीटर नीचे दिए गए हैं:

params.q (आवश्यक): खोज प्रश्न
params.engine: खोज इंजन (डिफ़ॉल्ट: "google_light")
params.location: भौगोलिक फ़िल्टर
mode: प्रतिक्रिया मोड - "complete" (डिफ़ॉल्ट) या "compact"
...अन्य पैरामीटर SerpApi API संदर्भ पर देखें

उदाहरण:

{"name": "search", "arguments": {"params": {"q": "coffee shops", "location": "Austin, TX"}}}
{"name": "search", "arguments": {"params": {"q": "weather in London"}}}
{"name": "search", "arguments": {"params": {"q": "AAPL stock"}}}
{"name": "search", "arguments": {"params": {"q": "news"}, "mode": "compact"}}
{"name": "search", "arguments": {"params": {"q": "detailed search"}, "mode": "complete"}}

समर्थित इंजन: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay, और अधिक (serpapi://engines देखें)।

परिणाम प्रकार: उत्तर बॉक्स, जैविक परिणाम, समाचार, चित्र, खरीदारी - स्वचालित रूप से पता लगाए और प्रारूपित किए गए।

इंटरैक्टिव UI (MCP ऐप्स)

डिफ़ॉल्ट search उपकरण JSON लौटाता है और अपरिवर्तित है। MCP ऐप्स एक्सटेंशन (SEP-1865) का समर्थन करने वाले होस्ट के लिए, दो वैकल्पिक उपकरण परिणामों को सीधे बातचीत में एक इंटरैक्टिव UI के रूप में प्रस्तुत करते हैं, ताकि भारी SERP JSON कभी मॉडल के संदर्भ विंडो में प्रवेश न करे:

search_table: जैविक परिणाम एक सॉर्ट करने योग्य, खोजने योग्य तालिका के रूप में।
search_dashboard: सारांश मेट्रिक्स, एक स्रोत-विभाजन चार्ट, और क्लिक-टू-एक्सपैंड विवरण पैनल के साथ एक परिणाम तालिका।

दोनों search के समान params स्वीकार करते हैं। जो होस्ट MCP ऐप्स का समर्थन नहीं करते वे बस इन उपकरणों को अनदेखा कर देते हैं।

बिना MCP होस्ट के स्थानीय रूप से उनका पूर्वावलोकन करें:

uv run fastmcp dev apps src/server.py

विकास

# Local development
uv sync && uv run src/server.py

# Docker
docker build -t serpapi-mcp . && docker run -p 8000:8000 serpapi-mcp

# Regenerate engine resources (Playground scrape)
python build-engines.py

# Testing with MCP Inspector
npx @modelcontextprotocol/inspector
# Configure: URL mcp.serpapi.com/YOUR_KEY/mcp, Transport "Streamable HTTP transport"

समस्या निवारण

"API कुंजी गुम": URL पथ /{YOUR_KEY}/mcp या हेडर Bearer YOUR_KEY में कुंजी शामिल करें
"अमान्य कुंजी": serpapi.com/dashboard पर सत्यापित करें
"दर सीमा पार": प्रतीक्षा करें या अपनी SerpApi योजना अपग्रेड करें
"कोई परिणाम नहीं": भिन्न प्रश्न या इंजन आज़माएँ

योगदान

रिपॉजिटरी को फोर्क करें
अपनी सुविधा शाखा बनाएँ: git checkout -b feature/amazing-feature
निर्भरताएँ स्थापित करें: uv install
अपने परिवर्तन करें
परिवर्तन कमिट करें: git commit -m 'Add amazing feature'
शाखा में पुश करें: git push origin feature/amazing-feature
एक पुल अनुरोध खोलें

लाइसेंस

MIT लाइसेंस - विवरण के लिए LICENSE फ़ाइल देखें।