gtm-tag-architect

Un plugin público y listo para producción para Google Antigravity y Claude Code que se conecta a Google Tag Manager mediante MCP.

Proporciona un comando interactivo /setup que entrevista a desarrolladores y especialistas en marketing sobre su sitio, diagnostica defectos del contenedor (duplicados, disparadores faltantes, violaciones de Consent Mode v2) y genera taxonomías de seguimiento optimizadas y contratos de dataLayer.

Características

• Comando interactivo /setup: Te guía a través de un flujo de trabajo de entrevista y auditoría en 3 etapas.

• Diagnóstico profundo del contenedor: Audita etiquetas GA4/Meta duplicadas, disparadores huérfanos, píxeles de marketing sin consentimiento y scripts que bloquean el renderizado.

• Remediación automatizada: Deduplica etiquetas y aplica Google Consent Mode v2 en todas las etiquetas.

• Matrices de seguimiento por industria: Runbooks de taxonomía predefinidos para comercio electrónico, SaaS/PLG y generación de leads B2B.

• Generador de dataLayer.d.ts para desarrolladores: Genera contratos de eventos tipados y funciones auxiliares de push para aplicaciones React, Next.js y vanilla.

• Servidor MCP de doble modo: Funciona en vivo contra la API REST v2 de Google Tag Manager o audita archivos JSON de contenedor exportados localmente sin conexión.

Related MCP server: mcp-gtm-ga4

Instalación y configuración

Para Google Antigravity

Clona o coloca este repositorio en tu espacio de trabajo o en el directorio de personalizaciones globales:

# In your project's .agents/plugins/ or ~/.gemini/config/plugins/
git clone https://github.com/jarnielcataluna/gtm-tag-architect.git

Antigravity descubrirá automáticamente el plugin, expondrá el comando de barra /setup y registrará el servidor MCP definido en mcp_config.json.

Para Claude Code / MCP independiente

Registra el servidor en tu claude_desktop_config.json o en la configuración MCP del proyecto:

{
  "mcpServers": {
    "gtm-tag-architect": {
      "command": "node",
      "args": ["/path/to/gtm-tag-architect/bin/gtm-mcp.js"]
    }
  }
}

Uso

Ejecuta el comando /setup

Dentro de Antigravity o Claude Code:

/setup

El agente te entrevistará sobre:

1. Tipo de sitio e industria (comercio electrónico, SaaS, generación de leads, contenido)

2. Píxeles requeridos (GA4, Meta, LinkedIn, Google Ads, PostHog)

3. Requisitos de privacidad (GDPR / Consent Mode v2)

Luego realiza una auditoría de diagnóstico y te presenta un menú de acciones para corregir defectos, aplicar reglas de consentimiento o exportar un dataLayer.d.ts limpio.

Pruebas y auditoría local

Puedes ejecutar el arnés de pruebas de diagnóstico sin conexión contra el fixture de prueba incluido:

npm install
npm run audit-fixture

Licencia

MIT