🏢 Google Places Leads — Directorio de Negocios de Cúcuta

Extrae leads B2B verificados de cualquier ciudad de Colombia combinando OpenStreetMap + Google Places. Obtén teléfonos reales, emails validados, ratings, horarios y un sistema de puntuación automática que prioriza los mejores prospectos.

Ideal para: agencias de marketing digital, equipos de ventas B2B, consultores de expansión comercial y analistas de mercado.

---

✨ ¿Por qué este Actor?

La mayoría de scrapers de directorios devuelven datos incompletos: nombres sin teléfono, direcciones sin coordenadas, listados desactualizados. Este Actor resuelve ese problema con verificación cruzada multi-fuente:

• OpenStreetMap (Overpass) → Descubrimiento masivo de negocios por ubicación y categoría
• Nominatim Reverse → Dirección completa (calle, barrio, ciudad) desde coordenadas
• Google Places API → Verificación oficial con teléfono, sitio web, rating y reseñas reales
• Crawling de sitios web → Extracción de emails y redes sociales desde la web del negocio
• Verificación MX → Confirmación de que los emails pueden recibir correos
• LeadScore (0-100) → Puntuación automática que clasifica cada negocio por calidad

---

📊 Resultados reales

Ejecución de prueba en Cúcuta, Colombia (restaurantes, 50 negocios):

Métrica	Resultado
Negocios extraídos de OpenStreetMap	436
Verificados en Google Places	33 / 50 (66%)
Direcciones completas	50 / 50 (100%)
Teléfonos reales	26 / 50 (52%)
Emails validados con MX	2 / 50
Leads calientes (score ≥ 75)	3
Leads tibios (score 55-74)	20

---

🎯 Casos de uso

1. Agencia de marketing digital buscando clientes locales

Ejecuta el Actor con category: "restaurant" en tu ciudad y obtén una lista de 500 restaurantes con teléfono, rating y web. Prioriza los que tienen rating bajo (< 4.0) pero muchas reseñas (> 100) — son negocios activos que necesitan mejorar su reputación online.

2. Distribuidor farmacéutico expandiendo territorio

Ejecuta con category: "pharmacy" en varias ciudades y compara el número de farmacias por zona. Usa los datos de dirección para planificar rutas de visita comercial.

3. Consultor de expansión inmobiliaria

Ejecuta con category: "supermarket" y category: "bank" para identificar zonas con alta densidad comercial. Cruza los datos con precios de arriendo locales para detectar oportunidades.

4. Analista de mercado por sector

Ejecuta múltiples categorías (dentist, gym, cafe) en la misma ciudad y genera un mapa de competencia por barrio.

---

📥 Input

Campo	Tipo	Descripción	Default
searchMode	string	"city" (por ciudad) o "coords" (por coordenadas)	"city"
city	string	Nombre de la ciudad (formato "Ciudad, País")	"Cúcuta, Colombia"
category	string	Tipo de negocio (48 categorías disponibles)	"restaurant"
maxResults	integer	Número máximo de resultados a extraer	200
googleApiKey	string	Tu API key de Google Places (obligatoria para enriquecimiento con Google)	—
enrichAddress	boolean	Completar direcciones con Nominatim	true
enrichGooglePlaces	boolean	Verificar en Google Places	true
enrichWebsite	boolean	Visitar sitios web para extraer emails	true
onlyWithContact	boolean	Filtrar solo negocios con teléfono/email/web	false

Categorías disponibles (48)

Comida: restaurant, cafe, bar, fast_food, pub
Salud: pharmacy, hospital, clinic, dentist, doctors, veterinary
Finanzas: bank, atm, insurance, accountant, notary
Comercio: supermarket, convenience, bakery, butcher, optician
Servicios: hairdresser, beauty, car_repair, car_wash, fuel, laundry
Profesionales: lawyer, estate_agent, travel_agency, photographer, it_office
Oficios: electrician, plumber, carpenter, painter, roofer, locksmith

---

📤 Output — Ejemplo real

{
  "name": "Restaurante El Lago",
  "category": "restaurant",
  "phone": "+57 350 6321235",
  "phoneMobile": true,
  "email": "contacto@ellago.com.co",
  "emailMx": true,
  "website": "https://ellago.com.co",
  "address": "Urbanización La Primera, Calle 8N 18e-35, Cúcuta, Norte de Santander",
  "latitude": 7.8939,
  "longitude": -72.5078,
  "rating": 4.3,
  "userRatingCount": 778,
  "googleBusinessStatus": "Operativo",
  "openingHoursGoogle": ["lunes: 11:00–22:00", "..."],
  "leadScore": 88,
  "oportunidad": "🔥 Caliente - Contactar ya",
  "dataQuality": "completo",
  "recommendedAction": "🔥 Contactar HOY: lead caliente con datos completos",
  "facebook": "https://facebook.com/restauranteellago",
  "scrapedAt": "2026-09-18T19:25:00.000Z"
}