gtm-tag-architect

Ein öffentliches, produktionsreifes Plugin für Google Antigravity und Claude Code, das über MCP eine Verbindung zu Google Tag Manager herstellt.

Es bietet einen interaktiven /setup-Befehl, der Entwickler/Marketer zu ihrer Website befragt, Container-Defekte diagnostiziert (Duplikate, fehlende Trigger, Consent-Mode-v2-Verstöße) und optimierte Tracking-Taxonomien sowie dataLayer-Verträge generiert.

Funktionen

• Interaktiver /setup-Befehl: Führt Sie durch einen dreistufigen Interview- und Audit-Workflow.

• Umfassende Container-Diagnose: Prüft auf doppelte GA4-/Meta-Tags, verwaiste Trigger, nicht eingewilligte Marketing-Pixel und render-blockierende Skripte.

• Automatisierte Behebung: Entfernt Duplikate von Tags und setzt Google Consent Mode v2 für alle Tags durch.

• Branchenspezifische Tracking-Matrizen: Vorgefertigte Taxonomie-Runbooks für E-Commerce, SaaS/PLG und B2B-Lead-Generierung.

• dataLayer.d.ts-Generator für Entwickler: Generiert typisierte Event-Verträge und Hilfs-Push-Funktionen für React, Next.js und Vanilla-Apps.

• MCP-Server mit zwei Modi: Läuft live gegen die Google-Tag-Manager-REST-API v2 oder prüft offline lokale exportierte Container-JSON-Dateien.

Related MCP server: mcp-gtm-ga4

Installation & Einrichtung

Für Google Antigravity

Klonen Sie dieses Repository oder platzieren Sie es in Ihrem Arbeitsbereich oder Ihrem globalen Anpassungsverzeichnis:

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

Antigravity erkennt das Plugin automatisch, stellt den /setup-Slash-Befehl bereit und registriert den in mcp_config.json definierten MCP-Server.

Für Claude Code / eigenständiges MCP

Registrieren Sie den Server in Ihrer claude_desktop_config.json oder in den MCP-Einstellungen des Projekts:

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

Verwendung

Führen Sie den /setup-Befehl aus

In Antigravity oder Claude Code:

/setup

Der Agent befragt Sie zu:

1. Website-Typ & Branche (E-Commerce, SaaS, Lead-Generierung, Content)

2. Erforderliche Pixel (GA4, Meta, LinkedIn, Google Ads, PostHog)

3. Datenschutzanforderungen (DSGVO / Consent Mode v2)

Anschließend führt er eine Diagnoseprüfung durch und präsentiert Ihnen ein Aktionsmenü, um Fehler zu beheben, Einwilligungsregeln anzuwenden oder eine saubere dataLayer.d.ts zu exportieren.

Testen & lokale Prüfung

Sie können die Offline-Diagnosetestumgebung gegen die enthaltene Testvorlage ausführen:

npm install
npm run audit-fixture

Lizenz

MIT