Contenidos
Antes de empezar
01Qué hace esta herramienta3
02Requisitos previos3
03Obtener tu API Key de Google4
Configuración
04Abrir la herramienta5
05Modo Directo vs. Proxy PHP5
06Instalar el Proxy PHP en cPanel6
Uso
07Seleccionar regiones y buscar7
08Entender los resultados8
09Exportar a CSV9
10Importar a MySQL desde cPanel9
Referencia
11Costos de la API de Google11
12Preguntas frecuentes12
13Glosario13
El Prospector de Farmacias CompraFlow es un archivo HTML que puedes abrir directo en tu navegador. Se conecta a Google Maps Places API, recorre automáticamente más de 80 comunas de Chile, y recopila los datos públicos de todas las farmacias independientes que encuentre.
Al terminar, tienes dos opciones para usar los datos: exportar un CSV para trabajar en Excel, o generar el SQL completo para importar la tabla directo a tu base de datos MySQL desde phpMyAdmin en cPanel.
~1.500
Farmacias esperadas
USD 10–20
Costo total estimado
Lo que extrae por cada farmacia
| Campo | Ejemplo | Disponibilidad |
|---|
| Nombre | Farmacia Austral | Siempre |
| Dirección completa | Av. Diego Portales 1421, Puerto Montt | Siempre |
| Comuna y Región | Puerto Montt · Los Lagos | Siempre |
| Teléfono | +56 65 225 4471 | ~60% de registros |
| Sitio web | farmaciaustral.cl | ~20% de registros |
| Rating Google | 4.5 ★ | Siempre |
| Cantidad de reseñas | 167 | Siempre |
| Prioridad calculada | Alta / Media / Baja | Calculado automático |
Nota importante
Google Maps
no entrega emails de las farmacias. El email se consigue en una segunda etapa visitando el sitio web de cada farmacia o usando herramientas como Hunter.io. Consulta la sección de Preguntas Frecuentes para más detalles.
No necesitas instalar nada. Solo necesitas tener listo lo siguiente antes de comenzar:
✓
Un navegador web moderno (Chrome, Edge o Firefox reciente)
✓
El archivo compraflow_prospector.html descargado en tu computador
✓
Una cuenta de Google Cloud con facturación habilitada (se explica en el Cap. 03)
✓
Una API Key de Google Maps con Places API activada
(Opcional pero recomendado) Acceso a tu cPanel para subir el archivo proxy.php
(Opcional) Una base de datos MySQL en cPanel para guardar los resultados
1
Ir a Google Cloud Console
Abre console.cloud.google.com e inicia sesión con tu cuenta Google. Si es la primera vez, acepta los términos de servicio.
2
Crear un proyecto
Haz clic en el selector de proyectos (arriba a la izquierda) → "Nuevo proyecto" → escribe un nombre como "CompraFlow Prospector" → Crear.
3
Habilitar facturación
Ve a Facturación en el menú lateral → vincula una tarjeta de crédito o débito. Google no te cobra hasta que superes los USD 200 mensuales gratuitos. Para este proyecto solo gastarás USD 10–20 en total, no al mes.
4
Activar Places API
Ve a APIs y servicios → Biblioteca → busca "Places API" → haz clic en el resultado → botón Habilitar. (Busca específicamente "Places API", no "Maps JavaScript API")
5
Crear la API Key
Ve a APIs y servicios → Credenciales → botón + Crear credenciales → Clave de API. Aparecerá una ventana con tu clave. Cópiala y guárdala en un lugar seguro.
6
Restringir la key (recomendado)
En "Editar clave de API" → en Restricciones de API selecciona Restringir clave → escoge solo Places API. Esto evita que si alguien obtiene la key la use para otros servicios.
Consejo de seguridad
Si usas el
Proxy PHP (recomendado), la API Key vive solo en tu servidor y nunca se expone en el navegador. Si usas Modo Directo, la key queda visible en el HTML — úsalo solo para pruebas.
El archivo compraflow_prospector.html funciona como una aplicación web independiente. No necesita servidor para abrirse — solo haz doble clic sobre el archivo en tu explorador de archivos y se abrirá en tu navegador.
Advertencia CORS
Al abrir el archivo localmente (sin servidor), Google Maps API bloqueará las solicitudes por seguridad del navegador (política CORS). Verás un error en la pantalla.
Esto es normal y esperado. Las soluciones se explican en el capítulo siguiente.
Tres formas de usar la herramienta
| Forma | Cómo | Seguridad | Recomendado |
|---|
| Proxy PHP en cPanel |
Sube proxy.php a tu hosting |
Alta — key en servidor |
Sí |
| Chrome sin CORS |
Flag al abrir Chrome |
Solo para pruebas |
Solo pruebas |
| Subir HTML a cPanel |
Sube el .html a public_html |
Media — key en HTML |
Con cuidado |
Opción rápida para probar: Chrome sin CORS
Solo para hacer pruebas en tu computador. Cierra Chrome completamente, luego:
Windows — ejecutar en CMD o PowerShell
chrome.exe --disable-web-security --user-data-dir=C:\tmp\chrome-test
Mac — ejecutar en Terminal
open -na "Google Chrome" --args --disable-web-security --user-data-dir=/tmp/chrome-test
No usar Chrome sin CORS para navegar normalmente
Abre este Chrome especial solo para usar el Prospector, luego ciérralo. No navegues otros sitios con CORS deshabilitado.
1
En la herramienta, ve a la sección "Proxy PHP"
Al final de la página del Prospector hay una sección con el código del proxy. Haz clic en el botón "Copiar proxy.php".
2
Editar el proxy con tu API Key
Abre un editor de texto (Notepad, VS Code, Sublime), pega el código copiado, y reemplaza TU_API_KEY_AQUI con tu API Key real de Google. Guarda el archivo con el nombre proxy.php.
3
Subir proxy.php a tu cPanel
Ingresa a cPanel → Administrador de archivos → navega a public_html (o dentro de la carpeta de tu dominio) → botón Subir → sube el archivo proxy.php.
4
Verificar que funciona
Abre en tu navegador: https://tudominio.cl/proxy.php?endpoint=textsearch&query=farmacia+Santiago. Deberías ver una respuesta JSON con resultados de farmacias. Si ves eso, el proxy está funcionando.
5
Configurar en la herramienta
En el Prospector, haz clic en el modo "Via Proxy PHP". Aparecerá un campo de texto — escribe la URL completa de tu proxy, por ejemplo: https://tudominio.cl/proxy.php. Ingresa tu API Key también (se enviará como validación adicional).
Selección de regiones
La herramienta tiene las 16 regiones de Chile disponibles como chips seleccionables. Por defecto todas están activas (moradas). Puedes:
- Hacer clic en una región para activarla o desactivarla individualmente.
- Usar el botón "Seleccionar / Deseleccionar todo" para activar o limpiar todas de una vez.
- Seleccionar solo 1 región para hacer una búsqueda rápida de prueba (ej: solo Valparaíso).
Estrategia recomendada
Comienza con
1 región pequeña (ej: Coquimbo o Maule) para verificar que todo funciona correctamente y entender el formato de los datos. Luego lanza la búsqueda completa.
Estimado de costo
Debajo del botón de inicio verás el costo estimado actualizado según las regiones seleccionadas. La fórmula es aproximada: cada comuna genera ~1 llamada de búsqueda (USD 0,032) y ~8 llamadas de detalle (USD 0,017 c/u).
Iniciar la búsqueda
1
Ingresa tu API Key
Pega tu API Key en el campo superior. El campo es de tipo contraseña para que no sea visible en pantalla.
2
Selecciona el modo
Elige Places API (para Chrome sin CORS) o Via Proxy PHP (recomendado, ingresa la URL de tu proxy).
3
Selecciona las regiones
Activa las regiones que quieres cubrir. El costo estimado se actualiza en tiempo real.
4
Presiona "▶ Iniciar búsqueda"
La herramienta comenzará a recorrer las comunas una por una. Verás el progreso en la barra y en el log de actividad en tiempo real.
El log de actividad
Mientras busca, el log muestra en tiempo real qué está ocurriendo:
Iniciando búsqueda en 87 comunas de 5 regiones...
[1/87] Santiago... → 12 farmacias encontradas
[2/87] Maipú... → 8 farmacias encontradas
[3/87] Puente Alto... → 6 farmacias encontradas
[4/87] Las Condes... → 0 farmacias encontradas
[5/87] La Florida... → 9 farmacias encontradas
⚠ API Key inválida o Places API no habilitada
Si ves el mensaje de API Key inválida, verifica que copiaste la key correctamente y que la Places API está habilitada en Google Cloud Console.
Detener la búsqueda
Puedes presionar "⏹ Detener" en cualquier momento. Los resultados recopilados hasta ese punto se mantienen y puedes exportarlos normalmente. Útil si ya tienes suficientes resultados o si quieres pausar.
La tabla de resultados
Los resultados aparecen en una tabla ordenada por Prioridad (Alta primero). Cada fila es una farmacia con sus datos disponibles.
Sistema de Prioridad
La herramienta calcula automáticamente la prioridad de contacto de cada farmacia:
| Prioridad | Criterio | Acción recomendada |
|---|
| Alta |
Tiene sitio web (y posiblemente email extraíble) |
Visitar sitio web → buscar email de contacto. Luego enviar demo personalizada. |
| Media |
Tiene teléfono pero no web |
Llamar o enviar WhatsApp presentando CompraFlow con la demo gratuita. |
| Baja |
Solo nombre y dirección |
Búsqueda manual en Facebook/Google o visita presencial si está en zona cercana. |
Métricas en tiempo real
Las 4 tarjetas en la parte superior se actualizan mientras avanza la búsqueda:
- Farmacias — total de registros únicos encontrados hasta ahora.
- Con teléfono — cuántas tienen número de contacto en Google Maps.
- Con sitio web — cuántas tienen URL registrada.
- Prioridad Alta — suma de farmacias con web o email disponible.
Sobre los duplicados
La herramienta usa el
place_id único de Google para evitar que la misma farmacia aparezca dos veces, incluso si es encontrada en búsquedas de comunas distintas.
Una vez terminada la búsqueda (o en cualquier momento durante ella), haz clic en el botón "↓ Exportar CSV". Se descargará automáticamente un archivo con el nombre:
farmacias_chile_YYYYMMDD.csv
El CSV incluye las columnas: nombre, direccion, comuna, region, telefono, web, rating, reviews, prioridad, place_id.
Abrir en Excel
El archivo usa codificación UTF-8 con BOM, lo que hace que Excel en Windows lo reconozca correctamente con tildes y eñes. Solo haz doble clic en el archivo o usa Datos → Desde texto/CSV si Excel no lo abre directamente.
1
Generar el SQL en la herramienta
Haz clic en el botón "↓ Ver SQL (MySQL)". Aparecerá la sección SQL al final de la página con el código completo listo para copiar.
2
Copiar el SQL
Haz clic en el botón "⎘ Copiar SQL". El SQL completo quedará en tu portapapeles. Incluye tanto la creación de la tabla como todos los INSERT.
3
Abrir phpMyAdmin en cPanel
Ve a tu cPanel → sección Bases de datos → phpMyAdmin. En el panel izquierdo, haz clic en el nombre de tu base de datos para seleccionarla.
4
Pegar y ejecutar
Haz clic en la pestaña SQL en el menú superior de phpMyAdmin. Pega el código copiado en el cuadro de texto y haz clic en el botón Continuar (o "Go").
5
Verificar la importación
phpMyAdmin mostrará un mensaje de éxito con el número de filas insertadas. Puedes hacer clic en la tabla farmacias_prospectos en el panel izquierdo para ver los datos.
Estructura de la tabla MySQL
| Columna | Tipo | Descripción |
|---|
| id | INT AUTO_INCREMENT | ID único generado automáticamente |
| nombre | VARCHAR(200) | Nombre de la farmacia |
| direccion | VARCHAR(300) | Dirección completa |
| comuna / region | VARCHAR(100) | Ubicación |
| telefono | VARCHAR(30) | Teléfono si disponible |
| web | VARCHAR(200) | URL del sitio web |
| rating / reviews | DECIMAL / INT | Puntaje y cantidad de reseñas en Google |
| prioridad | ENUM | Alta / Media / Baja (calculado) |
| place_id | VARCHAR(100) UNIQUE | ID único de Google Maps (evita duplicados) |
| estado | ENUM | Nuevo / Contactado / Demo / Cerrado / Descartado |
| notas | TEXT | Campo libre para anotaciones del equipo de ventas |
| created_at | DATETIME | Fecha de importación |
Tip de uso comercial
Los campos
estado y
notas están incluidos para que puedas usar esta tabla como un
CRM básico. Actualiza el estado de cada farmacia a medida que avanza tu proceso de ventas: Nuevo → Contactado → Demo → Cerrado.
Google Maps Places API tiene un crédito gratuito mensual de USD 200. Para este proyecto, el gasto total estimado es de USD 10–20, bien dentro del crédito gratuito.
| Tipo de llamada | Precio por 1.000 | Uso estimado | Costo total |
|---|
| Text Search (buscar farmacias) |
USD 32,00 |
~100 comunas |
USD 3,20 |
| Place Details (tel + web) |
USD 17,00 |
~800 farmacias |
USD 13,60 |
| Total estimado |
USD 16,80 |
Crédito gratuito mensual
Google da USD 200 de crédito gratis cada mes. El costo estimado de USD 16,80 queda completamente cubierto por este crédito.
Solo pagarías si hicieras más de 10 búsquedas completas de Chile en un mismo mes.
Cómo monitorear el gasto
Ve a console.cloud.google.com → tu proyecto → Facturación → Informes. Verás el consumo en tiempo real desglosado por API.
Configurar una alerta de presupuesto (recomendado)
En Facturación → Presupuestos y alertas → "Crear presupuesto" → define un límite de USD 50/mes y agrega tu email. Google te avisará si estás cerca del límite antes de cobrarte.
¿Por qué no aparecen emails en los resultados?
Google Maps no almacena emails en su base de datos pública. La herramienta extrae todo lo que Google tiene disponible. Para conseguir emails, visita el sitio web de cada farmacia (columna "web") y busca en su página de contacto, o usa herramientas como Hunter.io ingresando el dominio.
¿Por qué algunas farmacias no tienen teléfono?
El dueño no lo registró en Google Maps o Google no lo tiene verificado. Aproximadamente el 60% de las farmacias independientes tienen teléfono visible en Google.
¿La herramienta incluye las cadenas grandes como Salcobrand o Cruz Verde?
No. La herramienta filtra automáticamente Salcobrand, Cruz Verde, Ahumada, Doctor Simi, FASA y Farmacias Chilenas. Solo aparecen farmacias independientes.
¿Qué hago si la búsqueda tarda mucho?
La búsqueda completa de Chile puede tomar 30–60 minutos porque la herramienta hace pausas entre llamadas para respetar los límites de la API. Puedes buscar por regiones individuales para obtener resultados parciales más rápido. No cierres el navegador mientras busca.
¿Puedo correr la búsqueda varias veces?
Sí. Si importas a MySQL, el SQL usa INSERT IGNORE con place_id UNIQUE, lo que significa que si ya existe una farmacia con ese place_id no la duplica. Puedes volver a correr la búsqueda después de un tiempo para capturar farmacias nuevas.
¿Funciona en iPhone o Android?
La herramienta funciona en cualquier navegador moderno incluyendo móvil, pero la búsqueda completa es larga y conviene hacerla desde un computador con buena conexión. Los resultados sí se pueden exportar desde móvil.
¿Es legal usar los datos de Google Maps para esto?
Sí, con matices. Los Términos de Servicio de Google Maps permiten usar los datos de la API para aplicaciones propias. Lo que no permite es revender los datos en bruto como producto. Usar los datos para contactar clientes potenciales con tu propio producto es uso legítimo. Para envíos masivos de email, la Ley 19.628 de Chile requiere que los destinatarios hayan dado consentimiento o que exista relación comercial previa.
| Término | Definición |
|---|
| API Key | Código secreto que identifica tu cuenta ante Google y autoriza el uso de sus servicios. Equivalente a una contraseña de acceso a la API. |
| Places API | Servicio de Google que permite buscar negocios y lugares en su base de datos global. |
| CORS | Cross-Origin Resource Sharing. Política de seguridad del navegador que bloquea llamadas a servicios externos desde un archivo local. Por eso se necesita el proxy PHP. |
| Proxy PHP | Archivo intermediario que vive en tu servidor (cPanel) y hace las llamadas a Google en nombre del navegador, evitando el bloqueo CORS. |
| place_id | Identificador único que Google asigna a cada negocio. Sirve para evitar duplicados al importar a MySQL. |
| CSV | Comma-Separated Values. Formato de archivo de texto que almacena datos en tabla. Compatible con Excel, Google Sheets y cualquier base de datos. |
| phpMyAdmin | Interfaz web incluida en cPanel para administrar bases de datos MySQL sin necesidad de saber comandos. |
| INSERT IGNORE | Comando SQL que inserta una fila solo si no existe ya. Evita duplicados al correr el script más de una vez. |
| Rating | Puntaje de 1 a 5 estrellas basado en las reseñas de usuarios en Google Maps. Útil para priorizar farmacias con buena reputación. |
| Prioridad Alta | Farmacias que tienen sitio web registrado en Google Maps. Son las más fáciles de contactar porque es posible encontrar su email. |
CompraFlow
Manual de Usuario · Prospector de Farmacias v1.0
+56 9 4575 9032 · masapp.cl
Documento generado con fines internos. No distribuir sin autorización.