maps-to-lead

📍 Maps to Lead

API open source de prospecção de leads a partir do Google Maps: extrai nome, telefone, WhatsApp, site e endereço estruturado por palavra-chave e dispara os resultados em um webhook. Não apoiamos nem incentivamos a prática de SPAM — utilize com sabedoria.

A resposta é instantânea: POST /api/find inicia a busca e retorna na hora com o jobId. A extração roda em segundo plano — rola o feed inteiro, extrai cada lugar num pool paralelo, (opcional) enriquece pelo site do lead e dispara os webhooks na ordem original.

Rodando

docker run -d --name maps-to-lead -p 9000:9000 \
  -e MANAGER_TOKEN=seu-token \
  -v maps-to-lead-data:/app/data \
  --init --shm-size=1g \
  ghcr.io/jhowbhz/maps-to-lead:latest

Com docker compose (a partir do fonte)

cp .env_example .env          # defina MANAGER_TOKEN
docker compose up -d --build

API

POST /api/find

Traz tudo que encontrar na região (sem limite de quantidade) e responde na hora com o jobId — a extração roda em segundo plano. Acompanhe em /manager.

O body é estruturado em três objetos:

campo tipo obrigatório descrição
query.type string ✅ ramo/palavra-chave (ex.: software, restaurante, mecânica)
query.city string ❌ cidade/bairro
query.state string ❌ estado
webhook.url string ✅ URL que receberá os leads (um POST por lead)
webhook.retry boolean ❌ false = sem retentativas. Padrão true
webhook.timeout number ❌ timeout por POST, em ms (1000–120000)
options.onlyWithPhone boolean ❌ ignora lugares sem telefone (padrão false)
options.onlyRepeat boolean ❌ false = não envia telefones repetidos (dedupe). Padrão true
options.onlyInfosExtras boolean ❌ true = visita o site do lead (pool paralelo) e extrai email/redes. Padrão false

A busca do Maps é montada de type, city, state (ex.: "software, centro, rio de janeiro").

curl --location --request POST 'http://127.0.0.1:9000/api/find' \
--header 'Content-Type: application/json' \
--data-raw '{
    "query":   { "type": "software", "city": "centro", "state": "rio de janeiro" },
    "webhook": { "url": "https://webhook.site/<seu-id>", "retry": false, "timeout": 6000 },
    "options": { "onlyWithPhone": true, "onlyRepeat": false, "onlyInfosExtras": true }
}'

Resposta 200 (instantânea — a busca roda em background; sem contagem no retorno):

{
  "error": false,
  "message": "A busca foi iniciada. Você receberá os resultados no seu webhook em até 5 minutos.",
  "jobId": "job_1737500000000_1",
  "query": { "type": "software", "city": "centro", "state": "rio de janeiro" },
  "options": { "onlyWithPhone": true, "onlyRepeat": false },
  "webhook": "https://webhook.site/<seu-id>"
}

Payload enviado ao webhook (um por lead):

{
  "lead": {
    "name": "Group Software",
    "pic": "https://ssl.gstatic.com/local/servicebusiness/default_user.png",
    "rating": { "note": "4.6", "quantity": 403 },
    "address": {
      "street": "R. Santa Catarina",
      "number": "1631",
      "neighborhood": "Lourdes",
      "city": "Belo Horizonte",
      "uf": "MG",
      "cep": "30170-081",
      "full": "R. Santa Catarina, 1631 - Lourdes, Belo Horizonte - MG, 30170-081"
    },
    "contacts": {
      "phone": "+558007025700",
      "whatsapp": "",
      "ddd": "",
      "email": ""
    },
    "social": {
      "instagram": "https://www.instagram.com/groupsoftware/",
      "facebook": "https://www.facebook.com/groupsoftware",
      "site": "https://www.groupsoftware.com.br/"
    },
    "extra": {
      "site_visitado": true,
      "campos_encontrados": ["instagram", "facebook"],
      "email": "",
      "instagram": "https://www.instagram.com/groupsoftware/",
      "facebook": "https://www.facebook.com/groupsoftware"
    }
  }
}

Screen

image

Licença

MIT.