Lista de clientes da sua região com o Google Maps e IA
A ferramenta gratuita, os links e o guia de uso completo, direto aqui na página: da instalação à primeira lista de potenciais clientes, com pedidos prontos para copiar.
O material
As ferramentas e o guia de uso
Ferramentas
Os três links que você precisa.
Projeto no GitHub: Google Maps Scraper Kit
- O que é: o kit gratuito e de código aberto (licença MIT) que pesquisa empresas no Google Maps e roda no seu computador.
- Por baixo: usa um raspador de código aberto muito conhecido, o gosom/google-maps-scraper.
- No projeto: a ferramenta, os comandos para o Claude e a documentação completa.
No GitHub, clique em Code e depois em Download ZIP. Descompacte a pasta no seu computador.
Docker Desktop
- O que é: o programa que mantém a ferramenta de busca rodando no seu computador. É obrigatório.
- Onde roda: Mac e Windows.
- Preço: tem plano gratuito para uso pessoal. Para empresa, confira a licença no site do Docker.
Instale, abra o programa e deixe aberto enquanto estiver usando a ferramenta.
Claude Code
- O que é: o assistente que opera a ferramenta por você, em linguagem normal. É recomendado, mas opcional: dá para rodar por comando.
- Preço: incluído nos planos Pro e Max do Claude, e também nos planos Team e Enterprise.
Instale, entre com a sua conta e abra a pasta do projeto.
Como funciona
Você informa o que procura, a ferramenta faz o trabalho de pesquisa.
Você informa
A cidade e o tipo de empresa. Por exemplo, clínicas em Belo Horizonte.
A ferramenta pesquisa
Busca no Google Maps e, se você pedir, abre o site de cada empresa para achar e-mail e redes sociais.
Você recebe a lista
Uma planilha CSV organizada, que abre no Excel ou no Google Planilhas.
Antes de rodar
Três cuidados que o próprio projeto pede.
Leia antes da primeira busca
- Termos do Google: o projeto avisa que pesquisar o Google Maps desse jeito vai contra os termos de uso do Google. Use com volume moderado e trate o resultado como lista para conferir, nunca como base para revender.
- Dados pessoais: telefone e e-mail de empresa são dados pessoais. No Brasil vale a LGPD: fale com um motivo claro e respeite quem pedir para sair.
- Bloqueio: uso pesado pode limitar o seu endereço de internet por minutos ou horas. Sua conta do Google não é afetada. Faça uma busca por vez e comece com profundidade 5.
Pedidos prontos
Copie, cole e troque o que está entre colchetes.
Comandos de instalação (para quem usa o terminal)
Baixa o projeto e liga a ferramenta com o Docker. Quem baixou o ZIP só precisa do último comando.
Ver o texto do prompt
git clone https://github.com/Mahanaicoach/google-maps-scraper-kit.git cd google-maps-scraper-kit docker compose up -d
Cole no Terminal (Mac) ou no PowerShell (Windows). O primeiro uso baixa algumas centenas de MB e leva cerca de 5 minutos.
Pedido para montar a lista
Pede ao Claude Code para ligar a ferramenta, pesquisar e entregar a planilha.
Ver o texto do prompt
Confirme que a ferramenta de busca está rodando e, se não estiver, ligue. Depois monte uma lista de [tipo de empresa] em [cidade, estado], com profundidade 5, incluindo e-mail e redes sociais. Mostre uma tabela com nome, telefone, site e e-mail e salve o arquivo CSV completo. Se aparecer sinal de bloqueio (a busca falhar, vir vazia ou vir com muito menos empresas que o esperado), pare e me avise antes de tentar de novo.
Abra a pasta do projeto no Claude Code, cole o pedido e troque os colchetes. Na primeira vez, o Claude pergunta se você quer as redes sociais.
Pedido para decidir quem abordar primeiro
Lê a lista, separa as empresas por prioridade e sugere o primeiro contato.
Ver o texto do prompt
Vou anexar uma lista de empresas da minha região, com nome, telefone, site, e-mail e redes sociais quando existirem. O que eu vendo: [descreva em uma frase] Quem é o meu cliente ideal: [tipo de empresa, tamanho, o que ele precisa] Faça isto: 1. Separe as empresas em três grupos: prioridade alta, média e baixa, de acordo com o quanto elas combinam com o meu cliente ideal. 2. Para cada empresa de prioridade alta, diga em uma frase por que ela combina, com base só no que está na lista e no site dela. 3. Escreva uma primeira mensagem curta e educada para cada uma, citando algo específico da empresa e terminando com uma pergunta simples. 4. Marque as empresas que não têm nenhum dado de contato. Não invente informação sobre as empresas. Quando faltar dado, escreva "Não informado".
Cole no ChatGPT, Claude ou Gemini, preencha os colchetes e anexe a planilha.
A planilha
O que vem em cada linha da lista.
Colunas da lista
| Na planilha | O que é | Quando vem |
|---|---|---|
| title | O que éNome da empresa | Quando vemSempre |
| phone | O que éTelefone | Quando vemQuando a empresa cadastrou |
| emails | O que éE-mails achados no site da empresa | Quando vemQuando o site divulga |
| website | O que éSite | Quando vemQuando a empresa cadastrou |
| category | O que éTipo de negócio segundo o Google | Quando vemSempre |
| address | O que éEndereço | Quando vemSempre |
| review_rating e review_count | O que éNota e número de avaliações | Quando vemQuando a empresa tem avaliações |
| instagram, facebook e linkedin | O que éPerfis nas redes sociais | Quando vemSó se você pedir as redes e o site da empresa mostrar os perfis. A cobertura é parcial |
Se travar
Os problemas mais comuns e a saída para cada um.
Problemas comuns
- A ferramenta não responde: o Docker precisa estar aberto. Ligue de novo com o comando docker compose up -d.
- A busca fica parada: baixe a profundidade ou espere, porque o Google pode estar limitando o seu acesso.
- A planilha veio vazia: a busca estava estreita demais ou o local estava errado. Amplie o tipo de empresa ou confira a cidade.
- Mac com chip Apple (M1, M2, M3): se a ferramenta não ligar, o arquivo docker-compose.yml tem uma linha platform: linux/amd64 para ativar.
- Windows: use o Claude Code ou o comando py scripts/scrape.py. O arquivo scrape.sh só roda com WSL2 ou Git Bash.
A página SETUP.md do projeto no GitHub traz a lista completa de problemas e soluções.
Como usar
Guia de uso: do zero até a primeira lista
Instale o Docker Desktop e o Claude Code
Use os links da seção Ferramentas. Abra o Docker e deixe aberto. O Claude Code é recomendado porque faz o resto em linguagem normal.
Os dois programas instalados e abertos.
Baixe o projeto no GitHub
Clique em Code e depois em Download ZIP, e descompacte a pasta. Quem usa git pode clonar com o comando da seção Pedidos prontos.
A pasta google-maps-scraper-kit no seu computador.
Abra a pasta no Claude Code e ligue a ferramenta
Com a pasta aberta, digite /scrape-setup. Ele liga a ferramenta e confere se está funcionando. A primeira vez leva cerca de 5 minutos, quase todo no download.
A ferramenta de busca ligada e funcionando.
Peça a sua lista em linguagem normal
Use o Pedido para montar a lista, com a cidade e o tipo de empresa. Comece com profundidade 5 e deixe o Claude incluir as redes sociais.
Uma planilha CSV com as empresas da região.
Revise, priorize e aborde poucos
Abra a planilha, passe pelo pedido de prioridade e escolha um grupo pequeno. Respeite a LGPD e anote quem respondeu para voltar depois.
Os primeiros contatos, com quem mais combina com o seu cliente.
O tamanho real do problema
Onde esse material resolve e onde ele para
O que isso resolve
- Tira as horas de pesquisa empresa por empresa no Google.
- Entrega nome, telefone, site, endereço e, quando existem, e-mail e redes sociais numa planilha só.
- Dá ao comercial uma base para começar a prospectar hoje.
- Roda no seu computador, com ferramenta gratuita e de código aberto.
O que isso não resolve
- Quais empresas da lista têm perfil e necessidade reais.
- A conversa de abordagem e a resposta a cada interessado.
- O follow-up de quem não respondeu na primeira vez.
- O caminho do contato até a proposta e a venda.
Ter a lista é só o começo. Quem aborda, com qual mensagem e quem volta no lead que não respondeu decide se a lista vira venda ou vira uma planilha esquecida.
O próximo nível
Uma lista de empresas ainda não é uma venda
Quando a IA entra no comercial inteiro, a lista é a primeira etapa de um caminho que continua sem depender de alguém lembrando de cada contato.
O gargalo do comercial, com prioridade
Você descobre onde o comercial perde mais tempo e oportunidade, e começa por esse ponto.
Abordagem e follow-up com IA
A primeira mensagem e a retomada de quem não respondeu acontecem sem ficar na sua memória.
Lead qualificado antes do seu time
A IA separa quem tem perfil de quem só está olhando, e o seu time fala com quem importa.
Comercial menos dependente de você
O processo roda quando você não está olhando, e a equipe sabe o que a IA assumiu.
Descubra onde aplicar IA primeiro na sua empresa
Ao clicar, você vê como funciona o diagnóstico do programa e decide se faz sentido para a sua operação.
Perguntas rápidas
O que todo empresário pergunta antes de começar
A ferramenta é gratuita?
O projeto é gratuito e de código aberto. O Docker tem plano gratuito para uso pessoal. O Claude Code vem nos planos pagos do Claude, mas é opcional, porque dá para rodar por comando.
Preciso saber programar?
Com o Claude Code, não: você pede em linguagem normal. Sem ele, é preciso usar comandos no terminal, e o projeto tem a documentação de cada um.
Serve para qualquer cidade e segmento?
Você escolhe os dois. O resultado depende das empresas que estão cadastradas no Google Maps naquela região.
Posso mandar mensagem para a lista inteira?
Evite. Contato frio em massa costuma ser barrado pelas plataformas e exige cuidado com a LGPD. Comece com poucos contatos, bem escolhidos.
Isso é permitido pelo Google?
O próprio projeto avisa que pesquisar o Google Maps desse jeito vai contra os termos de uso do Google. Use com volume moderado, confira os dados e não revenda a lista.
Gere a primeira lista hoje e escolha só cinco empresas para abordar esta semana. O que acontece nessas cinco conversas mostra onde o seu comercial precisa de ajuda.
Sobre o Billy
Estrategista de IA aplicada a negócios
Fundador da East Rock, agência especializada em IA para prestadores de serviço. Testa na prática o que vira tendência no Brasil antes de chegar aqui.
- 3 anosde IA aplicada a negócios
- 1.000+empresários acelerados
- +R$ 200 milvendidos por um único agente
- East Rockfundador
