Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

MCP (Model Context Protocol) é um protocolo de contexto de modelo lançado pela Anthropic, que permite que modelos de IA (como Claude, GPT, etc.) chamem ferramentas externas através de interfaces padronizadas. Através do SERP MCP Server fornecido pela XHuoAPI, você pode realizar buscas no Google diretamente em clientes de IA como Claude Desktop, VS Code, Cursor, etc., obtendo resultados de busca de páginas da web, imagens, notícias, vídeos, locais, entre outros.

​
Visão Geral das Funcionalidades

O SERP MCP Server oferece as seguintes funcionalidades principais:
  • Busca na Web — Pesquisar resultados de páginas do Google
  • Busca de Imagens — Pesquisar imagens do Google
  • Busca de Notícias — Pesquisar notícias do Google
  • Busca de Vídeos — Pesquisar vídeos do Google
  • Busca de Locais — Pesquisar informações de locais do Google
  • Busca de Mapas — Pesquisar mapas do Google
  • Multilíngue e Multirregional — Suporte a parâmetros de país e idioma personalizados
  • Filtragem por Intervalo de Tempo — Filtrar resultados por dia, semana, mês, ano

​
Preparativos

Antes de usar, você precisa obter o Token da API da XHuoAPI:
  1. Registre-se ou faça login na plataforma XHuoAPI
  2. Vá para a página Google SERP API
  3. Clique em “Acquire” para obter o Token da API (primeira solicitação oferece crédito gratuito)

​
Instalação e Configuração

​
Método 1: Instalação via pip (recomendado)

pip install mcp-serp

​
Método 2: Instalação a partir do código-fonte

git clone https://github.com/XHuoAPI/SerpMCP.git
cd SerpMCP
pip install -e .
Após a instalação, você pode usar o comando mcp-serp para iniciar o serviço.

​
Usando no Claude Desktop

Edite o arquivo de configuração do Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Adicione a seguinte configuração: 
{
  "mcpServers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}
Se usar uvx (sem necessidade de instalar pacotes previamente): 
{
  "mcpServers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}
Após salvar a configuração, reinicie o Claude Desktop para usar as ferramentas de busca do Google nas conversas.

​
Usando no VS Code / Cursor

Crie um arquivo .vscode/mcp.json no diretório raiz do projeto: 
{
  "servers": {
    "serp": {
      "command": "mcp-serp",
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}
Ou use uvx: 
{
  "servers": {
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "seu Token da API"
      }
    }
  }
}

​
Lista de Ferramentas Disponíveis

Nome da FerramentaDescrição
serp_google_searchBusca na web do Google
serp_google_imagesBusca de imagens do Google
serp_google_newsBusca de notícias do Google
serp_google_videosBusca de vídeos do Google
serp_google_placesBusca de locais do Google
serp_google_mapsBusca de mapas do Google

​
Exemplos de Uso

Após a configuração, você pode chamar essas funcionalidades diretamente em linguagem natural nos clientes de IA, por exemplo:
  • “Ajude-me a pesquisar os artigos mais recentes sobre IA”
  • “Pesquise restaurantes de hot pot deliciosos em Pequim”
  • “Encontre imagens sobre programação assíncrona em Python”
  • “Pesquise as notícias de tecnologia de hoje”
  • “Encontre cafeterias próximas no mapa”

​
Mais Informações