SerpApi MCP

Server MCP SerpApi

Implementasi server Model Context Protocol (MCP) yang terintegrasi dengan SerpApi untuk hasil mesin pencari dan ekstraksi data yang komprehensif.

Fitur

• Pencarian Multi-Mesin: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay, dan lainnya
• Sumber Daya Mesin: Skema parameter per mesin tersedia melalui sumber daya MCP (lihat Alat Pencarian)
• Data Cuaca Real-time: Cuaca berbasis lokasi dengan prakiraan melalui kueri pencarian
• Data Pasar Saham: Keuangan perusahaan dan data pasar melalui integrasi pencarian
• Pemrosesan Hasil Dinamis: Otomatis mendeteksi dan memformat berbagai jenis hasil
• Mode Respons Fleksibel: Respons JSON lengkap atau ringkas
• Respons JSON: Output JSON terstruktur dengan mode lengkap atau ringkas
• UI Interaktif (Aplikasi MCP): Alat search_table dan search_dashboard opsional yang merender hasil sebagai UI interaktif di host yang mendukung

Mulai Cepat

Server MCP SerpApi tersedia sebagai layanan terhosting di mcp.serpapi.com. Untuk terhubung, Anda perlu menyediakan kunci API. Anda dapat menemukan kunci API di dasbor SerpApi Anda.

Anda dapat mengonfigurasi Claude Desktop untuk menggunakan server terhosting:

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

Anda juga dapat menambahkan server terhosting ke klien MCP berikut:

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

Hosting Mandiri

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

Konfigurasi Claude Desktop:

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

Dapatkan kunci API Anda: serpapi.com/manage-api-key

Autentikasi

Dua metode didukung:

• Berbasis jalur: /YOUR_API_KEY/mcp (direkomendasikan)
• Berbasis header: Authorization: Bearer YOUR_API_KEY

Contoh:

# 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 '...'

Alat Pencarian

Server MCP memiliki satu Alat Pencarian utama yang mendukung semua mesin SerpApi dan jenis hasil. Anda dapat menemukan semua parameter yang tersedia di referensi API SerpApi. Skema parameter mesin juga diekspos sebagai sumber daya MCP: serpapi://engines (indeks) dan serpapi://engines/<engine>.

Parameter yang dapat Anda berikan spesifik untuk setiap mesin API. Beberapa contoh parameter disediakan di bawah ini:

• params.q (wajib): Kueri pencarian
• params.engine: Mesin pencari (default: "google_light")
• params.location: Filter geografis
• mode: Mode respons - "complete" (default) atau "compact"
• ...lihat parameter lain di referensi API SerpApi

Contoh:

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

Mesin yang Didukung: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay, dan lainnya (lihat serpapi://engines).

Jenis Hasil: Kotak jawaban, hasil organik, berita, gambar, belanja - otomatis terdeteksi dan diformat.

UI Interaktif (Aplikasi MCP)

Alat search default mengembalikan JSON dan tidak berubah. Untuk host yang mendukung ekstensi Aplikasi MCP (SEP-1865), dua alat opsional merender hasil sebagai UI interaktif langsung dalam percakapan, sehingga JSON SERP massal tidak pernah masuk ke jendela konteks model:

• search_table: hasil organik sebagai tabel yang dapat diurutkan dan dicari.
• search_dashboard: metrik ringkasan, bagan perincian sumber, dan tabel hasil dengan panel detail klik-untuk-perluas.

Keduanya menerima params yang sama dengan search. Host yang tidak mendukung Aplikasi MCP akan mengabaikan alat ini.

Pratinjau secara lokal tanpa host MCP:

uv run fastmcp dev apps src/server.py

Pengembangan

# 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"

Pemecahan Masalah

• "Kunci API hilang": Sertakan kunci di jalur URL /{YOUR_KEY}/mcp atau header Bearer YOUR_KEY
• "Kunci tidak valid": Verifikasi di serpapi.com/dashboard
• "Batas laju terlampaui": Tunggu atau tingkatkan paket SerpApi Anda
• "Tidak ada hasil": Coba kueri atau mesin yang berbeda

Berkontribusi

1. Fork repositori
2. Buat cabang fitur Anda: git checkout -b feature/amazing-feature
3. Instal dependensi: uv install
4. Lakukan perubahan Anda
5. Komit perubahan: git commit -m 'Add amazing feature'
6. Dorong ke cabang: git push origin feature/amazing-feature
7. Buka Pull Request

Lisensi

Lisensi MIT - lihat file LICENSE untuk detailnya.