gtm-tag-architect

Публичный, готовый к продакшену плагин для Google Antigravity и Claude Code, который подключается к Google Tag Manager через MCP.

Он предоставляет интерактивную команду /setup, которая опрашивает разработчиков/маркетологов об их сайте, диагностирует дефекты контейнера (дубликаты, отсутствующие триггеры, нарушения Consent Mode v2) и генерирует оптимизированные таксономии отслеживания и контракты dataLayer.

Возможности

• Интерактивная команда /setup: Проводит вас через 3-этапный процесс интервью и аудита.

• Глубокая диагностика контейнера: Аудит дублирующихся тегов GA4/Meta, осиротевших триггеров, маркетинговых пикселей без согласия и скриптов, блокирующих рендеринг.

• Автоматическое исправление: Дедупликация тегов и применение Google Consent Mode v2 ко всем тегам.

• Отраслевые матрицы отслеживания: Готовые руководства по таксономии для E-Commerce, SaaS/PLG и B2B Lead Gen.

• Генератор dataLayer.d.ts для разработчиков: Генерирует типизированные контракты событий и вспомогательные push-функции для React, Next.js и обычных приложений.

• 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-сервер, определённый в mcp_config.json.

Для 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