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

  1. cli
  2. query builder (ibge)
  3. maps scraper
  4. enrichment
  5. csv · xlsx
cli → query builder (ibge)cli → maps scrapermaps scraper → enrichmentenrichment → 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.