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