Herald
Servidor MCP de código abierto en Rust para Google Ads, GA4, Search Console y datos de atribución de CRM.
Documentación
El Problema
Los paneles mienten
Google Ads dice 40 conversiones. GA4 dice 28. La recepcionista dice que 15 personas realmente reservaron. Tres sistemas, tres números, cero verdad.
La atribución se rompe en cada traspaso. Los clics no significan llamadas. Las llamadas no significan reservas. Las reservas se cancelan. Los ingresos son la única verdad, y ningún panel los muestra.
Arquitectura
Tres fuentes. Una inteligencia.
GA4
Tráfico, canales, conversiones, páginas, fuentes de referencia de IA
Herald
19 herramientas MCP. Interfaz de consulta unificada. Un token, todos los datos.
CRM
Citas confirmadas, ingresos, cancelaciones, canal de clientes potenciales
Verdad Fundamental
Atribución de circuito cerrado
Herald no estima conversiones. Las confirma. Cada reserva en el CRM lleva su cadena de atribución completa: fuente, medio, campaña, página de destino. Sin modelado. Sin suposiciones.
01
Clic
El usuario hace clic en el anuncio. Se capturan los parámetros UTM.
→
02
Visita
GA4 registra la sesión, la fuente y la página de destino.
→
03
Reserva
El widget de reserva se activa. La atribución fluye al CRM.
→
04
Confirmación
Cita real. Ingresos reales. Verdad fundamental.
Herramientas
19 herramientas MCP
Cada herramienta es una consulta pura. Datos de entrada, respuesta estructurada de salida. Sin paneles que navegar. Haz la pregunta, obtén la respuesta.
Google Ads
get_performance
Métricas de campaña: impresiones, clics, CTR, CPC, conversiones, costo
get_keywords
Rendimiento de palabras clave con puntuaciones de calidad y tipos de concordancia
get_search_terms
Consultas reales que activaron los anuncios. Encuentra la calidad de la intención.
list_changes
Quién cambió qué y cuándo. Valores antes y después.
run_query
GAQL sin procesar para análisis personalizados
Analytics
get_analytics_traffic
Sesiones por canal con tasa de rebote y conversiones
get_analytics_pages
Páginas principales: vistas, usuarios, tasa de conversión
get_booking_call_events
Embudos de reserva: clic, servicio seleccionado, reservado
get_ai_referral_traffic
Tráfico de ChatGPT, Copilot, Perplexity, Claude, Gemini
Verdad Fundamental
get_patient_attribution
Citas reales con cadena de atribución completa
get_channel_breakdown
Reservas por canal: confirmadas, canceladas, ingresos
get_lead_pipeline
Embudo CRM: nuevo, contactado, reservado, completado
run_analytics_report
Informe GA4 personalizado con cuerpo de solicitud JSON sin procesar
Escala
Un servidor. Muchas cuentas.
Configuración TOML única. Cada cuenta se asigna a su propio ID de cliente de Ads, propiedad de GA4 y base de datos CRM. Pregunta sobre cualquier cuenta por nombre. Herald resuelve el resto.
[[accounts]]
name = "client-north"
customer_id = "123-456-7890"
ga4_property = "properties/987654"
atrium_db = "/data/north.db"
[[accounts]]
name = "client-south"
customer_id = "098-765-4321"
ga4_property = "properties/123456"
Atribución de IA
Las nuevas fuentes de referencia
La gente ahora encuentra negocios a través de la IA. ChatGPT recomienda un dentista. Copilot sugiere una clínica. Herald rastrea estas sesiones por separado, para que el tráfico de referencia de IA se convierta en una métrica de primera clase, no algo enterrado en "otros".
ChatGPT Copilot Perplexity Claude Gemini
Rust MCP Google Ads API v19 GA4 Data API SQLite OAuth 2.0 TOML