Serper Search

Proporciona resultados de búsqueda de Google e investigación profunda impulsada por IA utilizando la API de Serper.

Documentación

Servidor MCP de Búsqueda Serper

Un servidor de Protocolo de Contexto de Modelo que proporciona capacidades de búsqueda en Google a través de la API de Serper, junto con una herramienta de Investigación Profunda impulsada por IA. Este servidor permite una integración sencilla de funcionalidades de búsqueda e investigación en sus aplicaciones habilitadas para MCP.

✨ Características

🌐 Potente integración de búsqueda en Google a través de la API de Serper
🔄 Datos de respuesta de búsqueda enriquecidos, incluyendo:
- Información del Knowledge Graph
- Resultados de búsqueda orgánicos
- Preguntas de "La gente también pregunta"
- Búsquedas relacionadas
🧠 Herramienta de Investigación Profunda impulsada por IA:
- Realiza investigaciones iterativas en múltiples pasos
- Genera subconsultas para explorar temas a fondo
- Sintetiza información de múltiples fuentes
- Proporciona citas para toda la información
- Niveles de profundidad de investigación ajustables
- Métricas de calidad integradas para mejora continua
🛠 Parámetros de búsqueda configurables:
- Segmentación por país
- Selección de idioma
- Personalización del número de resultados
- Opciones de autocorrección
🔒 Manejo seguro de claves API
⚡️ Soporte de limitación de velocidad y almacenamiento en caché
📝 Soporte de TypeScript con definiciones de tipos completas
📊 Métricas de rendimiento integradas para optimización de resultados

🚀 Instalación

Clone el repositorio:

git clone https://github.com/yourusername/serper-search-server.git
cd serper-search-server

Instale las dependencias:

pnpm install

Compile el servidor:

pnpm run build

⚙️ Configuración

Obtenga su clave API de Serper en [Serper.dev](https://serper.de
Create a .env file in the root directory:

# Required
SERPER_API_KEY=your_api_key_here

# Optional - Advanced Quality Metrics Configuration (pre-configured by default)
USAGE_METRICS_KEY=your-custom-metrics-key     # Optional
USAGE_PROJECT_ID=your-custom-project-id       # Optional
METRICS_ENDPOINT=https://your-custom-host.com # Optional
DISABLE_METRICS=false                         # Not recommended

See TELEMETRY.md para obtener información detallada sobre:

Recopilación de métricas de calidad
Monitoreo de rendimiento
Análisis de uso
Configuración del panel de control
Mejora continua

🔌 Integración

Claude Desktop

Agregue la configuración del servidor a su configuración de Claude Desktop:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "serper-search-server": {
      "command": "/path/to/serper-search-server/build/index.js",
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

🛠 Uso

Herramienta de Búsqueda

El servidor proporciona una potente herramienta de búsqueda con los siguientes parámetros:

{
  "query": string,          // Search query
  "numResults"?: number,    // Number of results (default: 10, max: 100)
  "gl"?: string,           // Country code (e.g., "us", "uk")
  "hl"?: string,           // Language code (e.g., "en", "es")
  "autocorrect"?: boolean, // Enable autocorrect (default: true)
  "type"?: "search"        // Search type (more types coming soon)
}

Herramienta de Investigación Profunda

Para necesidades de investigación más exhaustivas, el servidor proporciona una herramienta de investigación profunda que realiza investigaciones en múltiples pasos con los siguientes parámetros:

{
  "query": string,          // Research query or question
  "depth"?: "basic" | "standard" | "deep",  // Research depth (default: "standard")
  "maxSources"?: number     // Maximum sources to include (default: 10)
}

La herramienta de investigación profunda:

Descompone consultas complejas en subconsultas enfocadas
Ejecuta múltiples búsquedas para recopilar información completa
Utiliza IA para sintetizar información de múltiples fuentes
Formatea resultados con citas y referencias adecuadas
Adapta su estrategia de investigación según los resultados intermedios
Recopila métricas de calidad anónimas para mejorar los resultados de búsqueda

Niveles de profundidad:

básico: Resumen rápido (3-5 fuentes, ~5 min) Bueno para: Datos simples, definiciones rápidas, preguntas directas
estándar: Análisis completo (5-10 fuentes, ~10 min) Bueno para: La mayoría de las necesidades de investigación, profundidad y velocidad equilibradas
profundo: Investigación exhaustiva (10+ fuentes, ~15-20 min) Bueno para: Temas complejos, investigación académica, análisis minucioso

Ejemplo de Respuesta de la Herramienta de Búsqueda

Los resultados de búsqueda incluyen datos enriquecidos:

{
  "searchParameters": {
    "q": "apple inc",
    "gl": "us",
    "hl": "en",
    "autocorrect": true,
    "type": "search"
  },
  "knowledgeGraph": {
    "title": "Apple",
    "type": "Technology company",
    "website": "http://www.apple.com/",
    "description": "Apple Inc. is an American multinational technology company...",
    "attributes": {
      "Headquarters": "Cupertino, CA",
      "CEO": "Tim Cook (Aug 24, 2011–)",
      "Founded": "April 1, 1976, Los Altos, CA"
    }
  },
  "organic": [
    {
      "title": "Apple",
      "link": "https://www.apple.com/",
      "snippet": "Discover the innovative world of Apple...",
      "position": 1
    }
  ],
  "peopleAlsoAsk": [
    {
      "question": "What does Apple Inc mean?",
      "snippet": "Apple Inc., formerly Apple Computer, Inc....",
      "link": "https://www.britannica.com/topic/Apple-Inc"
    }
  ],
  "relatedSearches": [
    {
      "query": "Who invented the iPhone"
    }
  ]
}

🔍 Tipos de Respuesta

Knowledge Graph

Contiene información de entidades cuando está disponible:

Título y tipo
URL del sitio web
Descripción
Atributos clave

Resultados Orgánicos

Lista de resultados de búsqueda que incluyen:

Título y URL
Fragmento (descripción)
Posición en los resultados
Enlaces de sitio cuando están disponibles

La Gente También Pregunta

Preguntas comunes relacionadas con la búsqueda:

Texto de la pregunta
Fragmento de respuesta
Enlace de origen

Búsquedas Relacionadas

Lista de consultas de búsqueda relacionadas que los usuarios suelen realizar.

📊 Métricas de Calidad

La herramienta de Investigación Profunda incluye métricas de calidad integradas:

Métricas del proceso de investigación
Monitoreo de rendimiento
Seguimiento de problemas
Patrones de uso
Indicadores de calidad de resultados

Consulte TELEMETRY.md para obtener información detallada sobre las métricas recopiladas para mejorar la calidad de búsqueda.

🤝 Contribuciones

¡Las contribuciones son bienvenidas! No dude en enviar una Solicitud de Extracción (Pull Request).

📝 Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulte el archivo LICENSE para más detalles.

🙏 Agradecimientos

API de Serper por proporcionar las capacidades de búsqueda en Google
Protocolo de Contexto de Modelo por el marco MCP
PostHog por las capacidades de análisis