Search1API

Search1API MCP Sunucusu

中文文档 | Deutsch

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

Kimlik Doğrulama

• OAuth destekli istemciler doğrudan Remote MCP URL'sine bağlanabilir, ardından tarayıcıda oturum açıp erişimi onaylayabilir.
• Mevcut entegrasyonlar Search1API kontrol panelinden alınan bir API anahtarını kullanmaya devam edebilir.
• Her MCP isteği — araç keşfi (initialize, tools/list) dahil — kimlik bilgisi gerektirir. Kimlik doğrulaması yapılmamış istekler OAuth challenge'ı alır; istemciler oturum açma sürecini bu şekilde başlatır. Bağlantı öncesi inceleme ise bunun yerine statik sunucu kartı üzerinden 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ği yöntemi kullanın:

Yöntem	Biçim
OAuth 2.1	https://mcp.search1api.com/mcp adresine anahtar olmadan bağlanın ve istemcinin oturum açma akışını izleyin
Authorization Header	Authorization: Bearer YOUR_SEARCH1API_KEY
URL Query Parameter (legacy)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

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

İsteğe bağlı arama ve haber arayüzü

Remote MCP, yukarıdaki standart uç noktada render_results sunar. search, news ve ask gibi veri araçları, kartları otomatik olarak göstermeden sonuç döndürür. Kaynak listesinin yararlı olduğu durumlarda model, mevcut sonuçları seçebilir veya birleştirip render_results aracına iletebilir. Bu araç, MCP Apps istemcilerinde kaynak kartları, diğer ortamlarda ise okunabilir ve eksiksiz bir metin listesi döndürür. Görüntüleme işlemi aramayı tekrarlamaz veya arama kredisi tüketmez; URL parametresi gerekmez.

Hem HTTP hem de stdio, standart serverInfo.icons meta verileri aracılığıyla kare Search1API logosunu duyurur. 512×512 PNG, kimlik doğrulaması veya yönlendirme olmadan herkese açık olarak https://mcp.search1api.com/assets/icon-square.png adresinde sunulur. Sunucu kartı ve kayıt manifesti aynı simgeyi kullanır. Simgenin görüntülenip görüntülenmeyeceğine istemciler karar verir; bu, eklenti dizininde ayrı olarak saklanan bir simgenin yerini almaz.

Bağımsız değişkenler, sınırlar ve yedek davranış için görüntüleme sözleşmesine bakın. npm paketi bu görüntüleyiciyi 0.8.0 sürümünden itibaren içerir. Mevcut kurulumları güncelleyin ve MCP bağlantısını yeniden başlatın; npx -y search1api-mcp@latest yayımlanmış en son paketi başlatır.

URL'yi değiştirdikten sonra bağlayıcıyı yeniden bağlayın veya araç tanımlarını yenileyin; istemciler bunları önbelleğe alabilir. Bu URL ayarı yalnızca Remote MCP için geçerlidir; yerel stdio davranışı değişmez. Ayrıntılar ve sürüm durumu için MCP Apps UI sayfasına bakın.

Claude Desktop

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

Claude.ai (Web)

Search1API'yi Claude dizininden yükleyin, Connect'e tıklayın ve Search1API hesabınızla oturum açın.

Add custom connector üzerinden https://mcp.search1api.com/mcp eklemeyin: bu işlem ayrı bir özel bağlayıcı oluşturur. Bir ad girmezseniz Claude, bağlayıcıya URL'nin ana bilgisayar adını (mcp.search1api.com) verir.

Cursor

Cursor eklentisi olarak yükleyin (önerilir): bu depoda OAuth ile Remote MCP için Agent Plugins plugin.json + mcp.json (taşınabilir) ve .cursor-plugin/plugin.json (Cursor Marketplace meta verileri / logo) bulunur. 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 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.

Ya da elle yapılandırın:

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

Antigravity

Antigravity eklentisi olarak yükleyin: antigravity-plugin/ manifesti, mcp_config.json (OAuth ile Remote MCP), Search1API becerisini ve Marketplace README dosyasını içerir. Doğrudan GitHub'dan yükleyin, ardından tarayıcı açıldığında oturum açın:

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

Yerel test için bir checkout üzerinden agy plugin validate --strict ./antigravity-plugin ve agy plugin install ./antigravity-plugin komutlarını çalıştırın.

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 konumuna 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ırmayı tercih ediyorsanız, klonlama gerektirmeyen npx ile Node.js 20 veya üzerini kullanın:

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

Bir proxy arkasındaki kendi barındırdığınız HTTP dağıtımlarında, 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 adreslerine varsayılan olarak izin verilir. Origin header'ı gönderen tarayıcı tabanlı istemciler için güvenilen kaynak ana bilgisayar adları da virgülle ayrılmış MCP_ALLOWED_ORIGINS değişkenine eklenmelidir. Sunucu tarafındaki MCP istemcilerinden gelen isteklerde genellikle Origin bulunmaz ve bu nedenle bir kayıt gerektirmez.

Araçlar

search

Search1API kullanarak web'de arama yapın. Sonuçlar, alıntılanabilir bir id/title/url yapısı içerir. Sayfanın tamamına ihtiyaç duyduğunuzda bir sonuç URL'sini crawl aracına 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, bingcn, duckduckgo, yahoo, yandex, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia, grokipedia
page	Hayır	1	Sonuç sayfası (1-100); yalnızca bing, bingcn, baidu ve grokipedia sayfalandırma yapar
crawl_results	Hayır	0	Tam içerik için taranacak en üst sıradaki 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, week, month, year

Arama motorunun sağladığı durumlarda sonuçlar metadata içinde published_date taşır; github sonuçları ise kind, stars, language ve num_comments ekler.

news

Haber makalelerini arayın. hackernews sonuçları tartışma başlığına bağlantı verir ve metadata içine story_url, points ve num_comments ekler.

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 üst sıradaki 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, week, month, year

crawl

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

Parametre	Gerekli	Açıklama
url	Evet	Taranacak URL

sitemap

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

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

trending

Popüler platformlardaki trend konuları alın.

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

ask

Agentic arama: ihtiyacınızı doğal dille açıklayın; Search1API en fazla beş arama motoru ve bir zaman aralığı seçer, konuyla ilgisiz sonuçları eler ve alaka düzeyine göre sıralanmış, alıntılanabilir en fazla 10 sonuç döndürür. Sonuç ayrıca intent (kullanılan anahtar kelimeler, arama motorları ve zaman aralığı) ve errors (diğerleri tamamlanırken başarısız olan arama motorları) bilgilerini taşır. Tamamlanan her istek 5 krediye mal olur; arama motorunu zaten biliyorsanız search kullanın.

Parametre	Gerekli	Açıklama
query	Evet	Doğal dilde istek, en fazla 500 karakter

maps

Google Maps'te yerel işletmeleri ve yerleri bulun. Alıntılanabilir sonuçlar olarak en fazla 20 yerden oluşan tek bir sayfa döndürür: title yerin adıdır, url Google Maps bağlantısıdır ve metadata mevcut olduğunda adres, telefon, web sitesi, kategori, puan, yorum sayısı, koordinatlar, çalışma saatleri, açık olma durumu ve fiyat aralığını içerir. Sayfa başına 3 krediye mal olur; sayfada kaç yer bulunduğu fiyatı değiştirmez.

Parametre	Gerekli	Varsayılan	Açıklama
query	Evet	-	"kahve dükkânları" veya "Austin'deki diş hekimleri" gibi aranacak şey
country	Hayır	us	İki harfli ülke kodu
language	Hayır	en	en, de veya zh-CN gibi sonuç dili
location	Hayır	-	Bir noktanın çevresinde arama yapmak için { latitude, longitude, zoom? }; 2. ve sonraki sayfalar için gereklidir
page	Hayır	1	Google Maps sayfası, 1-6; her sayfa ayrı bir çağrıdır
max_results	Hayır	20	Sayfadan döndürülecek yer sayısı (1-20); daha az yer döndürmek fiyatı düşürmez

deepcrawl

Dokümantasyon bölümü gibi tek bir sitenin birçok sayfasını tek görevde okuyun. Site URL'lerini site haritasından bulur, yol kurallarıyla eşleşenleri tutar ve alıntılanabilir sonuçlar olarak en fazla max_pages sayfa döndürür: title, url ve text içindeki sayfanın Markdown içeriği. Sonuç ayrıca stats (keşfedilen, eşleşen, atlanan, taranan, başarısız olan), failed (okunamayan URL'ler ve nedenleri), API message ve her sayfanın tamamını içeren bir JSON dosyası olan result_url bilgilerini taşır. Okuduğu sayfa sayısından bağımsız olarak başlatılan görev başına 20 krediye mal olur.

Araç yaklaşık 45 saniyeye kadar bekler. Tarama hâlâ sürüyorsa status: "running" ve bir task_id döndürür; sayfaları almak için aynı task_id ile deepcrawl aracını yeniden çağırın. Bu işlem ücretsizdir ve yeni bir tarama başlatmaz. Sayfa metni, sayfa başına 8.000 karakter ve toplamda 80.000 karakterle sınırlıdır; kısaltılmış sayfalarda metadata.truncated: true bulunur ve result_url tam metni içerir.

Parametre	Gerekli	Varsayılan	Açıklama
url	Evet, task_id verilmedikçe	-	https://example.com/docs/ gibi taranacak site veya bölüm
max_pages	Hayır	10	Yol kurallarından sonra keşif sırasına göre okunacak en fazla sayfa sayısı (1-50); sayı ne olursa olsun fiyat aynıdır
include_paths	Hayır	-	Tutulacak en fazla 20 URL yolu kuralı. * olmadan kural, yol segmenti sınırlarında bir yol önekidir (/docs, /docsearch ile değil, /docs/api ile eşleşir); * ile tüm yolla eşleşmesi gerekir ve * ayrıca / ile eşleşir
exclude_paths	Hayır	-	Atlanacak en fazla 20 yol kuralı; aynı sözdizimi kullanılır ve hariç tutma kuralı önceliklidir
type	Hayır	sitemap	sitemap, sitenin site haritasını; site haritası yoksa başlangıç sayfasındaki bağlantıları kullanır. all, başlangıç URL'sinden keşfedilen tüm bağlantıları kullanır
task_id	Hayır	-	Hâlâ çalışmakta olan bir taramanın task_id değeri; yalnızca durumunu kontrol eder ve diğer parametreler yok sayılır

send_feedback

Yanlış, boş veya eksik bir sonucu, çözemediğiniz bir hatayı, davranışla uyuşmayan dokümantasyonu ya da eksik bir özelliği Search1API ekibine bildirin. Ücretsizdir; kredi harcamaz. Sunucuda bir Search1API kimlik bilgisi varsa rapor bu hesaba bağlanır ve ekip sizinle iletişime geçebilir. Kimlik bilgilerini veya özel verileri eklemeyin.

Parametre	Gerekli	Açıklama
message	Evet	Ne yanlış gitti veya ne eksikti; en fazla 4000 karakter
intent	Hayır	Ne yapmaya çalışıyordunuz
category	Hayır	bug, feature_request, docs, other
request_id	Hayır	Sorun yaşanan çağrının istek kimliği
model	Hayır	Model adınız

Sürüm Geçmişi

• v0.11.0: Tek bir görevde bir sitenin en fazla 50 sayfasını okumak için yeni deepcrawl aracı (görev başına 20 kredi; çalışan bir görevi kontrol etmek ücretsizdir)

• v0.10.0: Google Maps yer araması için yeni maps aracı (20 yere kadar olan her sayfa için 3 kredi)

• v0.7.0: Aracı tabanlı arama için yeni ask aracı. search, bingcn, yandex ve grokipedia motorlarını ve bir page parametresini ekler; search ve news, time_range: "week" değerini kabul eder ve published_date, GitHub ve Hacker News alanlarını sonuç metadata içinde aktarır

• v0.6.1: Hata düzeltmesi — MCP keşfi (initialize, tools/list, resources/*, prompts/list, server/discover) yeniden kimlik bilgisi gerektiriyor. Anonim olarak sunulması, "listelenen araçlar"ı "oturum açılmış" olmakla eş tutan istemcilerin OAuth akışını başlatma yolu olmadan bağlı durumu göstermesine neden oluyordu; 401 sorgulaması artık kimliği doğrulanmamış her isteğe yanıt vererek bağlantı sırasında OAuth ile oturum açmayı yeniden sağlıyor. Dizin görünürlüğü statik sunucu kartı ve kayıt defteri meta verileri üzerinden değişmeden kalır

• v0.6.0: MCP keşfi (initialize, tools/list, resources/*, prompts/list, server/discover), istemcilerin ve dizinlerin oturum açmadan önce araçları listeleyebilmesi için kimlik bilgisi olmadan sunulur; araç çağrıları yine de OAuth veya API anahtarı gerektirir. Stdio modu SEARCH1API_KEY olmadan başlar ve araç meta verilerini sunar; yalnızca çağrı sırasında isteği reddeder. Hatalı biçimlendirilmiş isteklere HTML hata sayfası yerine JSON-RPC yanıtı verilir

• v0.5.4: OAuth vereninin adresi clerk.s1.dev olarak değiştirildi ve OAUTH_AUTHORIZATION_SERVER ile yapılandırılabilir hale getirildi; MCP sunucu kartı /.well-known/mcp/server-card.json adresinde yayımlandı; OAuth keşif belgeleri artık önbellek başlıkları gönderiyor

• v0.5.3: OAuth kaynak ve araç meta verileri artık OIDC oturum kapsamları gerektirmiyor; 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ışıyor; kendi barındırdığı HTTP dağıtımları, güvenilir tarayıcı kaynaklarını MCP_ALLOWED_ORIGINS ile yapılandırabilir

• v0.5.1: Belgeler, LobeHub manifesti ve MCP Registry meta verileri eşitlendi; robots.txt aktarım ana bilgisayarında sunuluyor

• 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 Resmî MCP Registry meta verileri

• v0.3.1: Remote MCP için OAuth 2.1 desteği; kullanımdan kaldırılan akıl yürütme 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

Kullanıcı arayüzü ve üçüncü taraf katkıları

render_results MCP Apps görünümü, mevcut kaynakları başlıkları ve alan adlarıyla kartlar halinde gösterir. Her istemci ayrıca tam metni ve yapılandırılmış sonuç listesini alır. Bileşen, Swami Malode tarafından hazırlanan Rare UI çalışmasından uyarlanmıştır. MIT + Commons Clause + Attribution koşulları THIRD_PARTY_NOTICES.md dosyasında yeniden verilmiştir.

Kullanıcı arayüzü kurulumu, sandbox kaynağı ve sürüm kontrolleri: MCP Apps UI.