Serper Search

Fornece resultados de pesquisa do Google e pesquisa aprofundada com inteligência artificial usando a API Serper.

GitHub
48
Experimente este MCPPatrocinado

Documentação

Servidor MCP Serper Search

Um servidor Model Context Protocol que fornece recursos de busca no Google por meio da API Serper, juntamente com uma ferramenta de Pesquisa Profunda com tecnologia de IA. Este servidor permite a integração fácil de funcionalidades de busca e pesquisa em seus aplicativos habilitados para MCP.

✨ Recursos

  • 🌐 Integração poderosa de busca no Google por meio da API Serper
  • 🔄 Dados ricos de resposta de busca, incluindo:
    • Informações do Knowledge Graph
    • Resultados orgânicos de busca
    • Perguntas "As pessoas também perguntam"
    • Buscas relacionadas
  • 🧠 Ferramenta de Pesquisa Profunda com tecnologia de IA:
    • Realiza pesquisas iterativas em várias etapas
    • Gera subconsultas para explorar tópicos a fundo
    • Sintetiza informações de múltiplas fontes
    • Fornece citações para todas as informações
    • Níveis de profundidade de pesquisa ajustáveis
    • Métricas de qualidade integradas para melhoria contínua
  • 🛠 Parâmetros de busca configuráveis:
    • Segmentação por país
    • Seleção de idioma
    • Personalização da quantidade de resultados
    • Opções de autocorreção
  • 🔒 Tratamento seguro de chaves de API
  • ⚡️ Suporte a limite de taxa e cache
  • 📝 Suporte a TypeScript com definições de tipos completas
  • 📊 Métricas de desempenho integradas para otimização de resultados

🚀 Instalação

  1. Clone o repositório:
git clone https://github.com/yourusername/serper-search-server.git
cd serper-search-server
  1. Instale as dependências:
pnpm install
  1. Compile o servidor:
pnpm run build

⚙️ Configuração

  1. Obtenha sua chave de API Serper em [Serper.dev](https://serper.de

  2. 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 informações detalhadas sobre:

  • Coleta de métricas de qualidade
  • Monitoramento de desempenho
  • Análise de uso
  • Configuração de painel
  • Melhoria contínua

🔌 Integração

Claude Desktop

Adicione a configuração do servidor à sua configuração do 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

Ferramenta de Busca

O servidor fornece uma ferramenta de busca poderosa com os seguintes 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)
}

Ferramenta de Pesquisa Profunda

Para necessidades de pesquisa mais abrangentes, o servidor fornece uma ferramenta de pesquisa profunda que realiza pesquisas em várias etapas com os seguintes parâmetros:

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

A ferramenta de pesquisa profunda:

  • Divide consultas complexas em subconsultas focadas
  • Executa múltiplas buscas para reunir informações abrangentes
  • Usa IA para sintetizar informações de múltiplas fontes
  • Formata resultados com citações e referências adequadas
  • Adapta sua estratégia de pesquisa com base em resultados intermediários
  • Coleta métricas de qualidade anônimas para melhorar os resultados de busca

Níveis de profundidade:

  • básico: Visão geral rápida (3-5 fontes, ~5 min) Bom para: Fatos simples, definições rápidas, perguntas diretas
  • padrão: Análise abrangente (5-10 fontes, ~10 min) Bom para: A maioria das necessidades de pesquisa, profundidade e velocidade equilibradas
  • profundo: Pesquisa exaustiva (10+ fontes, ~15-20 min) Bom para: Tópicos complexos, pesquisa acadêmica, análise aprofundada

Exemplo de Resposta da Ferramenta de Busca

Os resultados da busca incluem dados ricos:

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

Knowledge Graph

Contém informações de entidades quando disponíveis:

  • Título e tipo
  • URL do site
  • Descrição
  • Atributos principais

Resultados Orgânicos

Lista de resultados de busca, incluindo:

  • Título e URL
  • Trecho (descrição)
  • Posição nos resultados
  • Links de site quando disponíveis

As Pessoas Também Perguntam

Perguntas comuns relacionadas à busca:

  • Texto da pergunta
  • Trecho da resposta
  • Link da fonte

Buscas Relacionadas

Lista de consultas de busca relacionadas que os usuários costumam fazer.

📊 Métricas de Qualidade

A ferramenta de Pesquisa Profunda inclui métricas de qualidade integradas:

  • Métricas do processo de pesquisa
  • Monitoramento de desempenho
  • Rastreamento de problemas
  • Padrões de uso
  • Indicadores de qualidade dos resultados

Consulte TELEMETRY.md para informações detalhadas sobre as métricas coletadas para melhorar a qualidade da busca.

🤝 Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

📝 Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

🙏 Agradecimentos