AtlasLeads
Scraper ligero con Playwright que extrae listados de empresas de Google Maps, enriquece los contactos visitando los sitios web y exporta a CSV y Excel. Proyecto educativo.
Educativo · respeta los Términos de ServicioAutomatización · scraping2026
- Contexto y objetivo
- Recolección de nombre, dirección, sitio web, teléfono, categoría, reseñas y coordenadas a partir de términos de búsqueda, con generación automática de términos por ciudad mediante la API del IBGE.
- Problema
- Armar listas de empresas por nicho y región de forma reproducible, en paralelo y sin repetir búsquedas ya hechas.
- Tecnologías
- pythonplaywrightpytestdockeribge api
01 / Arquitectura
Arquitectura utilizada
- cli
- query builder (ibge)
- maps scraper
- enrichment
- csv · xlsx
CLI
Orquesta tres flujos: scrape, locations y queries.
Scraper
Google Maps con Playwright, con manejo automático del diálogo de consentimiento.
Enriquecimiento
Visita el sitio web de cada empresa y extrae correos y teléfonos adicionales.
IBGE
Estados, municipios y población; combina ciudades × palabras clave en términos de búsqueda.
02 / Decisiones
Decisiones técnicas
Y el trade-off detrás de cada una.
- Cada búsqueda corre en su propio proceso (ProcessPoolExecutor) con su propia instancia de Chromium.
- Las subpáginas del enriquecimiento se obtienen en paralelo con ThreadPoolExecutor.
- Modo --enrich-only para reprocesar CSV sin repetir la búsqueda.
- Salida organizada por fecha de ejecución.
03 / Desafíos
Desafíos enfrentados
Por completar
¿Cuáles fueron los problemas difíciles? ¿Qué no funcionó en el primer intento?
04 / Resultados
Resultados obtenidos
Por completar
Resultados medidos (tiempo, costo, usuarios, aprendizajes). Prefiere números.