SerpApi MCP Server

SerpApi ile entegre olan, kapsamlı arama motoru sonuçları ve veri çıkarımı sağlayan bir Model Context Protocol (MCP) sunucu uygulaması.

Özellikler

• Çoklu Arama Motoru: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay ve daha fazlası
• Motor Kaynakları: MCP kaynakları aracılığıyla motor başına parametre şemaları (bkz. Search Tool)
• Gerçek Zamanlı Hava Durumu Verileri: Arama sorguları aracılığıyla konum tabanlı hava durumu ve tahminler
• Borsa Verileri: Arama entegrasyonu aracılığıyla şirket finansmanları ve pazar verileri
• Dinamik Sonuç İşleme: Farklı sonuç türlerini otomatik olarak algılar ve biçimlendirir
• Esnek Yanıt Modları: Tam veya kompakt JSON yanıtları
• JSON Yanıtları: Tam veya kompakt modlar ile yapılandırılmış JSON çıktısı

Hızlı Başlangıç

SerpApi MCP Server, mcp.serpapi.com adresinde barındırılan bir hizmet olarak mevcuttur. Buna bağlanmak için bir API anahtarı sağlamanız gerekir. API anahtarınızı SerpApi panonuzdan 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"
    }
  }
}

Kendi Sunucunuzu 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 desteklenmektedir:

• Yol tabanlı: /YOUR_API_KEY/mcp (önerilir)
• Header tabanlı: Authorization: Bearer YOUR_API_KEY

Örnekler:

# Yol tabanlı
curl "https://mcp.serpapi.com/your_key/mcp" -d '...'

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

Search Tool

MCP sunucusunun tüm SerpApi motorlarını ve sonuç türlerini destekleyen bir ana Search Tool'u vardır. Tüm kullanılabilir parametreleri SerpApi API referansından bulabilirsiniz. Motor parametre şemaları ayrıca MCP kaynakları olarak sunulur: serpapi://engines (index) 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 parametreleri SerpApi API referansından görü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: Cevap kutuları, organik sonuçlar, haberler, resimler, alışveriş - otomatik olarak algılanır ve biçimlendirilir.

Geliştirme

# Yerel geliştirme
uv sync && uv run src/server.py

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

# Motor kaynaklarını yeniden oluştur (Playground scrape)
python build-engines.py

# MCP Inspector ile test etme
npx @modelcontextprotocol/inspector
# Yapılandır: URL mcp.serpapi.com/YOUR_KEY/mcp, Transport "Streamable HTTP transport"

Sorun Giderme

• "Missing API key": Anahtarı URL yoluna /{YOUR_KEY}/mcp veya header'a Bearer YOUR_KEY ekleyin
• "Invalid key": serpapi.com/dashboard adresinde doğrulayın
• "Rate limit exceeded": Bekleyin veya SerpApi planınızı yükseltin
• "No results": Farklı bir sorgu veya motor deneyin

Katkıda Bulunma

1. Deposu fork edin
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şiklikleri yapın
5. Değişiklikleri commit edin: git commit -m 'Add amazing feature'
6. Dala push edin: git push origin feature/amazing-feature
7. Bir Pull Request açın

Lisans

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