Search1API

आधिकारिक

खोज, क्रॉलिंग और साइटमैप के लिए एक API

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

  • स्रोत फ़िल्टरिंग के साथ वेब खोज — search के माध्यम से वेब परिणाम मांगें, साइट के अनुसार सीमित करें, डोमेन बाहर करें, या पिछले दिन/महीने/वर्ष तक सीमित रखें।
  • समाचार खोज और पूर्ण-पाठ पुनर्प्राप्ति — हाल के लेख खोजने के लिए news का उपयोग करें, वैकल्पिक रूप से केवल शीर्षकों के बजाय पूर्ण सामग्री के लिए शीर्ष हिट्स को क्रॉल करें।
  • पृष्ठ सामग्री निष्कर्षण — जब खोज स्निपेट पर्याप्त न हों, तो पूर्ण पठनीय पाठ प्राप्त करने के लिए किसी भी URL को crawl पर पास करें।
  • साइट संरचना अन्वेषण — किसी डोमेन पर sitemap कॉल करें ताकि सभी संबंधित लिंक सूचीबद्ध हों और उसके पृष्ठों की खोज हो सके।
  • ट्रेंडिंग विषय निगरानी — GitHub या Hacker News पर वर्तमान हॉट आइटम के लिए trending क्वेरी करें।

दस्तावेज़

Search1API MCP सर्वर

smithery badge Glama

中文文档

Search1API के लिए आधिकारिक MCP सर्वर — वेब खोज, समाचार, पृष्ठ पुनर्प्राप्ति, साइटमैप खोज, और ट्रेंडिंग विषय एक ही API में।

प्रमाणीकरण

  • OAuth-जागरूक क्लाइंट सीधे Remote MCP URL से कनेक्ट हो सकते हैं, फिर ब्राउज़र में साइन इन करें और पहुंच स्वीकृत करें।
  • मौजूदा एकीकरण Search1API डैशबोर्ड से API कुंजी का उपयोग जारी रख सकते हैं।
  • प्रत्येक MCP अनुरोध — टूल खोज (initialize, tools/list) सहित — के लिए क्रेडेंशियल आवश्यक है। बिना प्रमाणीकरण वाले अनुरोध OAuth चुनौती प्राप्त करते हैं, जिससे क्लाइंट साइन-इन ट्रिगर करते हैं; कनेक्ट-पूर्व निरीक्षण स्थिर सर्वर कार्ड द्वारा प्रदान किया जाता है।

त्वरित प्रारंभ (Remote MCP)

कोई इंस्टॉलेशन आवश्यक नहीं। अपने MCP क्लाइंट को remote URL से कॉन्फ़िगर करें। जब क्लाइंट समर्थन करता है तो OAuth का उपयोग करें, या API कुंजी प्रदान करें।

प्रमाणीकरण

तीन विधियाँ समर्थित हैं — जो भी आपका क्लाइंट समर्थन करता है उसका उपयोग करें:

विधिप्रारूप
OAuth 2.1बिना कुंजी के https://mcp.search1api.com/mcp से कनेक्ट करें और क्लाइंट साइन-इन प्रवाह का पालन करें
प्राधिकरण हेडरAuthorization: Bearer YOUR_SEARCH1API_KEY
URL क्वेरी पैरामीटर (पुराना)https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

OAuth या प्राधिकरण हेडर को प्राथमिकता दें। क्वेरी-पैरामीटर क्रेडेंशियल URL, लॉग और शेल इतिहास में उजागर हो सकते हैं।

Claude Desktop

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude.ai (वेब)

सेटिंग्स > कनेक्टर > कस्टम कनेक्टर जोड़ें:

https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Cursor

Cursor प्लगइन के रूप में इंस्टॉल करें (अनुशंसित): इस रिपॉजिटरी में OAuth के साथ Remote MCP के लिए Agent Plugins plugin.json + mcp.json (पोर्टेबल) और .cursor-plugin/plugin.json (Cursor Marketplace मेटाडेटा / लोगो) शामिल हैं। cursor.directory / Cursor Marketplace से सबमिट या इंस्टॉल करें, फिर संकेत मिलने पर साइन इन करें।

स्थानीय परीक्षण के लिए, प्लगइन फ़ाइलों को ~/.cursor/plugins/local/search1api (plugin.json, .cursor-plugin/, mcp.json, assets/) में कॉपी करें। उस निर्देशिका के बाहर से सिमलिंक न करें — Cursor बाहरी सिमलिंक लक्ष्यों को अस्वीकार करता है।

या मैन्युअल रूप से कॉन्फ़िगर करें:

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

VS Code

{
  "servers": {
    "search1api": {
      "type": "http",
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add --transport http search1api https://mcp.search1api.com/mcp \
  --header "Authorization: Bearer YOUR_SEARCH1API_KEY"

Windsurf

{
  "mcpServers": {
    "search1api": {
      "serverUrl": "https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY"
    }
  }
}

एजेंट कौशल

एजेंट कौशल search1api-cli में स्थानांतरित हो गया है। इसे इंस्टॉल करें:

npm install -g search1api-cli
npx skills add superagents-lab/search1api-cli

स्थानीय मोड (stdio)

यदि आप सर्वर को स्थानीय रूप से चलाना पसंद करते हैं, तो npx के साथ Node.js 20 या नया उपयोग करें — कोई क्लोनिंग आवश्यक नहीं:

{
  "mcpServers": {
    "search1api": {
      "command": "npx",
      "args": ["-y", "search1api-mcp"],
      "env": {
        "SEARCH1API_KEY": "YOUR_SEARCH1API_KEY"
      }
    }
  }
}

प्रॉक्सी के पीछे स्व-होस्टेड HTTP तैनाती के लिए, Node.js प्रक्रिया तक पहुंचने वाले किसी भी आंतरिक होस्टनाम को अल्पविराम-पृथक MCP_ALLOWED_HOSTS पर्यावरण चर में जोड़ें। mcp.search1api.com और localhost पते डिफ़ॉल्ट रूप से अनुमत हैं। ब्राउज़र-आधारित क्लाइंट जो Origin हेडर भेजते हैं, उनके विश्वसनीय मूल होस्टनाम भी अल्पविराम-पृथक MCP_ALLOWED_ORIGINS चर में जोड़े जाने चाहिए। सर्वर-साइड MCP क्लाइंट के अनुरोध सामान्यतः Origin को छोड़ देते हैं और प्रविष्टि की आवश्यकता नहीं होती।

उपकरण

search

Search1API का उपयोग करके वेब खोजें। परिणामों में उद्धरण योग्य id/title/url संरचना शामिल होती है। पूर्ण पृष्ठ की आवश्यकता होने पर परिणाम URL को crawl पर पास करें।

पैरामीटरआवश्यकडिफ़ॉल्टविवरण
queryहाँ-खोज क्वेरी
max_resultsनहीं10परिणामों की संख्या
search_serviceनहींgooglegoogle, bing, duckduckgo, yahoo, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia
crawl_resultsनहीं0पूर्ण सामग्री के लिए क्रॉल किए जाने वाले शीर्ष परिणामों की संख्या; प्रत्येक सफल क्रॉल आधार 1-क्रेडिट खोज अनुरोध में 1 क्रेडिट जोड़ता है
include_sitesनहीं[]शामिल करने के लिए साइटें
exclude_sitesनहीं[]बाहर करने के लिए साइटें
time_rangeनहीं-day, month, year

news

समाचार लेख खोजें।

पैरामीटरआवश्यकडिफ़ॉल्टविवरण
queryहाँ-खोज क्वेरी
max_resultsनहीं10परिणामों की संख्या
search_serviceनहींbinggoogle, bing, duckduckgo, yahoo, hackernews
crawl_resultsनहीं0पूर्ण सामग्री के लिए क्रॉल किए जाने वाले शीर्ष परिणामों की संख्या; प्रत्येक सफल क्रॉल आधार 1-क्रेडिट समाचार अनुरोध में 1 क्रेडिट जोड़ता है
include_sitesनहीं[]शामिल करने के लिए साइटें
exclude_sitesनहीं[]बाहर करने के लिए साइटें
time_rangeनहीं-day, month, year

crawl

URL से सामग्री निकालें।

पैरामीटरआवश्यकविवरण
urlहाँक्रॉल करने के लिए URL

sitemap

URL से सभी संबंधित लिंक प्राप्त करें।

पैरामीटरआवश्यकविवरण
urlहाँसाइटमैप प्राप्त करने के लिए URL

trending

लोकप्रिय प्लेटफार्मों से ट्रेंडिंग विषय प्राप्त करें।

पैरामीटरआवश्यकडिफ़ॉल्टविवरण
search_serviceहाँ-github, hackernews
max_resultsनहीं10आइटम की संख्या

संस्करण इतिहास

  • v0.6.1: बग फिक्स — MCP खोज (initialize, tools/list, resources/*, prompts/list, server/discover) के लिए फिर से क्रेडेंशियल आवश्यक है। इसे अनाम रूप से प्रदान करने से क्लाइंट जो "सूचीबद्ध उपकरण" को "साइन इन" के साथ जोड़ते हैं, कनेक्टेड स्थिति दिखाते हैं और OAuth प्रवाह को ट्रिगर करने का कोई तरीका नहीं होता; 401 चुनौती अब हर अनधिकृत अनुरोध का उत्तर देती है, कनेक्ट समय पर OAuth साइन-इन बहाल करती है। स्थिर सर्वर कार्ड और रजिस्ट्री मेटाडेटा के माध्यम से निर्देशिका दृश्यता अपरिवर्तित है
  • v0.6.0: MCP खोज (initialize, tools/list, resources/*, prompts/list, server/discover) बिना क्रेडेंशियल के प्रदान की जाती है ताकि क्लाइंट और निर्देशिकाएं साइन इन करने से पहले उपकरणों की गणना कर सकें; टूल कॉल के लिए अभी भी OAuth या API कुंजी आवश्यक है। Stdio मोड SEARCH1API_KEY के बिना शुरू होता है और टूल मेटाडेटा प्रदान करता है, केवल कॉल समय पर अस्वीकार करता है। गलत अनुरोध HTML त्रुटि पृष्ठ के बजाय JSON-RPC के रूप में उत्तर देते हैं
  • v0.5.4: OAuth जारीकर्ता clerk.s1.dev पर स्थानांतरित हो गया और OAUTH_AUTHORIZATION_SERVER के साथ कॉन्फ़िगर करने योग्य है; MCP सर्वर कार्ड /.well-known/mcp/server-card.json पर प्रकाशित; OAuth खोज दस्तावेज़ अब कैश हेडर भेजते हैं
  • v0.5.3: OAuth संसाधन और टूल मेटाडेटा को अब OIDC सत्र स्कोप की आवश्यकता नहीं है; Smithery और Glama रजिस्ट्री बैज जोड़े गए
  • v0.5.2: MCP Origin सत्यापन अब अनुरोध पार्सिंग और प्रमाणीकरण से पहले चलता है; स्व-होस्टेड HTTP तैनाती MCP_ALLOWED_ORIGINS के साथ विश्वसनीय ब्राउज़र मूल कॉन्फ़िगर कर सकती हैं
  • v0.5.1: दस्तावेज़ीकरण, LobeHub मैनिफेस्ट, और MCP रजिस्ट्री मेटाडेटा सिंक्रनाइज़; robots.txt परिवहन होस्ट पर प्रदान किया गया
  • v0.5.0: स्वचालित प्रोटोकॉल वार्ता के साथ MCP 2026-07-28 समर्थन; 2025-युग HTTP क्लाइंट के लिए स्टेटलेस संगतता; अनुरोध-स्तरीय प्रमाणीकरण
  • v0.4.0: संरचित आउटपुट स्कीमा, OAuth सुरक्षा योजनाएं, सुरक्षा एनोटेशन, और आधिकारिक MCP रजिस्ट्री मेटाडेटा
  • v0.3.1: Remote MCP के लिए OAuth 2.1 समर्थन; सेवानिवृत्त तर्क उपकरण हटाया गया
  • v0.3.0: Streamable HTTP के माध्यम से Remote MCP समर्थन; प्रति-सत्र API कुंजी प्रमाणीकरण
  • v0.2.0: LibreChat एकीकरण के लिए फ़ॉलबैक .env समर्थन
  • v0.1.8: X (Twitter) और Reddit खोज सेवाएं
  • v0.1.7: GitHub और Hacker News के लिए ट्रेंडिंग उपकरण
  • v0.1.6: विकिपीडिया खोज सेवा
  • v0.1.5: नए खोज पैरामीटर और सेवाएं (arxiv, wechat, bilibili, imdb)
  • v0.1.3: समाचार खोज
  • v0.1.2: साइटमैप
  • v0.1.1: वेब क्रॉलिंग
  • v0.1.0: प्रारंभिक रिलीज़

लाइसेंस

MIT