gtm-tag-architect

Google Antigravity 및 Claude Code용 공개 프로덕션 준비 플러그인으로, MCP를 통해 Google Tag Manager에 연결합니다.

개발자/마케터에게 사이트에 대해 인터뷰하고, 컨테이너 결함(중복, 누락된 트리거, 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