名称: Microsoft Clarity 自动化 描述: “通过 Composio Microsoft Clarity 集成,自动化用户行为分析 – 导出热图数据、会话指标和参与度分析,按浏览器、设备、国家、来源等多个维度细分。” 要求: mcp: - rube
Microsoft Clarity 自动化
直接从 Claude Code 导出 Microsoft Clarity 用户行为分析数据。无需离开终端,即可提取热图数据、会话指标和多维度细分的参与度洞察。
工具包文档: composio.dev/toolkits/microsoft_clarity
设置
- 将 Composio MCP 服务器添加到您的配置中:
https://rube.app/mcp - 提示时连接您的 Microsoft Clarity 账户。代理将提供一个认证链接。
- 确保您的 Clarity 项目已启用足够的数据收集,以用于要分析的维度。
核心工作流
1. 导出近期分析数据
导出最近 1-3 天的 Clarity 分析数据,最多可同时按三个维度细分。
工具: MICROSOFT_CLARITY_DATA_EXPORT
关键参数:
numOfDays(必需) – 要导出的天数:1(最近 24 小时),2(最近 48 小时), 或3(最近 72 小时)dimension1– 第一个细分维度dimension2– 第二个细分维度 (可选)dimension3– 第三个细分维度 (可选)
可用维度:
Browser– Chrome、Firefox、Safari、Edge 等浏览器Device– 桌面、移动、平板设备类型Country/Region– 用户的地理位置OS– Windows、macOS、iOS、Android 等操作系统Source– 流量来源 (例如,google、直接、推荐)Medium– 流量媒介 (有机、cpc、推荐等)Campaign– 营销活动名称Channel– 流量渠道分组URL– 特定页面 URL
示例提示: “导出过去 24 小时按设备和国家/地区细分的 Clarity 数据”
2. 设备性能分析
分析用户行为在不同设备类型上的差异,以优化响应式设计。
工具: MICROSOFT_CLARITY_DATA_EXPORT
配置: numOfDays: 3, dimension1: "Device", dimension2: "Browser"
示例提示: “显示过去 3 天按设备和浏览器细分的 Clarity 指标”
3. 流量来源细分
了解哪些流量来源带来最多参与用户。
工具: MICROSOFT_CLARITY_DATA_EXPORT
配置: numOfDays: 2, dimension1: "Source", dimension2: "Medium"
示例提示: “导出过去 48 小时按来源和媒介细分的 Clarity 数据”
4. 地理用户行为
分析不同国家和区域的用户参与模式。
工具: MICROSOFT_CLARITY_DATA_EXPORT
配置: numOfDays: 3, dimension1: "Country/Region", dimension2: "Device"
示例提示: “获取过去 72 小时按国家/地区和设备类型细分的 Clarity 数据”
5. 页面级性能
检查哪些特定 URL 具有最高或最低的参与度指标。
工具: MICROSOFT_CLARITY_DATA_EXPORT
配置: numOfDays: 1, dimension1: "URL", dimension2: "Device"
示例提示: “导出昨天的 Clarity 数据,按 URL 和设备细分”
6. 营销活动归因分析
通过用户行为指标评估营销活动有效性。
工具: MICROSOFT_CLARITY_DATA_EXPORT
配置: numOfDays: 3, dimension1: "Campaign", dimension2: "Channel", dimension3: "Device"
示例提示: “显示过去 3 天按活动、渠道和设备细分的 Clarity 参与数据”
已知缺陷
- 有限时间窗口: 数据导出仅限于最近 1、2 或 3 天。
numOfDays参数只接受 1、2 或 3 的值。对于更长的历史分析,需要定期运行导出并在外部汇总。 - 维度名称精确匹配: 维度值必须完全匹配列出的名称 (例如,
Country/Region而不是country或region)。大小写和斜杠有影响。 - 最多三个维度: 每次导出最多可按三个维度细分。对于更复杂的分析,使用不同维度组合运行多次导出。
- 数据可用性延迟: Clarity 数据可能处理延迟。非常近期的会话 (最近几分钟) 可能不会出现在导出中。
- 单一工具限制: Clarity 集成目前只提供数据导出工具。对于热图可视化和会话记录,请直接使用 Clarity 网页仪表板。
- 响应大小: 使用高基数维度如
URL与其他维度组合的导出可能产生大响应负载。请考虑缩短时间窗口或使用更少维度。
快速参考
| 工具代号 | 描述 |
|---|---|
MICROSOFT_CLARITY_DATA_EXPORT |
导出最多 3 个维度细分的分析数据 |
可用维度:
| 维度 | 描述 |
|---|---|
Browser |
网页浏览器 (Chrome、Firefox、Safari 等) |
Device |
设备类型 (桌面、移动、平板) |
Country/Region |
地理位置 |
OS |
操作系统 |
Source |
流量来源 |
Medium |
流量媒介 |
Campaign |
营销活动 |
Channel |
流量渠道分组 |
URL |
特定页面 URL |
Powered by Composio