comunidad bóvedascrapling-clientes-gratis

Scrapling — Leads Gratis Para Tu Negocio

Librería open source con MCP integrado que extrae información de Google Maps, directorios y redes sociales — Claude la instala y la usa por ti con simples prompts. Arma tus propias listas de clientes sin pagar a agencias de leads.

Proyecto open source de la comunidad

Licencia BSD-3 · gratis incluso para uso comercial · MCP integrado para Claude.

37,500+ estrellas — dale una al repo para apoyar a @D4Vinci.

Ver en GitHub

01 contexto

¿Qué es Scrapling?

Imagínate que internet es un supermercado gigante y tú quieres una lista de todos los yogures: nombre, precio, marca y dónde están. Scrapling es tu robot que va pasillo por pasillo, anota cada yogur y te arma la lista en Excel. La magia: las tiendas no se dan cuenta que fue un robot.

Técnicamente, Scrapling es una librería open source de Python que saca información de cualquier página web — Google Maps, directorios, redes sociales, tiendas online — sin que te bloqueen. Se camufla como un navegador humano real. Tiene 37,500+ estrellas en GitHub y está bajo licencia BSD-3 (100% gratis, hasta para uso comercial).

Lo más loco: viene con un servidor MCP integrado. Eso significa que Claude puede controlarla directamente. Tú le dices a Claude lo que quieres en español, y él usa Scrapling por ti. No tienes que programar nada.

Ejemplo real: Le dices a Claude "sácame todos los dentistas de mi ciudad con teléfono y dirección". Pum — te arma la lista. Las agencias de leads cobran miles de dólares por una lista así. Aquí es gratis.

Para quién es esto

Freelance / agencia

Vende diseño web, ads, SEO — necesitas una lista de prospectos que te escuche

Dueño de negocio local

Quieres clientes nuevos sin pagar Facebook Ads ni Google Ads

Vendedor B2B

Vives de contactar prospectos — este robot te multiplica por 10

02 requisitos

Qué necesitas antes de empezar

Son 4 cosas. Si ya tienes alguna, salta al siguiente punto. Los dos comandos de terminal de abajo son lo único que vas a teclear a mano en toda la guía — después, Claude hace todo por ti con prompts.

1. Claude Code o Claude Desktop

Necesitas uno de los dos. Claude Desktop es la app de escritorio que descargas en tu compu — ideal si nunca has usado terminal. Claude Code es el CLI oficial — más potente para este flujo porque ya trae herramientas para correr comandos e instalar cosas. Si vas a armar listas en serio, recomiendo Claude Code. Descarga cualquiera desde claude.ai/download.

2. Python 3.10 o superior

Python es el lenguaje que usa Scrapling por debajo. Para verificar si ya lo tienes, abre la terminal y escribe python3 --version. Si aparece algo como 3.10 o mayor, ya estás. Si no, dile a Claude en el paso 3 que te lo instale — él puede hacerlo.

3. uv (gestor de paquetes de Python)

uv es una herramienta ultra-rápida que instala librerías de Python. Scrapling funciona mejor con uv. Instalar tarda 10 segundos — copia y pega uno de estos:

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell)

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

4. Una cuenta activa de Anthropic

Obvio — el MCP de Scrapling corre dentro de Claude. Si ya estás en la comunidad, ya la tienes. Si no, crea una en claude.ai. Con el plan gratis ya puedes empezar; el Pro te aguanta listas grandes.

Tip: si nunca has tocado la terminal, no te preocupes — solo vas a pegar los dos comandos de arriba. Todo lo demás se hace con prompts en Claude.

03 instalación

Un solo prompt y Claude te instala todo

Aquí está el truco: no vas a instalar Scrapling a mano. Le pegas el prompt de abajo a Claude Code o Claude Desktop y él se encarga — descarga Scrapling, baja los navegadores camuflados, configura el servidor MCP y lo deja listo para ti.

Prompt maestro — instala Scrapling con MCP

Copia, pega, deja que Claude haga su magia. Si te pide permiso para correr comandos, dile que sí.

Quiero usar Scrapling para sacar listas de clientes. Es una librería de Python de D4Vinci con MCP integrado para Claude. Repo: https://github.com/D4Vinci/Scrapling

Por favor haz todo esto, paso por paso, reportando cada etapa:

1. Verifica que tengo Python 3.10+ y uv instalados. Si falta alguno, dime cómo instalarlo (o instálalo si tienes permisos).

2. Instala Scrapling con sus dependencias completas:
uv pip install "scrapling[all]"

3. Corre la instalación de navegadores que Scrapling necesita (Camoufox, Playwright, etc.):
scrapling install

4. Lee el README oficial de Scrapling para encontrar el comando exacto del servidor MCP (suele ser algo como "scrapling-mcp" o "scrapling mcp serve"). Verifica cuál es el correcto para la versión instalada.

5. Agrega Scrapling al archivo de configuración de Claude Desktop (claude_desktop_config.json) dentro de la sección "mcpServers". Si ya tengo otros MCPs configurados, NO los sobrescribas — solo agrega el de Scrapling. La ubicación del archivo:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

6. Prueba que la instalación funcione corriendo una extracción simple — por ejemplo, sacar los primeros 3 resultados de Google para "dentistas cdmx" y mostrármelos.

7. Dime qué hago ahora: reinicio Claude Desktop, abro una conversación nueva, y listo para usar el MCP.

Si algo falla en cualquier paso, explícame qué salió mal y cómo arreglarlo — no sigas al siguiente paso sin resolver.

Importante: después de que Claude termine el paso 5, tienes que cerrar Claude Desktop por completo y volver a abrirlo. Cerrar la ventana no basta — en macOS usa Cmd+Q, en Windows cierra desde la bandeja del sistema. Esto hace que Claude lea la nueva configuración y detecte el MCP de Scrapling.

¿Por qué usar un prompt en vez de comandos? Porque cada versión de Scrapling cambia detalles de instalación y el nombre del servidor MCP. Claude lee el repo oficial cuando lo ejecuta, así que siempre instala lo más reciente y lo configura bien. Tú no tienes que perseguir documentación.

04 conexión

Conectar y sacar tu primera lista

Claude ya te instaló Scrapling. Ahora hay que verificar que el MCP está vivo y sacar tu primera lista de clientes. 3 pasos, literal 5 minutos.

Reinicia Claude Desktop completamente

Ciérralo de verdad — no solo minimices. En macOS: Cmd+Q. En Windows: click derecho en el ícono de la bandeja del sistema > Salir. Luego vuélvelo a abrir.

Busca el ícono de herramientas MCP

Abre un chat nuevo en Claude Desktop. En la barra inferior del chat verás un ícono de herramientas (un martillo o un enchufe). Dale click — debes ver scrapling en la lista de MCPs conectados. Si aparece, estás listo. Si no, ve a la caja azul de abajo.

Pega tu primer prompt de leads

Este es el momento. Cambia [tu ciudad] por la tuya (ej. Tijuana, Guadalajara, Medellín) y mándalo:

Tu primera lista de 20 clientes

Cambia ciudad y profesión. Claude te entrega un CSV listo para Excel o Google Sheets.

Usa Scrapling para sacarme una lista de 20 dentistas en [tu ciudad].

Para cada uno quiero:
- Nombre del consultorio
- Teléfono
- Dirección completa
- Calificación en Google Maps (estrellas)
- Número de reseñas
- Sitio web (si tienen)

Cuando termines, exporta el resultado a un archivo CSV que pueda abrir en Excel o Google Sheets, y guárdalo en mi Desktop con el nombre "dentistas-lista-01.csv".

Si encuentras menos de 20, dime cuántos encontraste. Si Google Maps te bloquea, prueba con directorios alternativos como DoctoraLia o páginas amarillas.

Si el MCP no aparece en Claude:

Vuelve a cerrar Claude Desktop con Cmd+Q (o desde la bandeja del sistema en Windows) y reábrelo.
Pídele a Claude Code: "Lee mi claude_desktop_config.json y verifica que el MCP de Scrapling esté bien formado. Corrige cualquier error de JSON."
Confirma que uv responde desde la terminal escribiendo uv --version.

05 casos de uso

Qué puedes hacer con tu nueva fábrica de leads

Tres casos reales del video — cada uno es un servicio que agencias de leads cobran entre $500 y $5,000 USD. Aquí los replicas gratis con un prompt.

Caso 1 · Lista de nicho local

Todos los [profesión] de tu ciudad con teléfono y dirección

Ideal si vendes servicios B2B locales: diseño, marketing, seguros, proveedores, materiales. Una agencia de leads te cobra ~$500 por una lista así. Tú la sacas en 5 minutos.

Prompt — nicho local

Cambia profesión y ciudad. Funciona para cualquier negocio con presencia en Google Maps.

Usa Scrapling para armarme una lista de 50 [profesión — ej: veterinarias, contadores, abogados, mecánicos] en [ciudad].

Para cada uno quiero: nombre, teléfono, dirección, calificación en Google Maps, número de reseñas, sitio web (si tienen) y link directo a la ficha de Google Maps.

Limpia duplicados (dos registros del mismo negocio). Filtra los que tengan menos de 3 reseñas porque suelen ser falsos.

Entrega un CSV ordenado de mayor a menor por número de reseñas (los más activos primero), guardado en mi Desktop como "leads-[profesión]-[ciudad].csv".

Caso 2 · Negocios sin presencia online

Restaurantes que no tienen página web — para ofrecerles una

Si vendes diseño web, desarrollo, o ads, este es tu oro puro. Le dices a Claude que filtre solo los que no tienen sitio — esos son prospectos calificados que literalmente no existen en internet.

Prompt — negocios sin web

Lista filtrada de prospectos que necesitan exactamente lo que vendes.

Usa Scrapling para sacarme una lista de 100 restaurantes en [ciudad o zona específica] de Google Maps.

Para cada uno verifica si tienen sitio web propio (no cuenta un link a Facebook, Instagram, ni TripAdvisor — solo dominio propio).

Quédate SOLO con los que NO tienen sitio web. Para esos quiero: nombre del restaurante, teléfono, dirección, horario, calificación, número de reseñas y link a Google Maps.

Ordénalos de mayor a menor por número de reseñas — los más populares sin web son los que más rápido cierran.

Exporta a CSV en mi Desktop como "restaurantes-sin-web-[ciudad].csv" y dime cuántos encontraste del total.

Caso 3 · Monitoreo de competencia

Precios de tus competidores cada semana, automático

Servicios de "price intelligence" cobran $500–2,000 USD al mes. Con Scrapling y Claude lo haces tú — y puedes cobrárselo a tus clientes como un extra.

Prompt — monitoreo de competencia

Diseñado para que Claude lo corra manualmente o lo agende semanalmente con un agente.

Usa Scrapling para extraer los precios actuales de estos productos de mi competencia:

[Pega aquí las URLs de tu competencia, una por línea]

Para cada producto quiero: nombre, precio actual, descuento si hay, stock, URL y fecha de extracción. Compáralos con mis precios en este archivo: [opcional: ruta a tu catálogo, ej. ~/Desktop/mis-precios.csv].

Dime qué productos tengo más caros que la competencia (ahí pierdo ventas) y cuáles tengo demasiado baratos (ahí dejo dinero en la mesa). Prioriza los productos con mayor diferencia.

Guarda el resultado como "competencia-[YYYY-MM-DD].csv" en mi Desktop. Si quiero que esto corra cada semana automáticamente, dime cómo agendarlo con un Skill de Claude o una tarea programada.

Traducción a dinero para la comunidad

Cada uno de estos casos es un servicio que puedes vender tú. Ejemplo real: cobrar $200 USD por armar una lista de 100 restaurantes sin web en la ciudad de un cliente. Si haces 2 listas a la semana, son $1,600 USD al mes — de una herramienta que costó $0.

06 prompts

Prompts listos para copiar

Cinco prompts más para exprimir Scrapling. Copia, ajusta los corchetes [así] con tus datos y mándalos a Claude.

Lista limpia y deduplicada

Para cuando ya tienes una lista sucia y quieres una versión usable.

Toma este CSV: [ruta al CSV, ej. ~/Desktop/leads-crudos.csv] y:

1. Elimina duplicados (mismo teléfono o misma dirección = mismo negocio).
2. Normaliza los teléfonos a formato +52 XX XXXX XXXX (o el formato de [país]).
3. Quita registros sin teléfono válido.
4. Valida con Scrapling que los teléfonos sigan activos: visita Google Maps y verifica que la ficha aún existe.
5. Exporta una versión limpia como "leads-limpios.csv" y dime cuántos sobrevivieron del total original.

Enriquecer lista existente

Parte de una lista de nombres y Claude le agrega el resto de datos.

Tengo una lista de nombres de negocios en este archivo: [ruta al archivo].

Usa Scrapling para buscar cada uno en Google Maps y agregarle: teléfono, dirección, sitio web, calificación, número de reseñas y horario.

Los que no encuentres en Google Maps, búscalos en LinkedIn, Instagram y directorios locales como páginas amarillas. Si ahí tampoco aparecen, márcalos como "no encontrado" en una columna aparte.

Entrega el CSV enriquecido ordenado por número de reseñas (más activos primero).

Prospección en Instagram

Encuentra cuentas de negocio que cumplan un perfil específico.

Con Scrapling, busca cuentas de Instagram de [tipo de negocio, ej. cafeterías de especialidad] en [ciudad] que tengan entre [mínimo, ej. 500] y [máximo, ej. 5000] seguidores.

Para cada cuenta quiero: @usuario, nombre mostrado, bio, número de seguidores, correo o WhatsApp de contacto (si aparece en la bio), y link al perfil.

Filtra solo las que claramente son negocios activos (publicaron en el último mes). Exporta a CSV como "prospectos-instagram-[categoría]-[ciudad].csv".

Importante: respeta rate limiting — Scrapling ya lo hace, pero no aceleres. Prefiero tardar más que quemar la cuenta.

Mapa de directorio completo

Extrae todo un directorio vertical (ideal para bases de datos B2B).

Extrae todos los negocios listados en este directorio: [URL del directorio, ej. páginas amarillas de una categoría].

Navega página por página con Scrapling (respetando el rate limit). Para cada registro quiero todos los campos que aparezcan: nombre, categoría, contactos, ubicación, servicios, horario, etc.

Maneja la paginación automáticamente — no pares hasta que hayas cubierto el directorio completo o llegues a [N] páginas, lo que ocurra primero.

Entrega un CSV con TODOS los campos encontrados y dime cuántos registros totales extrajiste.

Agente semanal autónomo

Programa a Claude para que te traiga leads frescos cada semana, solo.

Quiero que cada lunes por la mañana Claude haga esto automáticamente:

1. Con Scrapling, busca [criterio específico, ej. "nuevos consultorios dentales abiertos en los últimos 6 meses en Tijuana"].
2. Compara con la lista que ya tengo en ~/Desktop/leads-maestros.csv.
3. Agrega solo los nuevos que no están en mi lista maestra.
4. Mándame un resumen por correo o Telegram con cuántos nuevos leads encontró y un preview de los 5 más prometedores.

Configúralo ahora usando el Skill o agente agendado que mejor aplique (Schedule, cron, o lo que recomiendes). Si necesitas un MCP adicional para enviar el correo/Telegram, instálalo tú mismo y pídeme las credenciales que necesites.

Haz scraping ético — tu negocio depende de ello

Respeta robots.txt y los términos de servicio del sitio. Si un sitio dice "no scraping", no lo hagas.
Rate limiting — Scrapling ya espera entre requests. No lo aceleres. Quemar un sitio te quema a ti.
No toques datos personales sensibles (direcciones privadas, datos médicos, etc.). Contactos comerciales de Google Maps es distinto: son datos públicos que el negocio mismo publicó para que lo contactes.
GDPR / LFPDPPP — si contactas a los leads, identifícate, explica de dónde sacaste sus datos y ofrece opt-out. Un email de prospección transparente vende 10x más que uno spam.

Trucos avanzados que puedes pedir a Claude

Stealth mode

Scrapling usa Camoufox — navegador anti-detección. Pídele a Claude que lo active para sitios protegidos con Cloudflare.

Rotación de proxies

Para listas grandes (1,000+ registros), configura proxies rotativos. Claude puede integrarlos con un MCP de proxy pool.

Auto-match selectors

Scrapling detecta cambios en el HTML de un sitio y actualiza selectores solo. Tus scrapers no se rompen aunque el sitio cambie.

Proyecto open source

Scrapling es un proyecto open source creado por @D4Vinci con licencia BSD-3-Clause. 37,500+ estrellas en GitHub y creciendo. Es 100% gratuito — incluso para uso comercial.

Código fuente

Ver repo en GitHub

Reportar problemas

Issues en GitHub

Documentación oficial

Referencia completa

¿Algo no funciona?

Pregúntale directo a Claude — él puede leer los logs del MCP, verificar la configuración y diagnosticar paso a paso. Si el problema es del sitio que estás extrayendo, Claude puede probar variantes (Camoufox vs Playwright, delays distintos, endpoints alternos) hasta dar con la que funcione.

Comparte lo que armaste

Cuando saques tu primera lista — o mejor aún, cuando cierres tu primer cliente gracias a ella — compártelo en Telegram o en redes y etiqueta @soyenriquerocha. La comunidad crece cuando todos mostramos qué herramientas sí sirven para hacer dinero real.