gmapsscraper

Extraia leads de negócios do Google Maps (nomes, telefones, e-mails, sites, avaliações) do Claude, Cursor ou qualquer cliente MCP através da API do gmapsscraper.io.

GitHub
3
Experimente este MCPPatrocinado

Documentação

Servidor MCP gmapsscraper

npm version license

Servidor MCP (Model Context Protocol) para gmapsscraper.io — permite que Claude, Cursor, Windsurf e qualquer cliente MCP raspem dados de empresas do Google Maps em conversa natural: nomes, endereços, telefones, e-mails, sites, avaliações, contagem de reviews, categorias e coordenadas.

"Encontre 50 dentistas em Chicago com seus e-mails" → pronto, direto no seu chat de IA.

Ferramentas

FerramentaO que faz
scrape_google_mapsPesquisa no Google Maps e retorna leads de empresas (bloqueia até concluir, ~30–120s)
start_scrape_jobVersão do tipo "disparar e esquecer" — retorna um ID de job imediatamente
get_scrape_resultsBusca resultados de um job iniciado anteriormente
get_creditsVerifica o saldo restante de créditos

Cada raspagem custa 2 créditos; múltiplas palavras-chave em uma única chamada custam o mesmo. Plano gratuito: 10 créditos (5 buscas, sem cartão de crédito) — obtenha uma chave de API em gmapsscraper.io/dashboard.

Configuração

Claude Code

claude mcp add gmapsscraper -e GMAPSSCRAPER_API_KEY=your_key -- npx -y @gmapsscraper/mcp

Claude Desktop / Cursor / Windsurf

Adicione ao seu arquivo de configuração do MCP (claude_desktop_config.json, .cursor/mcp.json, etc.):

{
  "mcpServers": {
    "gmapsscraper": {
      "command": "npx",
      "args": ["-y", "@gmapsscraper/mcp"],
      "env": {
        "GMAPSSCRAPER_API_KEY": "your_key"
      }
    }
  }
}

Cursor Directory / Open Plugins

A instalação a partir de um diretório de plugins usa o mcp.json empacotado, que deliberadamente é distribuído sem um bloco env — a especificação do Open Plugins só expande ${PLUGIN_ROOT} e ${PLUGIN_DATA}, então um espaço reservado secreto seria passado literalmente e o servidor falharia na autenticação.

Defina a chave no seu próprio ambiente antes de iniciar o cliente:

# macOS / Linux — add to ~/.zshrc or ~/.bashrc
export GMAPSSCRAPER_API_KEY=your_key

# Windows PowerShell
setx GMAPSSCRAPER_API_KEY "your_key"

Reinicie o cliente depois para que ele reconheça a variável. Se uma raspagem retornar um erro de autenticação, execute get_credits primeiro — ele falha rapidamente e confirma se a chave está sendo vista.

Requer Node.js ≥ 18. O servidor roda localmente via stdio e fala com a API do gmapsscraper.io — sem outra infraestrutura envolvida.

Exemplos de prompts

  • "Raspe cafeterias em Austin, TX, com e-mails e me dê uma tabela"
  • "Encontre encanadores em Miami e depois rascunhe um e-mail frio para os 5 melhores por avaliação"
  • "Inicie uma raspagem para 'fotógrafo de casamento em Denver, CO', volto depois"
  • "Quantos créditos de gmapsscraper ainda tenho?"

Dados retornados por empresa

title, address, phone, email, website, rating, reviews_count, category, latitude, longitude, google_maps_url, opening_hours

Os resultados são limitados a 100 empresas por resposta para manter seu contexto organizado; o CSV completo está sempre disponível no dashboard.

Relacionados

Licença

MIT © gmapsscraper.io