Search1API

आधिकारिक

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

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

  • वेब खोज — अपने सहायक से Google, Bing, GitHub, arXiv या Reddit जैसे इंजनों पर साइट फ़िल्टर और समय-सीमा के साथ search चलाने को कहें।
  • समाचार खोज — Google, Bing, DuckDuckGo, Yahoo या Hacker News से हाल के लेख खोजने के लिए news का उपयोग करें; चाहें तो शीर्ष परिणामों को क्रॉल भी करें।
  • पेज और साइटमैप प्राप्त करना — किसी URL से पूरी सामग्री निकालें या किसी साइट के सभी संबंधित लिंक सूचीबद्ध करें।
  • ट्रेंडिंग विषय — GitHub या Hacker News से ट्रेंडिंग आइटम प्राप्त करें।
  • एजेंटिक खोज — अपनी ज़रूरत का वर्णन सामान्य भाषा में करें और ask को इंजन चुनने तथा क्रमबद्ध, उद्धृत किए जा सकने वाले परिणाम देने दें।
  • स्थानीय स्थान खोज — Google Maps पर पते, रेटिंग, समय और संपर्क विवरण सहित व्यवसाय और स्थान खोजें।

दस्तावेज़

Search1API MCP Server

Smithery Glama

中文文档 | Deutsch

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

प्रमाणीकरण

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

त्वरित शुरुआत (Remote MCP)

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

प्रमाणीकरण

तीन तरीके समर्थित हैं — आपके क्लाइंट द्वारा समर्थित कोई भी तरीका इस्तेमाल करें:

तरीकाप्रारूप
OAuth 2.1बिना key के https://mcp.search1api.com/mcp से कनेक्ट करें और क्लाइंट के साइन-इन प्रवाह का पालन करें
Authorization HeaderAuthorization: Bearer YOUR_SEARCH1API_KEY
URL Query Parameter (legacy)https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

OAuth या Authorization header को प्राथमिकता दें। Query-parameter क्रेडेंशियल URL, लॉग और shell history में उजागर हो सकते हैं।

वैकल्पिक खोज और समाचार UI

Remote MCP ऊपर दिए गए मानक endpoint पर render_results उपलब्ध कराता है। search, news और ask जैसे डेटा टूल कार्ड अपने-आप दिखाए बिना परिणाम लौटाते हैं। जब स्रोतों की सूची उपयोगी हो, तो मॉडल मौजूदा परिणामों को चुन या संयोजित करके render_results को दे सकता है। यह MCP Apps क्लाइंट में स्रोत कार्ड और अन्य जगहों पर पूरी, पढ़ने योग्य टेक्स्ट सूची लौटाता है। रेंडरिंग से खोज दोबारा नहीं होती और खोज क्रेडिट खर्च नहीं होते; UI URL पैरामीटर की आवश्यकता नहीं है।

HTTP और stdio, दोनों मानक serverInfo.icons मेटाडेटा के ज़रिए चौकोर Search1API लोगो की जानकारी देते हैं। 512×512 PNG सार्वजनिक रूप से https://mcp.search1api.com/assets/icon-square.png पर उपलब्ध है, इसके लिए प्रमाणीकरण या रीडायरेक्ट की आवश्यकता नहीं है। सर्वर कार्ड और रजिस्ट्री मेनिफ़ेस्ट में भी यही आइकन है। क्लाइंट तय करते हैं कि इसे दिखाना है या नहीं; यह प्लगइन डायरेक्टरी में अलग से संग्रहीत आइकन की जगह नहीं लेता।

आर्ग्युमेंट, सीमाओं और फ़ॉलबैक व्यवहार के लिए रेंडरिंग अनुबंध देखें। npm पैकेज में यह रेंडरर संस्करण 0.8.0 से शामिल है। मौजूदा इंस्टॉलेशन अपडेट करें और MCP कनेक्शन रीस्टार्ट करें; npx -y search1api-mcp@latest नवीनतम प्रकाशित पैकेज शुरू करता है।

URL बदलने के बाद, कनेक्टर को फिर से कनेक्ट करें या उसकी टूल परिभाषाएँ रीफ़्रेश करें; क्लाइंट इन्हें कैश कर सकते हैं। यह URL सेटिंग केवल Remote MCP पर लागू होती है; स्थानीय stdio व्यवहार अपरिवर्तित रहता है। विवरण और रिलीज़ स्थिति के लिए MCP Apps UI देखें।

Claude Desktop

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

Claude.ai (Web)

Claude directory से Search1API इंस्टॉल करें, Connect पर क्लिक करें और अपने Search1API खाते से साइन इन करें।

Add custom connector के ज़रिए https://mcp.search1api.com/mcp जोड़ने से बचें: इससे एक अलग कस्टम कनेक्टर बनता है, जिसका नाम Claude URL के होस्ट के नाम पर (mcp.search1api.com) रखता है, जब तक कि आप कोई नाम न लिखें।

Cursor

Cursor प्लगइन के रूप में इंस्टॉल करें (अनुशंसित): इस repo में Remote MCP और OAuth के लिए 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/)। उस डायरेक्टरी के बाहर से symlink न बनाएँ — Cursor बाहरी symlink लक्ष्यों को अस्वीकार करता है।

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

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

Antigravity

Antigravity प्लगइन के रूप में इंस्टॉल करें: antigravity-plugin/ में मेनिफ़ेस्ट, mcp_config.json (OAuth के साथ Remote MCP), Search1API skill और Marketplace README शामिल हैं। इसे सीधे GitHub से इंस्टॉल करें, फिर ब्राउज़र खुलने पर साइन इन करें:

agy plugin install https://github.com/superagents-lab/search1api-mcp/tree/main/antigravity-plugin

स्थानीय परीक्षण के लिए, checkout से agy plugin validate --strict ./antigravity-plugin और agy plugin install ./antigravity-plugin चलाएँ।

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

Agent Skill

Agent Skill अब search1api-cli में उपलब्ध है। इसे इस तरह इंस्टॉल करें:

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

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

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

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

प्रॉक्सी के पीछे self-hosted HTTP डिप्लॉयमेंट के लिए, Node.js प्रक्रिया तक पहुँचने वाले किसी भी आंतरिक hostname को अल्पविराम से अलग किए गए MCP_ALLOWED_HOSTS environment variable में जोड़ें। mcp.search1api.com और localhost पते डिफ़ॉल्ट रूप से अनुमत हैं। Origin header भेजने वाले ब्राउज़र-आधारित क्लाइंट के लिए, उनके विश्वसनीय origin hostname को भी अल्पविराम से अलग किए गए MCP_ALLOWED_ORIGINS variable में जोड़ना होगा। सर्वर-साइड MCP क्लाइंट के अनुरोधों में आम तौर पर Origin शामिल नहीं होता और उनके लिए कोई प्रविष्टि आवश्यक नहीं है।

टूल

search

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

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

जब सर्च इंजन उपलब्ध कराता है, तो परिणामों में metadata में published_date शामिल होता है; github परिणामों में kind, stars, language और num_comments भी शामिल होते हैं।

news

समाचार लेख खोजें। hackernews परिणाम चर्चा थ्रेड से लिंक करते हैं और metadata में story_url, points और num_comments जोड़ते हैं।

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

crawl

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

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

sitemap

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

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

trending

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

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

ask

एजेंटिक खोज: अपनी ज़रूरत का वर्णन सामान्य भाषा में करें। Search1API अधिकतम पाँच सर्च इंजन और एक समयावधि चुनता है, विषय से हटकर परिणामों को हटाता है और प्रासंगिकता के अनुसार क्रमबद्ध अधिकतम 10 उद्धृत किए जा सकने वाले परिणाम लौटाता है। परिणाम में intent (इस्तेमाल किए गए कीवर्ड, इंजन और समयावधि) और errors (वे इंजन जो विफल हुए, जबकि अन्य ने काम पूरा किया) भी शामिल होते हैं। हर पूर्ण अनुरोध की लागत 5 क्रेडिट है; इंजन पहले से पता हो तो search का उपयोग करें।

पैरामीटरआवश्यकविवरण
queryहाँसामान्य भाषा में अनुरोध, अधिकतम 500 अक्षर

maps

Google Maps पर स्थानीय व्यवसाय और स्थान खोजें। उद्धृत किए जा सकने वाले परिणामों के रूप में अधिकतम 20 स्थानों का एक पेज लौटाता है: title स्थान का नाम है, url उसका Google Maps लिंक है और metadata में उपलब्ध होने पर पता, फ़ोन, वेबसाइट, श्रेणी, रेटिंग, समीक्षाओं की संख्या, निर्देशांक, खुलने का समय, खुला होने की स्थिति और मूल्य-सीमा शामिल होती है। प्रति पेज 3 क्रेडिट खर्च होते हैं, चाहे उसमें कितने भी स्थान हों।

पैरामीटरआवश्यकडिफ़ॉल्टविवरण
queryहाँ-क्या खोजना है, जैसे "कॉफ़ी शॉप" या "ऑस्टिन में दंत चिकित्सक"
countryनहींusदो-अक्षर वाला देश कोड
languageनहींenपरिणामों की भाषा, जैसे en, de या zh-CN
locationनहीं-किसी स्थान के आसपास खोजने के लिए { latitude, longitude, zoom? }; दूसरे और उसके बाद के पेजों के लिए आवश्यक
pageनहीं1Google Maps पेज, 1-6; हर पेज एक अलग कॉल है
max_resultsनहीं20पेज से लौटाए जाने वाले स्थान (1-20); कम स्थान लौटाने से कीमत कम नहीं होती

deepcrawl

एक ही टास्क में किसी एक साइट के कई पेज पढ़ें, जैसे दस्तावेज़ का कोई सेक्शन। साइट के URL उसके साइटमैप से खोजता है, पाथ नियमों से मेल खाने वाले URL रखता है और उद्धृत किए जा सकने वाले परिणामों के रूप में अधिकतम max_pages पेज लौटाता है: title, url और पेज का Markdown text में। परिणाम में stats (खोजे गए, मेल खाने वाले, छोड़े गए, क्रॉल किए गए, विफल), failed (वे URL जिन्हें पढ़ा नहीं जा सका, कारण सहित), API message और result_url भी शामिल होते हैं; यह एक JSON फ़ाइल है जिसमें हर पेज की पूरी सामग्री होती है। शुरू किए गए हर टास्क की लागत 20 क्रेडिट है, चाहे वह कितने भी पेज पढ़े।

टूल लगभग 45 सेकंड तक प्रतीक्षा करता है। यदि क्रॉल तब भी चल रहा हो, तो यह status: "running" और एक task_id लौटाता है; पेज प्राप्त करने के लिए उसी task_id के साथ deepcrawl को फिर से कॉल करें। यह मुफ़्त है और नया क्रॉल शुरू नहीं करता। हर पेज का टेक्स्ट अधिकतम 8,000 अक्षरों और कुल टेक्स्ट अधिकतम 80,000 अक्षरों तक सीमित है; छोटे किए गए पेजों में metadata.truncated: true होता है और result_url में पूरा टेक्स्ट होता है।

पैरामीटरआवश्यकडिफ़ॉल्टविवरण
urlहाँ, जब तक task_id न दिया गया हो-क्रॉल करने के लिए साइट या सेक्शन, जैसे https://example.com/docs/
max_pagesनहीं10पाथ नियम लागू करने के बाद खोजे जाने के क्रम में पढ़े जाने वाले अधिकतम पेज (1-50); किसी भी संख्या के लिए कीमत समान है
include_pathsनहीं-रखने के लिए अधिकतम 20 URL पाथ नियम। * के बिना, नियम सेगमेंट की सीमाओं पर पाथ प्रीफ़िक्स होता है (/docs का मिलान /docs/api से होता है, /docsearch से नहीं); * के साथ, पूरे पाथ का मिलान आवश्यक है और * का मिलान / से भी होता है
exclude_pathsनहीं-छोड़ने के लिए अधिकतम 20 पाथ नियम, वही सिंटैक्स; बहिष्करण को प्राथमिकता मिलती है
typeनहींsitemapsitemap साइट का साइटमैप इस्तेमाल करता है, या साइटमैप न होने पर शुरुआती पेज के लिंक; all शुरुआती URL से खोजे गए हर लिंक का इस्तेमाल करता है
task_idनहीं-ऐसे क्रॉल का task_id जो अभी चल रहा हो; केवल उसकी स्थिति जाँचता है और अन्य पैरामीटर अनदेखे किए जाते हैं

send_feedback

गलत, खाली या अधूरे परिणाम, ऐसी त्रुटि जिसे आप हल नहीं कर सके, व्यवहार से मेल न खाने वाले दस्तावेज़ या किसी अनुपलब्ध क्षमता की रिपोर्ट Search1API टीम को करें। यह मुफ़्त है; कोई क्रेडिट खर्च नहीं होता। जब सर्वर के पास Search1API क्रेडेंशियल हो, तो रिपोर्ट उस खाते से लिंक की जाती है ताकि टीम आगे संपर्क कर सके। क्रेडेंशियल या निजी डेटा शामिल न करें।

पैरामीटरआवश्यकविवरण
messageहाँक्या गलत हुआ या क्या अनुपलब्ध था, अधिकतम 4000 वर्ण
intentनहींआप क्या हासिल करने की कोशिश कर रहे थे
categoryनहींbug, feature_request, docs, other
request_idनहींसमस्या वाली कॉल का अनुरोध आईडी
modelनहींआपके मॉडल का नाम

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

  • v0.11.0: एक ही कार्य में किसी एक साइट के अधिकतम 50 पृष्ठ पढ़ने के लिए नया deepcrawl टूल (प्रति कार्य 20 क्रेडिट; चल रहे कार्य की जाँच निःशुल्क है)

  • v0.10.0: Google Maps स्थान खोज के लिए नया maps टूल (अधिकतम 20 स्थानों वाले प्रति पृष्ठ 3 क्रेडिट)

  • v0.7.0: एजेंटिक खोज के लिए नया ask टूल। search में bingcn, yandex, और grokipedia इंजन तथा एक page पैरामीटर जोड़ा गया है; search और news, time_range: "week" स्वीकार करते हैं और परिणाम metadata में published_date, GitHub, और Hacker News फ़ील्ड आगे भेजते हैं

  • 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 key आवश्यक है। Stdio मोड SEARCH1API_KEY के बिना शुरू होता है और टूल मेटाडेटा उपलब्ध कराता है; केवल कॉल के समय अनुरोध अस्वीकार करता है। गलत फ़ॉर्मैट वाले अनुरोधों का जवाब HTML त्रुटि पृष्ठ के बजाय JSON-RPC के रूप में दिया जाता है

  • v0.5.4: OAuth issuer को clerk.s1.dev पर स्थानांतरित किया गया और इसे OAUTH_AUTHORIZATION_SERVER से कॉन्फ़िगर किया जा सकता है; MCP server card को /.well-known/mcp/server-card.json पर प्रकाशित किया गया; OAuth खोज दस्तावेज़ अब cache headers भेजते हैं

  • v0.5.3: OAuth resource और tool मेटाडेटा के लिए अब OIDC session scopes आवश्यक नहीं हैं; Smithery और Glama रजिस्ट्री बैज जोड़े गए

  • v0.5.2: MCP Origin सत्यापन अब अनुरोध पार्स करने और प्रमाणीकरण से पहले चलता है; self-hosted HTTP deployments, MCP_ALLOWED_ORIGINS से विश्वसनीय ब्राउज़र origins कॉन्फ़िगर कर सकते हैं

  • v0.5.1: दस्तावेज़ीकरण, LobeHub manifest, और MCP Registry मेटाडेटा को सिंक्रनाइज़ किया गया; robots.txt को transport host पर उपलब्ध कराया गया

  • v0.5.0: स्वचालित protocol negotiation के साथ MCP 2026-07-28 समर्थन; 2025-युग के HTTP क्लाइंट के लिए stateless compatibility; अनुरोध-स्तरीय प्रमाणीकरण

  • v0.4.0: संरचित आउटपुट स्कीमा, OAuth सुरक्षा स्कीम, सुरक्षा एनोटेशन, और आधिकारिक MCP Registry मेटाडेटा

  • v0.3.1: Remote MCP के लिए OAuth 2.1 समर्थन; अप्रचलित reasoning टूल हटाया गया

  • v0.3.0: Streamable HTTP के ज़रिए Remote MCP समर्थन; प्रति-सत्र API key प्रमाणीकरण

  • v0.2.0: LibreChat एकीकरण के लिए फ़ॉलबैक .env समर्थन

  • v0.1.8: X (Twitter) और Reddit खोज सेवाएँ

  • v0.1.7: GitHub और Hacker News के लिए ट्रेंडिंग टूल

  • v0.1.6: Wikipedia खोज सेवा

  • v0.1.5: नए खोज पैरामीटर और सेवाएँ (arxiv, wechat, bilibili, imdb)

  • v0.1.3: समाचार खोज

  • v0.1.2: Sitemap

  • v0.1.1: वेब क्रॉलिंग

  • v0.1.0: प्रारंभिक रिलीज़

लाइसेंस

MIT

UI और तृतीय-पक्ष श्रेय

render_results MCP Apps दृश्य, मौजूदा स्रोतों को शीर्षक और डोमेन वाले कार्ड के रूप में दिखाता है। हर क्लाइंट को पूरा पाठ और संरचित परिणाम सूची भी मिलती है। यह घटक Swami Malode द्वारा बनाए गए Rare UI से अनुकूलित है। इसकी MIT + Commons Clause + Attribution शर्तें THIRD_PARTY_NOTICES.md में पुनः प्रस्तुत की गई हैं।

UI सेटअप, sandbox origin, और रिलीज़ जाँचें: MCP Apps UI।