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