SerpApi MCP

SerpApi MCP Sunucusu

Kapsamlı arama motoru sonuçları ve veri çıkarımı için SerpApi ile entegre olan bir Model Bağlam Protokolü (MCP) sunucu uygulaması.

Özellikler

• Çoklu Motor Araması: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay ve daha fazlası
• Motor Kaynakları: MCP kaynakları aracılığıyla motor başına parametre şemaları mevcuttur (Arama Aracına bakın)
• Gerçek Zamanlı Hava Durumu Verisi: Arama sorguları yoluyla tahminlerle konum tabanlı hava durumu
• Borsa Verisi: Arama entegrasyonu aracılığıyla şirket finansalları ve piyasa verileri
• Dinamik Sonuç İşleme: Farklı sonuç türlerini otomatik olarak algılar ve biçimlendirir
• Esnek Yanıt Modları: Tam veya sıkıştırılmış JSON yanıtları
• JSON Yanıtları: Tam veya sıkıştırılmış modlarla yapılandırılmış JSON çıktısı
• Etkileşimli Arayüz (MCP Uygulamaları): Destekleyen ana bilgisayarlarda sonuçları etkileşimli bir arayüz olarak işleyen, isteğe bağlı search_table ve search_dashboard araçları

Hızlı Başlangıç

SerpApi MCP Sunucusu, mcp.serpapi.com adresinde barındırılan bir hizmet olarak mevcuttur. Bağlanmak için bir API anahtarı sağlamanız gerekir. API anahtarınızı SerpApi kontrol panelinizde bulabilirsiniz.

Claude Desktop'ı barındırılan sunucuyu kullanacak şekilde yapılandırabilirsiniz:

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

Barındırılan sunucuyu şu MCP istemcilerine de ekleyebilirsiniz:

OpenClaw

openclaw mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp --transport streamable-http

Claude Code

claude mcp add --transport http serpapi https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp

Hermes

hermes mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp

Codex

codex mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp

Kendi Kendine Barındırma

git clone https://github.com/serpapi/serpapi-mcp.git
cd serpapi-mcp
uv sync && uv run src/server.py

Claude Desktop'ı yapılandırın:

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "http://localhost:8000/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

API anahtarınızı alın: serpapi.com/manage-api-key

Kimlik Doğrulama

İki yöntem desteklenir:

• Yol tabanlı: /YOUR_API_KEY/mcp (önerilir)
• Başlık tabanlı: Authorization: Bearer YOUR_API_KEY

Örnekler:

# Path-based
curl "https://mcp.serpapi.com/your_key/mcp" -d '...'

# Header-based  
curl "https://mcp.serpapi.com/mcp" -H "Authorization: Bearer your_key" -d '...'

Arama Aracı

MCP sunucusu, tüm SerpApi motorlarını ve sonuç türlerini destekleyen bir ana Arama Aracına sahiptir. Mevcut tüm parametreleri SerpApi API referansında bulabilirsiniz. Motor parametre şemaları ayrıca MCP kaynakları olarak sunulur: serpapi://engines (dizin) ve serpapi://engines/<engine>.

Sağlayabileceğiniz parametreler her API motoru için özeldir. Aşağıda bazı örnek parametreler verilmiştir:

• params.q (gerekli): Arama sorgusu
• params.engine: Arama motoru (varsayılan: "google_light")
• params.location: Coğrafi filtre
• mode: Yanıt modu - "complete" (varsayılan) veya "compact"
• ...diğer parametreler için SerpApi API referansına bakın

Örnekler:

{"name": "search", "arguments": {"params": {"q": "coffee shops", "location": "Austin, TX"}}}
{"name": "search", "arguments": {"params": {"q": "weather in London"}}}
{"name": "search", "arguments": {"params": {"q": "AAPL stock"}}}
{"name": "search", "arguments": {"params": {"q": "news"}, "mode": "compact"}}
{"name": "search", "arguments": {"params": {"q": "detailed search"}, "mode": "complete"}}

Desteklenen Motorlar: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay ve daha fazlası (bkz. serpapi://engines).

Sonuç Türleri: Yanıt kutuları, organik sonuçlar, haberler, resimler, alışveriş - otomatik olarak algılanır ve biçimlendirilir.

Etkileşimli Arayüz (MCP Uygulamaları)

Varsayılan search aracı JSON döndürür ve değişmemiştir. MCP Uygulamaları uzantısını (SEP-1865) destekleyen ana bilgisayarlar için, iki isteğe bağlı araç sonuçları doğrudan konuşma içinde etkileşimli bir arayüz olarak işler, böylece büyük SERP JSON'u asla modelin bağlam penceresine girmez:

• search_table: sıralanabilir, aranabilir bir tablo olarak organik sonuçlar.
• search_dashboard: özet metrikler, bir kaynak dağılım grafiği ve tıklanarak genişletilebilen detay paneline sahip bir sonuç tablosu.

Her ikisi de search ile aynı params değerini kabul eder. MCP Uygulamalarını desteklemeyen ana bilgisayarlar bu araçları yok sayar.

MCP ana bilgisayarı olmadan yerel olarak önizleyin:

uv run fastmcp dev apps src/server.py

Geliştirme

# Local development
uv sync && uv run src/server.py

# Docker
docker build -t serpapi-mcp . && docker run -p 8000:8000 serpapi-mcp

# Regenerate engine resources (Playground scrape)
python build-engines.py

# Testing with MCP Inspector
npx @modelcontextprotocol/inspector
# Configure: URL mcp.serpapi.com/YOUR_KEY/mcp, Transport "Streamable HTTP transport"

Sorun Giderme

• "API anahtarı eksik": Anahtarı URL yoluna /{YOUR_KEY}/mcp veya başlığa Bearer YOUR_KEY ekleyin
• "Geçersiz anahtar": serpapi.com/dashboard adresinden doğrulayın
• "Hız limiti aşıldı": Bekleyin veya SerpApi planınızı yükseltin
• "Sonuç yok": Farklı sorgu veya motor deneyin

Katkıda Bulunma

1. Depoyu çatallayın
2. Özellik dalınızı oluşturun: git checkout -b feature/amazing-feature
3. Bağımlılıkları yükleyin: uv install
4. Değişikliklerinizi yapın
5. Değişiklikleri işleyin: git commit -m 'Add amazing feature'
6. Dala gönderin: git push origin feature/amazing-feature
7. Bir Çekme İsteği açın

Lisans

MIT Lisansı - ayrıntılar için LICENSE dosyasına bakın.