Search1API

Search1API MCP Sunucusu

中文文档

Search1API için resmi MCP sunucusu — web arama, haberler, sayfa alma, site haritası keşfi ve popüler 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 panosundan bir API anahtarı kullanmaya devam edebilir.

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

Kurulum gerektirmez. 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 hangisini 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
Yetkilendirme Başlığı	Authorization: Bearer YOUR_SEARCH1API_KEY
URL Sorgu Parametresi (eski)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

OAuth veya Yetkilendirme 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

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

Yerel test için, eklenti dosyalarını ~/.cursor/plugins/local/search1api (plugin.json, .cursor-plugin/, mcp.json, assets/) dizinine kopyalayın. 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ı. Şu komutla yükleyin:

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

Yerel Mod (stdio)

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

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

Proxy arkasındaki kendi kendine barındırılan HTTP dağıtımları için, Node.js sürecine ulaşan 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 izin verilir. Bir Origin başlığı gönderen tarayıcı tabanlı istemcilerin, güvenilen kaynak ana bilgisayar adlarının da virgülle ayrılmış MCP_ALLOWED_ORIGINS değişkenine eklenmesi gerekir. Sunucu tarafı MCP istemcilerinden gelen istekler normalde Origin öğesini atlar ve bir giriş gerektirmez.

Araçlar

search

Search1API kullanarak web'de arama yapın. Sonuçlar, atıf yapılabilir bir id/title/url yapısı içerir. Tam sayfaya ihtiyacınız olduğunda bir sonuç URL'sini crawl adresine iletin.

Parametre	Gerekli	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 makalelerini arayın.

Parametre	Gerekli	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	Gerekli	Açıklama
url	Evet	Taranacak URL

sitemap

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

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

trending

Popüler platformlardan trend konuları alın.

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

Sürüm Geçmişi

• v0.5.3: OAuth kaynağı ve araç meta verileri artık OIDC oturum kapsamları gerektirmez; Smithery ve Glama kayıt 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ı, güvenilen tarayıcı kaynaklarını MCP_ALLOWED_ORIGINS ile yapılandırabilir
• v0.5.1: Dokümantasyon, LobeHub manifestosu ve MCP Kayıt meta verileri senkronize edildi; robots.txt taşıma ana bilgisayarında sunuluyor
• v0.5.0: Otomatik protokol anlaşması ile 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 meta verileri
• v0.3.1: Remote MCP için OAuth 2.1 desteği; kullanılmayan muhakeme 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 hizmetleri (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