gtm-tag-architect

一个面向 Google Antigravity 和 Claude Code 的公开、生产就绪插件，可通过 MCP 连接到 Google Tag Manager。

它提供交互式 /setup 命令，与开发者/营销人员就其网站进行访谈，诊断容器缺陷（重复项、缺失触发器、Consent Mode v2 违规），并生成优化的跟踪分类体系和 dataLayer 契约。

功能特性

• /setup 交互式命令： 引导你完成 3 阶段的访谈与审计工作流。

• 深度容器诊断： 审计重复的 GA4/Meta 代码、孤立触发器、未经用户同意的营销像素以及阻塞渲染的脚本。

• 自动修复： 对代码进行去重，并在所有代码上强制执行 Google Consent Mode v2。

• 行业跟踪矩阵： 为电商、SaaS/PLG 和 B2B 线索生成提供预构建的分类操作手册。

• 开发者 dataLayer.d.ts 生成器： 为 React、Next.js 和原生应用生成类型化事件契约和辅助 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. 网站类型与行业（电商、SaaS、线索生成、内容）

2. 所需像素（GA4、Meta、LinkedIn、Google Ads、PostHog）

3. 隐私要求（GDPR / Consent Mode v2）

然后它会执行诊断审计，并为你显示一个操作菜单，用于修复缺陷、应用同意规则或导出干净的 dataLayer.d.ts。

测试与本地审计

你可以针对随附的测试夹具运行离线诊断测试工具：

npm install
npm run audit-fixture

许可证

MIT