Google Maps Scraper no Claude Code: Lista de Negócios Locais
Instale a skill do Google Maps Scraper no Claude Code e gere uma lista de negócios locais na sua máquina, com Docker e os avisos de termos e LGPD.
O que é
Google Maps Scraper no Claude Code: Lista de Negócios Locais
O Google Maps Scraper é um projeto open source (autor gosom, licença MIT, 6.669 estrelas em 20/10/2026) que coleta dados públicos de negócios do Google Maps: nome, telefone, site, endereço, avaliação, categoria e coordenadas. O repositório traz uma skill para o Claude Code que monta a busca, roda o scraper em Docker na sua máquina e entrega um CSV.
Neste tutorial você instala a skill com um comando, pede uma busca simples como dentistas em uma cidade e confere o resultado. Você também vê o que o scraper não faz sozinho: ele não remove duplicadas, não busca Instagram, Facebook ou LinkedIn e só extrai e-mail se você pedir.
A ressalva principal é jurídica: os termos do Google Maps restringem download em massa e a criação de bases de negócios para serviço concorrente, e telefone e e-mail podem ser dados pessoais. Use em escala pequena, para pesquisa e contato individual, nunca para disparo em massa.
Dados de negócios locais
Nome, telefone, site, endereço, avaliação, categoria e coordenadas em um CSV.
Skill de um comando
npx skills add gosom/google-maps-scraper, com Docker e Node.js instalados.
Roda na sua máquina
O scraper roda em Docker local. Proxy é opcional e a skill avisa quando ele ajuda.
E-mail só se você pedir
A extração de e-mail vem desligada, visita o site de cada negócio e demora mais.
Termos e LGPD no começo
Avisos antes do primeiro passo e um prompt para revisar dados de pessoa física.
Nível: intermediário · Tempo estimado: ~30 min na primeira vez, contando a instalação do Docker. O README indica que os resultados levam no mínimo cerca de 3 minutos para aparecer, e o tempo real depende da busca.
Termos do Google Maps. Os termos adicionais do Google Maps, na seção 2 (Prohibited Conduct, revisão de 27/01/2026), proíbem copiar o conteúdo, fazer download em massa ou criar feeds em massa dele e usar o Maps para criar ou ampliar uma base de dados (incluindo base de negócios, mailing list ou lista de telemarketing) para um serviço substituto ou semelhante ao Google Maps. O próprio README do scraper diz que raspar sem autorização pode violar termos de serviço. Leia os termos e use só em escala pequena e para pesquisa. Isto não é aconselhamento jurídico.
LGPD e contato. Telefone e e-mail de um negócio individual (consultório, MEI, profissional liberal) podem ser dados de pessoa física. Não use a lista para disparo em massa nem para spam: faça contato individual, diga quem você é e o motivo, e dê uma saída simples para a pessoa pedir que você não escreva de novo. Não publique a planilha nem prints com dados reais.
Proxy e patrocínios. O proxy é opcional, e a skill oferece três patrocinadores com links de indicação (referral). Eles são escolhidos pelo projeto, e esta página não recomenda nenhum. Nunca cole credenciais de proxy no chat: a skill usa um prompt mascarado no terminal. A skill também se atualiza sozinha: no início de cada fluxo ela roda um script que atualiza a própria skill e a imagem Docker.
Não testado neste tutorial: a instalação da skill, a busca em português (dentistas em São Paulo), o tempo e a contagem de linhas, a remoção de duplicadas pelo Claude e o Docker no Mac. O README avisa que o comando do Docker da interface web pode não funcionar no macOS e aponta instruções próprias. Os comandos vêm do README e do SKILL.md lidos em 20/10/2026.
Pré-requisitos
- Claude Code instalado e logado (documentação: https://code.claude.com/docs)
- Docker Desktop instalado e aberto (em execução) e Node.js, que fornece o npx. O SKILL.md aceita macOS, Linux e Windows via WSL
- Espaço em disco e conexão para baixar a imagem do Docker na primeira vez
- Opcional: um proxy pago, para buscas grandes
- Custo: o scraper é grátis (MIT). O uso do Claude segue o seu plano, e o proxy, se você escolher um, é pago à parte
Conceitos-chave
- 01
Skill × scraper
A skill é um roteiro para o Claude: entende o pedido, monta as buscas, valida e acompanha. O scraper é o programa que de fato coleta os dados.
- 02
Docker
O scraper roda dentro de um contêiner na sua máquina. Por isso o Docker precisa estar aberto antes de começar.
- 03
O que vem ligado e desligado
O padrão da skill é CSV, sem e-mail, sem avaliações extras e com profundidade rasa. E-mail e mais cobertura só entram se você pedir.
- 04
Proxy
Um intermediário de rede, opcional. O README diz que concorrência alta aumenta bloqueios, sobretudo sem proxy, e a skill manda começar com profundidade e concorrência conservadoras.
Esta página é diferente do tutorial Lista de Clientes com Claude in Chrome + Google Maps (/open-source/integracoes/lista-infinita-de-clientes-com-claude-e-maps). Aquele usa a extensão do navegador, sem instalar nada. Este usa o scraper open source com Docker, que roda na sua máquina e gera um CSV.
Passo a passo
- 01
Abra o Docker e confira os pré-requisitos
Abra o Docker Desktop e espere ele ficar em execução. Depois confira as versões.
docker --version node --version - 02
Instale a skill (README)
O comando do README instala a skill do repositório no Claude Code.
npx skills add gosom/google-maps-scraper - 03
Peça a busca em linguagem simples
Abra o Claude Code numa pasta de trabalho e use o primeiro prompt abaixo. O exemplo do README, em inglês, é: Find dentists in Berlin and include their websites and email addresses. A versão em português não foi testada.
- 04
Escolha o proxy
A skill pergunta se você tem um proxy, quer ver patrocinadores ou continua sem. Para o primeiro teste, continue sem proxy.
- 05
Aguarde a validação e a busca completa
A skill roda primeiro uma busca de validação pequena e só depois a completa, informando o estado do contêiner e a contagem de resultados. Não conte com um tempo exato.
- 06
Confira o resultado
A skill conta o total e mostra até 20 linhas de prévia, com nome, categoria, avaliação, telefone, site e endereço. Abra o CSV e confira a contagem antes de usar.
- 07
Peça e-mail só se precisar
O e-mail vem desligado porque o scraper visita o site de cada negócio e isso demora bem mais. Peça no prompt (segundo prompt abaixo) e aceite o tempo extra.
- 08
Limpe e filtre com cuidado
O scraper não remove duplicadas. Peça ao Claude para tratar o CSV em um arquivo novo (terceiro e quarto prompts) e revise antes de usar.
- 09
Alternativa: a interface web
Se preferir uma tela, o README traz um comando do Docker que abre a interface em http://localhost:8080. O README avisa que os resultados levam no mínimo 3 minutos e que no macOS esse comando pode não funcionar.
mkdir -p gmapsdata docker run \ -v "$PWD/gmapsdata:/gmapsdata" \ -p 8080:8080 \ gosom/google-maps-scraper \ -data-folder /gmapsdata
Prompts prontos
Troque [TIPO DE NEGÓCIO] pelo ramo (ex.: dentistas), [CIDADE] pela cidade, [ARQUIVO.CSV] pelo CSV que a skill gerou, [NOTA MÍNIMA] pela nota de avaliação mínima e [SEU SERVIÇO] pelo que você oferece. O primeiro prompt é o do reel. Todos trabalham em arquivo novo e nenhum envia mensagem.
Prompt: pedir a lista de negócios (o do reel)
Encontre [TIPO DE NEGÓCIO] em [CIDADE]. Comece com uma amostra pequena e me mostre a contagem de linhas e as 20 primeiras antes de ampliar a busca.
Prompt: incluir e-mail dos negócios
Encontre [TIPO DE NEGÓCIO] em [CIDADE] e inclua o e-mail de cada negócio quando o site tiver. Avise o quanto isso aumenta o tempo e espere meu ok antes de começar.
Prompt: remover duplicadas
Abra [ARQUIVO.CSV] e remova as linhas duplicadas por nome e telefone. Salve em um arquivo novo, sem sobrescrever o original, e me diga quantas linhas saíram.
Prompt: filtrar e ordenar
No arquivo [ARQUIVO.CSV], mantenha só os negócios que têm site e nota acima de [NOTA MÍNIMA] e ordene pela quantidade de avaliações. Salve em um arquivo novo e mostre as 10 primeiras linhas.
Prompt: revisar dados de pessoa física antes do contato
Revise [ARQUIVO.CSV] e marque as linhas que parecem ser pessoa física: nome de pessoa no título, telefone celular ou e-mail pessoal. Sugira o que remover antes de qualquer contato. Não envie nada e não altere o arquivo original.
Prompt: mensagem de primeiro contato individual
Escreva uma mensagem curta de primeiro contato para [TIPO DE NEGÓCIO] sobre [SEU SERVIÇO], com quem escreve, o motivo do contato e uma forma simples de a pessoa pedir para não receber mais mensagens. É para envio individual e manual, sem disparo em massa. Não envie nada.
Erros comuns
- Cannot connect to the Docker daemon → o Docker Desktop não está aberto → abra o Docker, espere ficar em execução e peça de novo
- npx: command not found → o Node.js não está instalado → instale o Node.js e repita o npx skills add
- O comando da interface web não funciona no Mac → o README avisa que o comando do Docker pode falhar no macOS → siga as instruções para macOS do repositório ou use a skill
- A lista veio com poucos negócios → busca rasa ou termo estreito → peça uma busca mais ampla ou por regiões da cidade, em vez de repetir a mesma
- A coluna de e-mail veio vazia → o e-mail vem desligado por padrão ou o site não mostra e-mail → peça e-mail no prompt e aceite que nem todo negócio terá
- Linhas repetidas no CSV → o scraper não remove duplicadas → use o prompt de duplicadas e confira o resultado
- A busca parou ou foi bloqueada → concorrência alta sem proxy → comece pequeno, reduza o volume e, se precisar, considere um proxy
- Nada aparece na interface web nos primeiros minutos → o README diz que os resultados levam no mínimo 3 minutos → espere antes de reiniciar
Checklist final
- Li os termos do Google Maps e vou usar em escala pequena
- O Docker Desktop estava aberto e node --version respondeu
- A skill foi instalada com npx skills add gosom/google-maps-scraper
- Conferi a contagem de linhas e as primeiras 20 do CSV
- Tratei duplicadas e filtros em arquivo novo, sem sobrescrever o original
- Revisei dados de pessoa física e só farei contato individual, com saída para a pessoa
- Não publiquei a planilha nem prints com dados reais
Perguntas frequentes
O scraper tira as duplicadas sozinho?
Não. O README só cita remoção de duplicadas no LeadsDB, uma ferramenta companheira e à parte. Aqui a limpeza é feita pelo Claude, em arquivo novo, e precisa de conferência.
Ele puxa Instagram, Facebook e LinkedIn dos negócios?
Não. O README não lista campo de rede social. Esta página não promete isso.
Em quanto tempo sai a lista?
Depende da busca. O README indica que na interface web os resultados levam no mínimo cerca de 3 minutos, e a extração de e-mail aumenta bastante o tempo.
Custa zero?
O scraper é grátis e MIT. Você ainda usa Docker, o seu plano do Claude e, se quiser, um proxy pago.
Posso usar a lista para disparo em massa?
Não é o uso indicado. Os termos do Google restringem bases de negócios e downloads em massa, e a LGPD protege dados de pessoa física. Use para pesquisa e contato individual.
Fontes oficiais
- README do Google Maps Scrapergithub.com/gosom/google-maps-scraper (abre em nova aba)
- SKILL.md da skillgithub.com/gosom/google-maps-scraper/blob/main/skills/google-maps-scraper/SKILL.md (abre em nova aba)
- Termos adicionais do Google Mapsmaps.google.com/help/terms_maps (abre em nova aba)
- Licença MIT do repositóriogithub.com/gosom/google-maps-scraper/blob/main/LICENSE (abre em nova aba)
- Documentação do Claude Codecode.claude.com/docs (abre em nova aba)
Próximos passos
Comece agora
Pronto para colocar Google Maps Scraper no Claude Code: Lista de Negócios Locais para rodar?
Ver o Google Maps Scraper no GitHubPróximo passo
Veja os outros recursos do catálogo
Dezenas de recursos entre squads, skills, apps e integrações — todos usados em produção pelo João.
Voltar ao catálogo