leads-cli

MVP de prospecção de leads via Google Places API.

Busca estabelecimentos no Google Maps por bairro e tipo de negócio, filtra os que não possuem site próprio e exporta os resultados em CSV — prontos para abordagem comercial.

---

Como funciona

1. Faz uma busca na Places API (New) do Google com a query definida no .env
2. Busca até 3 páginas (60 resultados)
3. Separa os leads sem site dos demais
4. Exporta dois arquivos CSV: todos os resultados e só os leads sem site
5. Exibe um resumo no terminal com os top leads

---

Instalação

git clone https://github.com/jircik/leads-script
cd leads-script
npm install
cp ..env.example .env

Edite o .env com sua chave da API e a query desejada.

---

Configuração

GOOGLE_PLACES_KEY=sua_chave_aqui
QUERY=barbearia Pinheiros São Paulo

Obtendo a API Key

1. Acesse Google Cloud Console
2. Crie um projeto
3. Ative a Places API (New) em APIs & Services → Library
4. Gere uma API Key em APIs & Services → Credentials

---

Uso

node leads.js

Exemplos de query

QUERY=barbearia Pinheiros São Paulo
QUERY=salão de beleza Moema São Paulo
QUERY=restaurante Vila Madalena São Paulo
QUERY=clínica odontológica Itaim Bibi São Paulo
QUERY=academia de ginástica Perdizes São Paulo

Output no terminal

🔍  Buscando: "barbearia Pinheiros São Paulo"

  Buscando página 1... 20 resultados
  Buscando página 2... 20 resultados

─────────────────────────────
📊  Total encontrado:  40
🌐  Com site:         25
🎯  Sem site (leads): 15  ← foco da Vettra
⭐  Avaliação média:  4.4
─────────────────────────────

🔥  Top leads sem site:
   • Barbearia The Captain's — (11) 97690-0924 — 151 avaliações
   • Barbearia Valentins — (11) 95459-2011 — 100 avaliações
   • Barbearia Studio Luiz — (11) 95994-1795 — 60 avaliações

💾  leads_todos.csv  (40 registros)
💾  leads_sem_site.csv  (15 registros)

Arquivos gerados

Arquivo	Conteúdo
leads_todos.csv	Todos os resultados da busca
leads_sem_site.csv	Apenas leads sem site — foco da prospecção

Campos exportados: nome, tipo, endereço, telefone, site, avaliação, qtd_avaliações, status, google_maps.

---

Observações

• A ausência de websiteUri na Places API não garante 100% que o negócio não tem site — recomenda-se verificação manual antes da abordagem
• Estabelecimentos com site no Instagram/Facebook são leads morenos — têm presença digital mas não site próprio
• Os arquivos CSV são ignorados pelo .gitignore para não vazar dados de prospecção

---

Roadmap

Este repositório é o MVP de um projeto maior, construído em fases.

Fase 1 — CLI (atual)

• Script de busca via Google Places API

• Filtro de leads sem site

• Exportação CSV

• Criar uma CLI completa, não só um script

• Publicar no npm (npm install -g leads-cli)

• Comando estruturado (leads search "barbearia Moema")

• Filtro automático de qualificação (Instagram/Facebook = lead morno)

• Verificação secundária automática de site

  Fase 2 — API + CRM

• Backend Express + PostgreSQL para persistir os leads

• Endpoints REST (buscar, salvar, atualizar status)

• CRM web em Next.js para gerenciar o pipeline de prospecção

• CLI passa a consumir a API ao invés de rodar standalone

---

Stack

• Node.js (ESM)
• Google Places API (New)
• dotenv

---