https://github.com/eduardoopv/google-maps-leads
Automatiza a busca de empresas no Google Maps, filtrando e salvando resultados em arquivos CSV
https://github.com/eduardoopv/google-maps-leads
csv nodejs
Last synced: 9 months ago
JSON representation
Automatiza a busca de empresas no Google Maps, filtrando e salvando resultados em arquivos CSV
- Host: GitHub
- URL: https://github.com/eduardoopv/google-maps-leads
- Owner: EduardooPV
- Created: 2025-05-31T16:55:44.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2025-06-05T01:16:17.000Z (10 months ago)
- Last Synced: 2025-06-08T16:37:33.660Z (10 months ago)
- Topics: csv, nodejs
- Language: JavaScript
- Homepage:
- Size: 21.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Google Maps Leads
Este projeto automatiza a busca de empresas no Google Maps, filtrando e salvando resultados em arquivos CSV separados por empresas com site, sem site e com WhatsApp. Ideal para geração de leads segmentados por cidade e palavra-chave.
## Como funciona
- Realiza buscas no Google Maps Places API por empresas de um segmento (ex: "clínica estética") em uma cidade.
- Para cada empresa encontrada, busca detalhes (telefone, site, avaliação).
- O `queue` é configurado para permitir no máximo 50 requisições por minuto (intervalCap: 50, interval: 60000), respeitando o limite gratuito da API.
- Ao buscar tem um delay automático de 2 segundos para ativar o `next_page_token`, conforme exigido pela documentação do Google.
- Classifica empresas em quatro grupos: com site, sem site, com WhatsApp e com Instagram.
- Salva os resultados em arquivos CSV na pasta `planilhas//`.
- Salva também as coordenadas e parâmetros de busca em `coordenadas.json`.
## Preview
## Como rodar
1. **Instale as dependências:**
```sh
npm install
```
2. **Configure a chave da API:**
Crie um arquivo `.env` na raiz com:
```
GOOGLE_API_KEY=SEU_TOKEN_AQUI
```
3. **Execute o script:**
```sh
npm start
# Exemplo:
npm start sao-paulo
```
Os arquivos CSV serão gerados em `planilhas//`.
## Onde alterar variáveis de busca
**Palavra-chave, localização e raio:**
Edite o arquivo `search-config.js`:
- location: latitude e longitude central da busca
- radius: raio da busca em metros
- keyword: segmento/termo pesquisado
- useMock: defina como false para usar a API real (requer chave no .env)
## Parâmetros e arquivos gerados
- Parâmetro obrigatório: nome da cidade (ex: `sao-paulo`).
- Gera os arquivos:
- `com-site.csv` — empresas com site
- `sem-site.csv` — empresas sem site
- `com-whatsapp.csv` — empresas com link WhatsApp
- `com-instagram.csv` — empresas com link Instagram
- `coordenadas.json` — histórico dos parâmetros de busca
- `log_erros.json` — erros ocorridos na execução
## Observações
- O script respeita limites de requisição da API do Google.
- Para outros segmentos, altere a variável `keyword`.
- Para rodar em produção, lembre-se de definir `USE_MOCK = false`.