gtm-tag-architect

Google Antigravity と Claude Code 向けの公開・本番対応プラグインで、Google Tag Manager に MCP 経由で接続します。

開発者/マーケターにサイトについてインタビューし、コンテナの欠陥（重複、欠落したトリガー、Consent Mode v2 違反）を診断し、最適化されたトラッキングタクソノミーと dataLayer 契約を生成する対話型の /setup コマンドを提供します。

機能

• /setup 対話型コマンド: 3 段階のインタビューと監査ワークフローをガイドします。

• 詳細なコンテナ診断: 重複した GA4/Meta タグ、孤立したトリガー、同意のないマーケティングピクセル、レンダリングをブロックするスクリプトを監査します。

• 自動修復: タグの重複を排除し、すべてのタグに Google Consent Mode v2 を適用します。

• 業界別トラッキングマトリクス: E-Commerce、SaaS/PLG、B2B Lead Gen 向けの事前構築済みタクソノミーランブック。

• 開発者向け dataLayer.d.ts ジェネレーター: React、Next.js、vanilla アプリ向けの型付きイベント契約とヘルパー push 関数を生成します。

• デュアルモード MCP サーバー: Google Tag Manager REST API v2 に対してライブで動作するか、ローカルのエクスポート済みコンテナ JSON ファイルをオフラインで監査します。

Related MCP server: mcp-gtm-ga4

インストールとセットアップ

Google Antigravity 向け

このリポジトリをワークスペースまたはグローバルカスタマイズディレクトリにクローンまたは配置します:

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

Antigravity はプラグインを自動的に検出し、/setup スラッシュコマンドを公開し、mcp_config.json で定義された MCP サーバーを登録します。

Claude Code / スタンドアロン MCP 向け

claude_desktop_config.json またはプロジェクトの MCP 設定にサーバーを登録します:

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

使用方法

/setup コマンドを実行

Antigravity または Claude Code 内で:

/setup

エージェントは以下についてインタビューします:

1. サイトタイプと業界（E-Commerce、SaaS、Lead Gen、Content）

2. 必要なピクセル（GA4、Meta、LinkedIn、Google Ads、PostHog）

3. プライバシー要件（GDPR / Consent Mode v2）

その後、診断監査を実行し、欠陥の修正、同意ルールの適用、クリーンな dataLayer.d.ts のエクスポートを行うアクションメニューを提示します。

テストとローカル監査

付属のテストフィクスチャに対してオフライン診断テストハーネスを実行できます:

npm install
npm run audit-fixture

ライセンス

MIT