Herald
Servidor MCP Rust de código aberto para dados de atribuição do Google Ads, GA4, Search Console e CRM.
Documentação
O Problema
Dashboards mentem
O Google Ads diz 40 conversões. O GA4 diz 28. A recepção diz que 15 pessoas realmente agendaram. Três sistemas, três números, zero verdade.
A atribuição quebra em cada transferência. Cliques não significam ligações. Ligações não significam agendamentos. Agendamentos são cancelados. A receita é a única verdade, e nenhum dashboard mostra isso.
Arquitetura
Três fontes. Uma inteligência.
GA4
Tráfego, canais, conversões, páginas, fontes de referência de IA
Herald
19 ferramentas MCP. Interface de consulta unificada. Um token, todos os dados.
CRM
Compromissos confirmados, receita, cancelamentos, funil de leads
Verdade Absoluta
Atribuição de ciclo fechado
O Herald não estima conversões. Ele as confirma. Cada agendamento no CRM carrega sua cadeia de atribuição completa: fonte, mídia, campanha, página de destino. Sem modelagem. Sem suposições.
01
Clique
O usuário clica no anúncio. Os parâmetros UTM são capturados.
→
02
Visita
O GA4 registra a sessão, a fonte e a página de destino.
→
03
Agendamento
O widget de agendamento é acionado. A atribuição flui para o CRM.
→
04
Confirmação
Compromisso real. Receita real. Verdade absoluta.
Ferramentas
19 ferramentas MCP
Cada ferramenta é uma consulta pura. Dados de entrada, resposta estruturada de saída. Sem dashboards para navegar. Faça a pergunta, obtenha a resposta.
Google Ads
get_performance
Métricas de campanha: impressões, cliques, CTR, CPC, conversões, custo
get_keywords
Desempenho de palavras-chave com pontuações de qualidade e tipos de correspondência
get_search_terms
Consultas reais que acionaram os anúncios. Encontre a qualidade da intenção.
list_changes
Quem mudou o quê, quando. Valores antes e depois.
run_query
GAQL bruto para análise personalizada
Analytics
get_analytics_traffic
Sessões por canal com taxa de rejeição e conversões
get_analytics_pages
Principais páginas: visualizações, usuários, taxa de conversão
get_booking_call_events
Funis de agendamento: clique, serviço selecionado, agendado
get_ai_referral_traffic
Tráfego do ChatGPT, Copilot, Perplexity, Claude, Gemini
Verdade Absoluta
get_patient_attribution
Compromissos reais com cadeia de atribuição completa
get_channel_breakdown
Agendamentos por canal: confirmados, cancelados, receita
get_lead_pipeline
Funil do CRM: novo, contatado, agendado, concluído
run_analytics_report
Relatório GA4 personalizado com corpo de solicitação JSON bruto
Escala
Um servidor. Muitas contas.
Configuração TOML única. Cada conta é mapeada para seu próprio ID de cliente do Ads, propriedade do GA4 e banco de dados do CRM. Pergunte sobre qualquer conta pelo nome. O Herald resolve o 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"
Atribuição de IA
As novas fontes de referência
As pessoas encontram negócios por meio da IA agora. O ChatGPT recomenda um dentista. O Copilot sugere uma clínica. O Herald rastreia essas sessões separadamente, para que o tráfego de referência de IA se torne uma métrica de primeira classe, não algo enterrado em "outros".
ChatGPT Copilot Perplexity Claude Gemini
Rust MCP Google Ads API v19 GA4 Data API SQLite OAuth 2.0 TOML