SerpApi MCP

Servidor MCP de SerpApi

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) que se integra con SerpApi para obtener resultados completos de motores de búsqueda y extracción de datos.

Características

• Búsqueda en múltiples motores: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay y más
• Recursos de motores: Esquemas de parámetros por motor disponibles a través de recursos MCP (ver Herramienta de Búsqueda)
• Datos meteorológicos en tiempo real: Clima basado en ubicación con pronósticos mediante consultas de búsqueda
• Datos del mercado de valores: Información financiera de empresas y datos de mercado a través de integración de búsqueda
• Procesamiento dinámico de resultados: Detecta y formatea automáticamente diferentes tipos de resultados
• Modos de respuesta flexibles: Respuestas JSON completas o compactas
• Respuestas JSON: Salida JSON estructurada con modos completo o compacto
• IU interactiva (MCP Apps): Herramientas opcionales search_table y search_dashboard que renderizan los resultados como una IU interactiva en los hosts compatibles

Inicio rápido

El Servidor MCP de SerpApi está disponible como servicio alojado en mcp.serpapi.com. Para conectarse, debe proporcionar una clave API. Puede encontrar su clave API en su panel de SerpApi.

Puede configurar Claude Desktop para usar el servidor alojado:

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

También puede agregar el servidor alojado a estos clientes MCP:

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

Autoalojamiento

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

Configurar Claude Desktop:

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

Obtenga su clave API: serpapi.com/manage-api-key

Autenticación

Se admiten dos métodos:

• Basado en ruta: /YOUR_API_KEY/mcp (recomendado)
• Basado en encabezado: Authorization: Bearer YOUR_API_KEY

Ejemplos:

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

Herramienta de Búsqueda

El servidor MCP tiene una herramienta de búsqueda principal que admite todos los motores y tipos de resultados de SerpApi. Puede encontrar todos los parámetros disponibles en la referencia de la API de SerpApi. Los esquemas de parámetros del motor también se exponen como recursos MCP: serpapi://engines (índice) y serpapi://engines/<engine>.

Los parámetros que puede proporcionar son específicos para cada motor de API. A continuación se muestran algunos parámetros de ejemplo:

• params.q (obligatorio): Consulta de búsqueda
• params.engine: Motor de búsqueda (predeterminado: "google_light")
• params.location: Filtro geográfico
• mode: Modo de respuesta - "complete" (predeterminado) o "compact"
• ...consulte otros parámetros en la referencia de la API de SerpApi

Ejemplos:

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

Motores compatibles: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay y más (ver serpapi://engines).

Tipos de resultados: Cuadros de respuesta, resultados orgánicos, noticias, imágenes, compras - detectados y formateados automáticamente.

IU interactiva (MCP Apps)

La herramienta predeterminada search devuelve JSON y no se modifica. Para hosts que admiten la extensión MCP Apps (SEP-1865), dos herramientas opcionales renderizan los resultados como una IU interactiva directamente en la conversación, para que el JSON masivo del SERP nunca entre en la ventana de contexto del modelo:

• search_table: resultados orgánicos como una tabla ordenable y con búsqueda.
• search_dashboard: métricas de resumen, un gráfico de desglose por fuente y una tabla de resultados con un panel de detalles que se expande al hacer clic.

Ambas aceptan los mismos params que search. Los hosts que no admiten MCP Apps simplemente ignoran estas herramientas.

Previsualícelas localmente sin un host MCP:

uv run fastmcp dev apps src/server.py

Desarrollo

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

Solución de problemas

• "Falta la clave API": Incluya la clave en la ruta URL /{YOUR_KEY}/mcp o en el encabezado Bearer YOUR_KEY
• "Clave no válida": Verifique en serpapi.com/dashboard
• "Límite de tasa excedido": Espere o actualice su plan de SerpApi
• "Sin resultados": Pruebe con una consulta o motor diferente

Contribuciones

1. Bifurque el repositorio
2. Cree su rama de funcionalidad: git checkout -b feature/amazing-feature
3. Instale dependencias: uv install
4. Realice sus cambios
5. Confirme los cambios: git commit -m 'Add amazing feature'
6. Empuje a la rama: git push origin feature/amazing-feature
7. Abra una Solicitud de Extracción

Licencia

Licencia MIT - consulte el archivo LICENSE para más detalles.