Skip to content

RodrigoInfante48/MQLs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MQLs — De Google Maps a un CSV de prospectos en minutos

200 prospectos con teléfono, dirección y web.
Costo: $0. Herramientas de pago: ninguna. Solo Python.


El problema que esto resuelve

Cada freelancer, agencia y emprendedor digital llega al mismo punto muerto: necesita clientes, pero buscarlos uno por uno no escala.

Lo que casi nadie sabe: Google Maps tiene millones de negocios locales registrados, cada uno con nombre, teléfono, dirección y sitio web — datos públicos, gratuitos y actualizados.

Este sistema los extrae y los deja en un CSV limpio, listo para usar como quieras.


Arquitectura

[Google Maps]
      ↓  Playwright — automatiza el browser, navega y extrae
[CSV por ciudad]  × N ciudades
      ↓  consolidar_leads.py — fusiona y elimina duplicados
[CSV limpio y único — listo para usar]

Stack

Herramienta Rol Costo
Python 3.x Motor de ejecución Gratis
Playwright Automatización del browser Gratis
Google Maps Fuente de leads Gratis
pandas Consolidación y deduplicación Gratis

Inicio rápido

# 1. Instalar dependencias
pip install playwright pandas
python -m playwright install chromium

# 2a. Extraer leads — una ciudad
python gmaps_scraper.py --query "odontólogo Bogotá Colombia" --output leads_bogota.csv

# 2b. O extraer por país completo (multi-ciudad automático)
python python_leads.py co ./leads_output/
python python_leads.py mx ./leads_output/
python python_leads.py de ./leads_output/

# 3. Consolidar y eliminar duplicados
python consolidar_leads.py --folder ./leads_output/
# → genera leads_consolidado.csv

Países disponibles: co mx ar cl es pe ve ec bo py uy us de


Estructura del repositorio

MQLs/
├── gmaps_scraper.py      # Scraper de una búsqueda / ciudad
├── python_leads.py       # Scraper multi-ciudad por código de país
├── consolidar_leads.py   # Fusiona CSVs y elimina duplicados
├── claude.md             # Guía completa: parámetros, ejemplos y buenas prácticas
└── README.md

Para la guía completa → claude.md


Casos de uso

Funciona para cualquier nicho B2B local: odontólogos, veterinarias, gimnasios, restaurantes, profesionales independientes — en cualquier ciudad, en cualquier idioma.


Licencia

MIT — libre para usar, modificar y distribuir.


Autor: Rodrigo Infante — Daily Duty Institute

Si este repo te fue útil, dale una ⭐ y compártelo.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages