用途：在终端中为 Microsoft Clarity 生成浏览器埋点代码，并审计本地 HTML 是否包含正确的 Clarity 安装与客户端 API 调用。适合在站点接入 Clarity、交付实现代码或上线前检查埋点。
主要能力：snippet install 渲染完整跟踪片段；snippet consent/identify/set/event/upgrade/mask 分别渲染 Cookie 同意、自定义标识、自定义标签、自定义事件、会话优先级及遮罩属性；audit html 检查 HTML 中的 Clarity 脚本、遮罩属性与 window.clarity 调用；tag 获取项目跟踪标签脚本；insights live 读取 Data Export API 实时洞察。
安装与验证：npx -y @mvanhorn/printing-press-library install clarity --cli-only，随后 clarity-pp-cli --version。若失败可用 go install github.com/mvanhorn/printing-press-library/library/marketing/clarity/cmd/clarity-pp-cli@latest（需 Go 1.26.6+）。
用法：客户端片段命令只需公开项目 ID，例如 clarity-pp-cli snippet install abc123 --format html。Data Export API 读取需设置令牌，如 export PP_CLARITY_API_TOKEN="..."，也可使用本地令牌文件或 MICROSOFT_CLARITY_API_TOKEN、CLARITY_API_TOKEN、PP_CLARITY_API_TOKEN_FILE。任意命令可加 --agent（等价 --json --compact --no-input --no-color --yes），支持 --select 过滤字段、--dry-run 预览、--deliver 输出到 stdout/file/webhook。可用 clarity-pp-cli which "<能力描述>" 查找命令，doctor 验证配置。
限制：该 CLI 为只读，不用于创建、更新、删除、发布、评论、点赞、邀请、下单、发送消息、预订、购买或更改远程状态，也不替代 Clarity 仪表盘。安装后若 --version 报 command not found，需将二进制目录加入 $PATH 后再使用。MCP 服务器可通过 go install .../clarity-pp-mcp@latest 安装，并用 claude mcp add clarity-pp-mcp -- clarity-pp-mcp 注册。