Servidor MCP do Google Search e Maps: Claude, ChatGPT, Cursor

Você pede, ele coleta

O assistente escolhe as ferramentas certas, inicia as buscas, espera os resultados e responde. Alguns exemplos:

“Pegue os AI Overviews destas 20 palavras-chave e ordene os domínios mais citados.”

“Compare o top 10 de ‘encanador’ em São Paulo e no Rio de Janeiro, no celular.”

“Liste os 20 primeiros perfis do Google Maps para ‘restaurante’ em São Paulo, com a nota e o número de avaliações.”

Oito ferramentas, todas incluídas

Todas as ferramentas estão disponíveis com a sua chave de API. Só as duas de busca consomem saldo, pelo preço normal da API; as outras seis não consomem nada.

Ferramenta	Para que serve
`google_search`	SERP do Google de uma ou mais palavras-chave: todos os blocos, AI Overviews incluídos, com posição, página e posição em pixels. Parâmetros e blocos em detalhe na página API do Google Search.
`google_maps`	Perfis do Google Maps de uma busca, a partir de uma cidade ou de uma posição GPS.
`get_serp_results`	Resultados de buscas já iniciadas, por ID. Não consome saldo.
`list_searches`	Histórico de buscas da conta, das mais recentes às mais antigas: para recuperar IDs, inclusive após uma queda de conexão, sem pagar duas vezes. Não consome saldo.
`ai_overview_sources`	Domínios citados nos AI Overviews de um lote de buscas, calculados pelo servidor, com as palavras-chave correspondentes. Não consome saldo.
`get_balance`	Saldo da conta. Não consome saldo.
`list_google_versions`	Versões do Google e idiomas disponíveis. Não consome saldo.
`get_queue_status`	Buscas pendentes, em andamento e concluídas. Não consome saldo.

Instalação em um minuto

Sua chave fica no menu Chaves de API da sua conta Semscraper. Substitua CHAVE_API por essa chave.

No terminal, execute o comando abaixo e abra uma nova sessão do Claude Code:

terminal

claude mcp add --transport http semscraper https://mcp.semscraper.com/mcp --header "Authorization: Bearer CHAVE_API"

Em Configurações > Conectores, clique em “Adicionar conector personalizado”, dê o nome Semscraper e cole o endereço abaixo. O conector funciona no claude.ai, no Claude Desktop e no celular. Os conectores personalizados dependem do seu plano do Claude: nos planos Team ou Enterprise, quem os adiciona é um administrador da organização.

URL

https://mcp.semscraper.com/mcp?key=CHAVE_API

No Claude e no ChatGPT, a chave vai no endereço: por enquanto é o único método aceito por essas plataformas. Guarde esse endereço só para você, como uma senha, e use de preferência uma chave exclusiva para o MCP.

Nas configurações do ChatGPT, ative o modo desenvolvedor e crie um conector com o endereço abaixo. A disponibilidade dos conectores depende do seu plano do ChatGPT.

URL

https://mcp.semscraper.com/mcp?key=CHAVE_API

No Claude e no ChatGPT, a chave vai no endereço: por enquanto é o único método aceito por essas plataformas. Guarde esse endereço só para você, como uma senha, e use de preferência uma chave exclusiva para o MCP.

Adicione este bloco ao arquivo ~/.cursor/mcp.json (ou em Cursor Settings > MCP) e reinicie o Cursor:

mcp.json

{
  "mcpServers": {
    "semscraper": {
      "url": "https://mcp.semscraper.com/mcp",
      "headers": {
        "Authorization": "Bearer CHAVE_API"
      }
    }
  }
}

Para testar, é só perguntar: “Qual é o meu saldo no Semscraper?”

Seu assistente não está na lista? Qualquer cliente compatível com MCP funciona, de preferência com o cabeçalho Authorization: Bearer, ou então com o endereço que contém a chave.

Uma chave só para o seu assistente. Você pode criar quantas chaves de API quiser no menu Chaves de API. Reserve uma para o MCP, com um orçamento diário ou de 30 dias, ou somente leitura: o assistente consulta seus resultados, seu histórico e seu saldo, mas não consegue iniciar nenhuma busca. Uma chave pode ser excluída a qualquer momento, sem afetar as outras.

Buscas pequenas ou grandes volumes

Cada página do Google é carregada em um navegador real, com interface gráfica: é isso que permite obter os AI Overviews e suas fontes, os elementos dinâmicos e a posição em pixels de cada resultado. Uma fila distribui as buscas entre nossas máquinas, o que mantém nossos preços entre os mais baixos do mercado. Conte com uma mediana de cerca de trinta segundos por busca. Por padrão, a ferramenta espera os resultados; para um lote grande, o assistente inicia as buscas sem esperar e busca os resultados depois, sem pagar duas vezes.

Resultados diretos

Com poucas palavras-chave, a ferramenta espera a coleta terminar e retorna os resultados na mesma resposta.

Grandes volumes

A ferramenta inicia as buscas e libera o assistente na hora. Ele busca os resultados depois, sem pagar duas vezes.

Respostas compactas

Filtro por bloco e por número de resultados por bloco: o assistente lê só o que precisa e economiza tokens.

Como o Semscraper é usado para IA

Pague por requisição

O mesmo preço da API, sem assinatura: cada SERP obtida é descontada do seu saldo.

€ 0,30 a cada 1.000 palavras-chave, página 1

+€ 0,20 por página extra, a cada 1.000 palavras-chave

€ 2,10 a cada 1.000 palavras-chave em 10 páginas

De 1 a 10% de desconto conforme o valor recarregado. Seu saldo nunca expira.

Ver os preços em detalhe

FAQ

Perguntas frequentes

O que é um servidor MCP?

MCP (Model Context Protocol) é um padrão aberto que permite que um assistente de IA use ferramentas externas. Depois de conectar o servidor do Semscraper, o assistente coleta SERPs do Google sozinho, sem que você escreva nenhum código.

Minha chave de API fica armazenada?

Não. O servidor não guarda nada: cada requisição é processada com a chave enviada junto com ela e depois esquecida. As buscas passam pela API do Semscraper, com as mesmas regras e o mesmo saldo.

Quanto tempo leva uma busca?

Em mediana, cerca de trinta segundos, e cerca de um minuto para 10 páginas, porque cada página é renderizada em um navegador real. Para grandes volumes, o assistente inicia as buscas sem esperar e busca os resultados depois.

O assistente obtém o conteúdo das páginas?

O servidor retorna o que o Google mostra: URLs, títulos, snippets, AI Overviews e suas fontes. Se o assistente tiver uma ferramenta de leitura de páginas, ele pode abrir em seguida as URLs que interessam.

Posso limitar quanto o assistente gasta?

Sim. Crie uma chave exclusiva para o MCP com um orçamento diário ou de 30 dias: acima dele, as buscas são recusadas e o assistente avisa você. Uma chave somente leitura não inicia buscas, então não gasta nada.

Semscraper no Claude, ChatGPT e Cursor