EXTRAIR LEADS DO GOOGLE MAPS - COMO USAR
=========================================

JEITO FACIL (recomendado)
  1. Dois cliques em "Extrair-Leads.bat"
  2. Responda: o que buscar (ex.: barbearia) e a cidade (ex.: Ourinhos, SP)
  3. Escolha o tamanho da busca e o filtro
  4. No fim, a pasta "leads" abre sozinha com dois arquivos:
       "Barbearia - Ourinhos SP - 2026-11-03 (Excel).csv"  -> abra este no Excel
       "Barbearia - Ourinhos SP - 2026-11-03.csv"          -> original, para Google Sheets / CRM

  Precisa ter: Python 3.9+ (python.org, marcar "Add python.exe to PATH")
               e Google Chrome ou Microsoft Edge (o Edge ja vem no Windows).

O QUE VEM EM CADA LEAD
  Nome, Telefone, Tipo de telefone (Celular/Fixo), WhatsApp (link wa.me pronto para celulares),
  E-mail (lido do site da empresa), Site, Tem site?, Categoria, Endereco, Nota, Avaliacoes,
  Instagram, Facebook, LinkedIn, TikTok, YouTube, X.
  Com "detectar quem ja anuncia": Ja anuncia?, Pixel Meta, Tag Google Ads, Google Analytics,
  Plataforma do site (WordPress, Wix...), Site mobile e Score de intencao (0-100).
  A lista vem ordenada pelo score: os primeiros sao os que ja investem em marketing.

COMANDOS (PowerShell, dentro da pasta google-maps-scraper-kit)
  Ligar o motor ............ py scripts\engine.py start
  Ver se esta ligado ....... py scripts\engine.py status
  Desligar ................. py scripts\engine.py stop
  Painel web (formulario) .. http://localhost:8080 (com o motor ligado)

  Exemplos de busca:
  py scripts\scrape.py "barbearia em Ourinhos, SP" --city "Ourinhos, Sao Paulo, Brasil" --lang pt --country br --depth 5 --tech
  py scripts\scrape.py "hamburgueria em Cornelio Procopio, PR" --city "Cornelio Procopio, Parana, Brasil" --lang pt --country br --grid 3
  py scripts\scrape.py "clinica de estetica em Ourinhos, SP" --city "Ourinhos, Sao Paulo, Brasil" --lang pt --country br --no-website
  py scripts\scrape.py "loja de roupas em Londrina, PR" --city "Londrina, Parana, Brasil" --lang pt --country br --grid 3 --exclude "..\leads\lista-antiga.csv"

  Opcoes uteis:
    --depth 5        ~100 empresas (cada ponto = ~20)
    --grid 3         cidade inteira (9 partes do mapa)
    --deep-scan      tudo, inclusive bairros cheios (lento)
    --tech           detecta Pixel Meta / Google Ads e ordena pelos mais quentes
    --no-website     so empresas SEM site
    --has-phone      so com telefone
    --min-rating 4.0 so nota 4,0 ou mais
    --exclude X.csv  pula empresas que ja estao numa lista anterior (re-rodar e pegar so as novas)
    --out "..\leads\nome.csv"   onde salvar

  Converter um CSV do kit para o Excel brasileiro (separador ; e colunas em portugues):
  py ferramentas\extrair_leads.py --excel "leads\arquivo.csv"

CUIDADOS
  - Uma busca por vez. Buscas grandes seguidas podem fazer o Google pausar seu IP por algumas horas
    (sua conta Google nao e afetada). Se acontecer, espere e rode de novo com "so empresas novas".
  - Telefones e e-mails sao dados pessoais (LGPD): use para prospeccao com finalidade clara,
    diga quem voce e no primeiro contato e ofereca opcao de nao receber mais mensagens.

ATUALIZAR O KIT (quando sair versao nova)
  cd google-maps-scraper-kit
  git pull
  py scripts\engine.py restart
