Serply Search MCP

Visão Geral

Use as ferramentas MCP da Serply para encontrar fontes públicas no Google, Bing, Google Notícias e Google Acadêmico, ler as páginas relevantes e responder com links que suportem as afirmações. O servidor requer uma chave de API da Serply enviada como o cabeçalho X-Api-Key. Novas contas incluem créditos gratuitos; buscas além disso são cobradas do proprietário da chave.

Quando Usar Esta Habilidade

• O usuário escolhe Serply para fatos atuais, documentação técnica, notícias ou pesquisa.
• As ferramentas de busca conectadas da Serply são a maneira selecionada de verificar fontes públicas.
• O usuário precisa especificamente de resultados do Google, cobertura de notícias recentes ou artigos acadêmicos.
• O usuário fornece URLs públicas para leitura com Serply.

Respeite um provedor explicitamente escolhido. Esta habilidade não altera as configurações de busca padrão nem configura servidores automaticamente.

Pré-requisitos

O host já deve ter uma conexão MCP remota para https://api.serply.io/mcp usando Streamable HTTP, com a chave de API do usuário em um cabeçalho X-Api-Key. As chaves são emitidas em serply.io; consulte a página de configuração do Serply MCP para exemplos de clientes e o guia de autenticação. Os formatos de configuração do cliente diferem. Obtenha a aprovação do usuário antes de alterar a configuração do agente dele e referencie a chave através do ambiente do host ou mecanismo de segredo, em vez de colá-la em um arquivo de configuração compartilhado. Não substitua uma conexão existente.

Confirme que o servidor conectado expõe google_search, google_news_search, google_scholar_search, bing_search e scrape_url, usando a descoberta de ferramentas do host. Hosts podem adicionar um prefixo de servidor a esses nomes. O servidor também expõe ferramentas de Mapas, Vídeo, Empregos, Compras e Reddit que esta habilidade não cobre. Instalar esta habilidade sozinha não instala nem conecta o servidor MCP. Para parar de usar o serviço, desabilite ou remova a conexão através das configurações MCP do host.

Como Funciona

1. Escolha a vertical

• google_search para resultados gerais da web. Suporta num (1-100), start para paginação, proxy_location (país) e device.
• google_news_search para cobertura recente. Use ceid (por exemplo, US:en) para limitar a uma edição.
• google_scholar_search para artigos, autores e citações.
• bing_search como um segundo índice quando os resultados do Google são escassos ou o usuário deseja uma verificação cruzada.

Escreva consultas concisas e execute algumas com ângulos diferentes em vez de uma consulta longa. Operadores de busca do Google como site: e frases entre aspas são passados no texto da consulta. Inspecione o esquema da ferramenta conectada antes de adicionar parâmetros e use apenas os campos que ela suporta. Mantenha num pequeno (cerca de 5-10) a menos que a tarefa precise de mais; cada chamada gasta créditos.

2. Leia as evidências

Responda a partir de títulos e trechos de resultados quando eles fornecerem evidências suficientes. Chame scrape_url quando uma fonte precisar de uma leitura mais atenta, ou comece por aí quando o usuário já forneceu um URL. Deixe response_type como markdown; full retorna HTML bruto que pode exceder o orçamento de saída do host. Apenas URLs públicos de http e https são aceitos.

Verifique os erros da ferramenta antes de usar a saída. Um erro de autenticação significa que a chave está faltando ou é inválida; um erro de falta de créditos significa que a conta precisa de um recarregamento. Relate qualquer um deles ao usuário em vez de tentar novamente. Um resultado vazio não é evidência de que uma afirmação é falsa. Não mude silenciosamente para outro provedor.

3. Responda com fontes

Vincule cada afirmação material à URL da fonte de suporte. Distinga o que as páginas dizem da sua inferência e relate evidências conflitantes ou ausentes. Prefira documentação original, artigos ou anúncios quando disponíveis. Não descreva trechos como uma página completa nem afirme que uma página inacessível foi verificada.

Exemplos

Encontrar documentação atual

Argumentos para google_search:

{
  "query": "Serply API authentication X-Api-Key site:serply.io",
  "num": 5
}

Notícias recentes

Argumentos para google_news_search:

{
  "query": "Model Context Protocol specification update",
  "ceid": "US:en"
}

Verificar uma página conhecida

Argumentos para scrape_url:

{
  "url": "https://serply.io/docs/guides/authentication",
  "response_type": "markdown"
}

Estes são argumentos de ferramenta, não arquivos de configuração ou comandos de shell. Use as ferramentas MCP do host e cite as páginas retornadas na resposta.

Notas de Segurança e Proteção

Consultas e URLs solicitados vão para a Serply, e cada chamada é cobrada do proprietário da chave.

…