Passo a passo

Extrator de Leads do Google Maps com o Claude

Em poucos minutos, uma planilha com as empresas da sua cidade: telefone, link de WhatsApp, Instagram, site, nota no Google e até quem já anuncia no Meta e no Google Ads.

O que você precisa ter

Computador com Windows 10 ou 11

O atalho .bat é só para Windows. No Mac, o extrator roda pelo Terminal: veja o README do repositório.

Google Chrome ou Microsoft Edge

O Edge já vem no Windows.

Python 3.9 ou mais novo

Baixe em python.org/downloads.

Na instalação, marque a opção Add python.exe to PATH. Se não marcar, nada funciona.

No instalador novo do Python, essa opção aparece como uma pergunta no terminal: Add commands directory to your PATH now? Digite y e aperte Enter.

Terminal do instalador do Python com a pergunta Add commands directory to your PATH now, circulada em vermelho e respondida com y

App do Claude para computador

Com uma pasta liberada para ele trabalhar.

Internet

Não precisa de chave de API nem pagar nada pelo extrator.

Passo a passo

Passo 1

Acesse o repositório

É um projeto gratuito e de código aberto (licença MIT).

https://github.com/Mahanaicoach/google-maps-scraper-kit

Abrir o repositório no GitHub

Página do repositório no GitHub, com o nome google-maps-scraper-kit circulado em vermelho

Passo 2

Crie uma pasta na Área de Trabalho

Clique com o botão direito na Área de Trabalho.
Clique em Novo.
Clique em Pasta.
Dê o nome Leads-Scraper.

Pasta nova na Área de Trabalho do Windows, circulada em vermelho

Passo 3

Peça pro Claude instalar

Abra o app do Claude.
Selecione a pasta Leads-Scraper.
Cole o prompt abaixo.

Quando o Claude pedir permissão para rodar comandos, aprove. Leva alguns minutos.

Prompt

Instale o repositório https://github.com/Mahanaicoach/google-maps-scraper-kit nesta pasta e rode os testes dele para confirmar que está funcionando.

Depois crie, nesta mesma pasta (fora da pasta do repositório), um arquivo Extrair-Leads.bat que funcione com dois cliques no Windows e:
1. Encontre o Python instalado e avise em português se não encontrar.
2. Ligue o motor do kit (scripts/engine.py start).
3. Pergunte em português o que buscar (ex.: barbearia) e a cidade (ex.: Ourinhos, SP).
4. Me deixe escolher o tamanho da busca (rápida com ~100 empresas, cidade inteira com --grid 3 ou varredura completa com --deep-scan), um filtro (todas, só sem site, só com telefone, nota 4+ com telefone) e se quero detectar quem já anuncia (--tech).
5. Rode a busca em português do Brasil (--lang pt --country br) e salve numa pasta "leads" com o nome "Nicho - Cidade - data.csv".
6. Se já existir uma lista do mesmo nicho e cidade, pergunte se quero só empresas novas (--exclude).
7. Gere também uma cópia "(Excel).csv" com separador ponto e vírgula, colunas em português, nota com vírgula, link de WhatsApp (wa.me) para celulares e uma coluna "Já anuncia?".
8. No fim, mostre um resumo e abra a pasta leads.
Use só a biblioteca padrão do Python.

App do Claude com a pasta selecionada e a caixa de mensagem circuladas em vermelho

Passo 4

Clique no atalho e busque

Abra a pasta Leads-Scraper.
Dê dois cliques em Extrair-Leads.bat.
Responda as perguntas.

Pasta aberta no Windows, com o arquivo Extrair-Leads.bat circulado em vermelho

As opções

Tamanho: rápida (~100 empresas, 1 a 3 min), cidade inteira (~5 a 15 min), varredura completa (lenta, 20+ min).
Filtro: todas, só sem site, só com telefone, nota 4,0+ com telefone.
Detectar quem já anuncia: procura o Pixel da Meta e a tag do Google Ads no site de cada empresa e coloca os mais quentes no topo.
Só empresas novas: na segunda busca do mesmo nicho e cidade, traz só o que ainda não está nas suas listas.

Como a pasta fica no final

Leads-Scraper\
├── Extrair-Leads.bat
├── ferramentas\extrair_leads.py
├── google-maps-scraper-kit\
└── leads\

Se o Claude organizar um pouco diferente, tudo bem. O importante é ter o Extrair-Leads.bat e a pasta leads.

Plano B: o Claude não criou o atalho?

Baixe o atalho pronto. Extraia o zip dentro da pasta Leads-Scraper, ao lado da pasta google-maps-scraper-kit. O nome dessa pasta precisa ser exatamente google-maps-scraper-kit.

Baixar atalho pronto (.zip)

Entendendo a planilha

Você recebe dois arquivos:

Nicho - Cidade - data (Excel).csv: abra este no Excel.
Nicho - Cidade - data.csv: original, para Google Sheets ou CRM.

O Excel em português usa “;”, por isso o arquivo original abre tudo numa coluna só.

Planilha aberta no Excel com colunas em português e dados fictícios, com o nome do arquivo terminado em Excel circulado em vermelho

O que tem em cada coluna

Coluna	O que é
Nome	O nome da empresa no Google Maps.
Telefone	O número que aparece no Google Maps.
Tipo de telefone	Celular ou Fixo.
WhatsApp	Link wa.me pronto, só para celulares.
E-mail	Lido do site da empresa, quando ela publica um.
Site	O endereço do site.
Tem site?	Sim ou Não.
Categoria	O tipo de negócio no Google Maps.
Endereço	O endereço da empresa.
Nota	A nota no Google, de 1 a 5.
Avaliações	Quantas avaliações a empresa tem.
Instagram, Facebook, LinkedIn, TikTok, YouTube, X	As redes encontradas no site da empresa.
Provedor do e-mail	Onde o e-mail está hospedado.
Já anuncia?	Sim, se o site tem o Pixel da Meta ou a tag do Google Ads.
Pixel Meta	Sim, se o site tem o código de anúncios da Meta.
Tag Google Ads	Sim, se o site tem o código do Google Ads.
Google Analytics	Sim, se o site mede as visitas.
Bing Ads, LinkedIn Insight, Pixel TikTok	Sim, se o site tem o código de anúncios de cada um.
Plataforma do site	Em que o site foi feito, como WordPress ou Wix.
Site mobile	Sim, se o site foi feito para celular.
Score de intenção	Nota de 0 a 100 de quem já investe em marketing.

As colunas de anúncios, plataforma, site mobile e score aparecem quando você escolhe detectar quem já anuncia.

Score de intenção (0 a 100)

Pixel da Meta +35
Tag do Google Ads +25
Google Analytics +10
50 ou mais avaliações (de 10 a 49: +8) +15
Nota 4,0 ou mais +10
E-mail encontrado +5

A lista vem do maior para o menor.

Erros comuns

“Python não foi encontrado”

Reinstale o Python marcando Add python.exe to PATH e reinicie o computador.

“O Windows protegeu o computador” ao abrir o .bat

Clique em “Mais informações” e depois em “Executar assim mesmo”. Faça isso só com o arquivo que o Claude criou ou que você baixou desta página.

“Não achei a cidade no mapa”

Escreva no formato Cidade, UF. Exemplo: Cornélio Procópio, PR.

“Busca incompleta” ou o Google limitou

Muitas buscas seguidas fazem o Google pausar a sua internet por algumas horas. Sua conta Google não é afetada. Espere uma hora e rode de novo com “só empresas novas”. Faça uma busca por vez.

A planilha abriu toda numa coluna só

Abra o arquivo que termina em “(Excel)”.

“O motor não ligou”

Confira se o Chrome ou o Edge está instalado e abra o atalho de novo.

Funciona no Mac?

O extrator sim, pelo Terminal (veja o README do repositório). O atalho .bat não.

É pago?

O extrator é gratuito e de código aberto. Você só precisa do Claude no computador.

Quantos leads dá pra tirar?

Cerca de 100 na busca rápida. No modo cidade inteira passa de centenas. O limite é usar com moderação.

Uso responsável

Telefone e e-mail são dados pessoais (LGPD). Na primeira mensagem, diga quem você é e por que está entrando em contato, e ofereça a opção de não receber mais mensagens.
Não venda nem repasse listas, e não faça disparo em massa.
Extrair dados do Google Maps vai contra os termos de uso do Google: use com moderação, para prospecção.
Este guia não é orientação jurídica.

Tem a lista. E agora?

A Markant faz anúncios no Meta que trazem cliente direto pro WhatsApp da sua empresa.

Falar com a Markant no WhatsApp

O extrator é o Google Maps Scraper Kit, criado por Mahanaicoach (licença MIT). A Markant criou o atalho em português e este guia.