Secciones del caso
01El problema: confianza en directorios médicos online
Los pacientes que buscan especialistas médicos en Colombia chocan con dos problemas: directorios genéricos sin información real, o perfiles incompletos que no inspiran confianza. La oportunidad: construir el directorio que sí funciona, con perfiles ricos (FAQs, servicios, casos, fotos profesionales) y rankings SEO específicos por especialidad y ciudad.
Para que un directorio compita en Google con clínicas grandes, necesita escala (miles de páginas relevantes) y calidad por página (no contenido pegado, no thin content). Hacer las dos cosas a la vez requiere un sistema, no copy a mano.
02La solución: directorio programático con curación humana
El mejor DOC genera páginas a partir de una base de datos de doctores estructurada en Firestore. Cada doctor tiene perfil con especialidad, servicios, ubicaciones, FAQs, fotos. Las páginas se renderizan server-side en Express + Tailwind y se sirven desde Cloud Run con caché agresivo en Firestore.
Hay dos niveles: perfiles regulares y perfiles VIP. Los VIPs reciben tratamiento premium, landing page completa con servicios detallados, FAQs propias, fotos optimizadas con detección facial automática (Vision API hace el crop), versión en inglés para mercado internacional y prioridad en sitemap. El sitemap solo incluye perfiles "publicables" (con datos completos) para no enviar señales de thin content a Google.
03Stack técnico desplegado en GCP
Backend Express en Cloud Run (us-west1) con cache de Firestore en memoria del proceso. Vision API para crop facial automático de fotos de doctores. Cloud Tasks para procesos largos como regenerar PDFs de servicios o re-procesar todas las fotos de un doctor.
Tailwind 3 con un sistema de tokens propio para mantener consistencia visual entre cientos de páginas. SSR con plantillas JavaScript puras (sin framework) para mantener LCP bajo. Schema.org Physician y MedicalBusiness incrustado en cada perfil para que Google y AI Overviews entiendan el contenido.
Un Cloud Run Job auxiliar (`elmejordoc-ads-monitor`) monitorea cuentas Google Ads de los doctores anunciantes y envía resúmenes diarios y semanales por Resend. Otro Job (`audit-all-vip-services`) verifica integridad de todos los perfiles VIP antes de cada deploy.
04Cómo Claude Code aceleró el desarrollo
El reto principal de El mejor DOC es la consistencia a escala: si hay mil perfiles y uno tiene mal el schema o le falta una imagen, eso degrada el SEO de todo el sitio. Claude Code nos permitió construir scripts de auditoría que verifican TODO el catálogo antes de publicar, descubriendo problemas que un humano revisando manualmente se le habrían escapado.
Más importante: cuando hubo que internacionalizar los perfiles VIP al inglés, Claude Code preparó la migración i18n (estructura de datos, fallbacks, generación de slugs en inglés) en una sola sesión con cero regresiones. Lo mismo cuando se decidió mover el botón de buscar a una pantalla con resultados ricos en BD: refactor profundo con tests visuales antes de mergear.
Skills propias del proyecto: `generate-services-vip`, `publish-doctor`, `face-detect-photos`, `audit-all-vip-services`. Cada una automatiza una operación que antes tomaba 30+ minutos manuales.
05Resultados
El mejor DOC está al aire, sirviendo búsquedas reales de pacientes en Colombia. La arquitectura programática escala a miles de URLs sin pelearse con thin content gracias a la regla de "solo se publica lo completo". El i18n EN abre la puerta al mercado internacional (pacientes buscando especialistas en Colombia para procedimientos médicos).
La plataforma también funciona como CMS interno: el equipo administrativo gestiona doctores, servicios y fotos desde un panel propio, sin tocar código.
06¿Qué replicamos a clientes?
Esta arquitectura, directorio programático server-side con Firestore + caché + sitemap inteligente + schema rico, es replicable a cualquier vertical: directorios de profesionales, marketplaces de servicios, catálogos de productos largos. Si tu negocio depende de aparecer en Google con miles de páginas relevantes, hablemos.
