Search1API

Search1API MCP Sunucusu

中文文档

Search1API için resmi MCP sunucusu — web araması, haberler, sayfa getirme, site haritası keşfi ve trend konular tek bir API'de.

Kimlik Doğrulama

• OAuth destekleyen istemciler doğrudan Remote MCP URL'sine bağlanabilir, ardından tarayıcıda oturum açıp erişimi onaylayabilir.
• Mevcut entegrasyonlar Search1API panelinden bir API anahtarı kullanmaya devam edebilir.
• Araç keşfi dahil (initialize, tools/list) her MCP isteği bir kimlik bilgisi gerektirir. Kimliği doğrulanmamış istekler OAuth sorgulamasını tetikler; istemcilerin oturum açmayı başlatma yolu budur. Bağlantı öncesi inceleme, bunun yerine statik sunucu kartı tarafından sunulur.

Hızlı Başlangıç (Remote MCP)

Kurulum gerekmez. MCP istemcinizi uzak URL ile yapılandırın. İstemci destekliyorsa OAuth kullanın veya bir API anahtarı sağlayın.

Kimlik Doğrulama

Üç yöntem desteklenir — istemcinizin desteklediğini kullanın:

Yöntem	Biçim
OAuth 2.1	Anahtar olmadan https://mcp.search1api.com/mcp adresine bağlanın ve istemci oturum açma akışını izleyin
Authorization Başlığı	Authorization: Bearer YOUR_SEARCH1API_KEY
URL Sorgu Parametresi (eski)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

OAuth veya Authorization başlığını tercih edin. Sorgu parametresi kimlik bilgileri URL'lerde, günlüklerde ve kabuk geçmişinde açığa çıkabilir.

Claude Desktop

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

Claude.ai (Web)

Ayarlar > Bağlayıcılar > Özel bağlayıcı ekle:

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

Cursor

Cursor eklentisi olarak kurun (önerilir): bu depo, OAuth ile Remote MCP için Agent Eklentileri plugin.json + mcp.json (taşınabilir) ve .cursor-plugin/plugin.json (Cursor Marketplace meta verileri / logosu) içerir. cursor.directory / Cursor Marketplace'ten gönderin veya kurun, ardından istendiğinde oturum açın.

Yerel test için, eklenti dosyalarını ~/.cursor/plugins/local/search1api dizinine kopyalayın (plugin.json, .cursor-plugin/, mcp.json, assets/). Bu dizinin dışından sembolik bağlantı oluşturmayın — Cursor harici sembolik bağlantı hedeflerini reddeder.

Veya manuel olarak yapılandırın:

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

Ajan Becerisi

Ajan Becerisi search1api-cli adresine taşındı. Şununla kurun:

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

Yerel Mod (stdio)

Sunucuyu yerel olarak çalıştırmayı tercih ederseniz, npx ile Node.js 20 veya daha yenisini kullanın — klonlama gerekmez:

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

Bir proxy arkasında kendi kendine barındırılan HTTP dağıtımları için, Node.js sürecine ulaşan tüm dahili ana bilgisayar adlarını virgülle ayrılmış MCP_ALLOWED_HOSTS ortam değişkenine ekleyin. mcp.search1api.com ve localhost adresleri varsayılan olarak izinlidir. Origin başlığı gönderen tarayıcı tabanlı istemciler, güvenilen kaynak ana bilgisayar adlarını da virgülle ayrılmış MCP_ALLOWED_ORIGINS değişkenine eklemelidir. Sunucu tarafı MCP istemcilerinden gelen istekler normalde Origin öğesini atlar ve bir girdi gerektirmez.

Araçlar

search

Search1API kullanarak web'de arama yapın. Sonuçlar, alıntı yapılabilir bir id/title/url yapısı içerir. Tam sayfaya ihtiyacınız olduğunda crawl öğesine bir sonuç URL'si iletin.

Parametre	Zorunlu	Varsayılan	Açıklama
query	Evet	-	Arama sorgusu
max_results	Hayır	10	Sonuç sayısı
search_service	Hayır	google	google, bing, duckduckgo, yahoo, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia
crawl_results	Hayır	0	Tam içerik için taranacak en iyi sonuç sayısı; her başarılı tarama, temel 1 kredilik arama isteğine 1 kredi ekler
include_sites	Hayır	[]	Dahil edilecek siteler
exclude_sites	Hayır	[]	Hariç tutulacak siteler
time_range	Hayır	-	day, month, year

news

Haber makaleleri arayın.

Parametre	Zorunlu	Varsayılan	Açıklama
query	Evet	-	Arama sorgusu
max_results	Hayır	10	Sonuç sayısı
search_service	Hayır	bing	google, bing, duckduckgo, yahoo, hackernews
crawl_results	Hayır	0	Tam içerik için taranacak en iyi sonuç sayısı; her başarılı tarama, temel 1 kredilik haber isteğine 1 kredi ekler
include_sites	Hayır	[]	Dahil edilecek siteler
exclude_sites	Hayır	[]	Hariç tutulacak siteler
time_range	Hayır	-	day, month, year

crawl

Bir URL'den içerik çıkarın.

Parametre	Zorunlu	Açıklama
url	Evet	Taranacak URL

sitemap

Bir URL'den tüm ilgili bağlantıları alın.

Parametre	Zorunlu	Açıklama
url	Evet	Site haritası alınacak URL

trending

Popüler platformlardan trend konuları alın.

Parametre	Zorunlu	Varsayılan	Açıklama
search_service	Evet	-	github, hackernews
max_results	Hayır	10	Öğe sayısı

Sürüm Geçmişi

• v0.6.1: Hata düzeltmesi — MCP keşfi (initialize, tools/list, resources/*, prompts/list, server/discover) yeniden kimlik bilgisi gerektirir. Anonim olarak sunulması, "araçlar listelendi" ile "oturum açıldı" eşitleyen istemcilerin OAuth akışını tetikleme yolu olmadan bağlı durum göstermesine neden oldu; 401 sorgulaması artık her kimliği doğrulanmamış isteğe yanıt vererek bağlantı sırasında OAuth oturum açmayı geri yükler. Dizin görünürlüğü statik sunucu kartı ve kayıt defteri meta verileri aracılığıyla değişmez
• v0.6.0: MCP keşfi (initialize, tools/list, resources/*, prompts/list, server/discover) kimlik bilgisi olmadan sunulur, böylece istemciler ve dizinler oturum açmadan önce araçları numaralandırabilir; araç çağrıları hâlâ OAuth veya API anahtarı gerektirir. Stdio modu SEARCH1API_KEY olmadan başlar ve araç meta verilerini sunar, yalnızca çağrı zamanında reddeder. Hatalı istekler HTML hata sayfası yerine JSON-RPC olarak yanıtlanır
• v0.5.4: OAuth veren clerk.s1.dev adresine taşındı ve OAUTH_AUTHORIZATION_SERVER ile yapılandırılabilir; MCP sunucu kartı /.well-known/mcp/server-card.json adresinde yayınlandı; OAuth keşif belgeleri artık önbellek başlıkları gönderir
• v0.5.3: OAuth kaynak ve araç meta verileri artık OIDC oturum kapsamları gerektirmez; Smithery ve Glama kayıt defteri rozetleri eklendi
• v0.5.2: MCP Origin doğrulaması artık istek ayrıştırma ve kimlik doğrulamadan önce çalışır; kendi kendine barındırılan HTTP dağıtımları MCP_ALLOWED_ORIGINS ile güvenilen tarayıcı kaynaklarını yapılandırabilir
• v0.5.1: Belgeler, LobeHub bildirimi ve MCP Kayıt Defteri meta verileri senkronize edildi; robots.txt taşıma ana bilgisayarında sunuldu
• v0.5.0: Otomatik protokol anlaşmasıyla MCP 2026-07-28 desteği; 2025 dönemi HTTP istemcileri için durumsuz uyumluluk; istek düzeyinde kimlik doğrulama
• v0.4.0: Yapılandırılmış çıktı şemaları, OAuth güvenlik şemaları, güvenlik açıklamaları ve Resmi MCP Kayıt Defteri meta verileri
• v0.3.1: Remote MCP için OAuth 2.1 desteği; kullanımdan kaldırılan reasoning aracı kaldırıldı
• v0.3.0: Streamable HTTP üzerinden Remote MCP desteği; oturum başına API anahtarı kimlik doğrulaması
• v0.2.0: LibreChat entegrasyonu için yedek .env desteği
• v0.1.8: X (Twitter) ve Reddit arama hizmetleri
• v0.1.7: GitHub ve Hacker News için trend aracı
• v0.1.6: Wikipedia arama hizmeti
• v0.1.5: Yeni arama parametreleri ve hizmetler (arxiv, wechat, bilibili, imdb)
• v0.1.3: Haber araması
• v0.1.2: Site haritası
• v0.1.1: Web tarama
• v0.1.0: İlk sürüm

Lisans

MIT