MicrosoftClarity自动化Skill microsoft_clarity-automation

---

名称: microsoft_clarity-automation 描述: “通过 Rube MCP (Composio) 自动化 Microsoft Clarity 任务：会话录制、热图和用户行为分析。始终首先搜索工具以获取当前模式。” 要求: mcp: [rube]

通过 Rube MCP 自动化 Microsoft Clarity

通过 Composio 的 Microsoft Clarity 工具包和 Rube MCP 自动化 Microsoft Clarity 操作。

工具包文档: composio.dev/toolkits/microsoft_clarity

先决条件

• 必须连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 建立活动的 Microsoft Clarity 连接，工具包为 microsoft_clarity
• 始终首先调用 RUBE_SEARCH_TOOLS 以获取当前工具模式

设置

获取 Rube MCP: 在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可工作。

1. 确认 Rube MCP 可用，通过验证 RUBE_SEARCH_TOOLS 响应
2. 调用 RUBE_MANAGE_CONNECTIONS，工具包为 microsoft_clarity
3. 如果连接未激活，请按照返回的认证链接完成设置
4. 在执行任何工作流前，确认连接状态显示为 ACTIVE

工具发现

在执行工作流前始终发现可用工具：

RUBE_SEARCH_TOOLS: queries=[{"use_case": "会话录制、热图和用户行为分析", "known_fields": ""}]

这将返回：

• Microsoft Clarity 的可用工具标识
• 推荐的执行计划步骤
• 已知的陷阱和边界情况
• 每个工具的输入模式

核心工作流

1. 发现可用的 Microsoft Clarity 工具

RUBE_SEARCH_TOOLS:
  queries:
    - use_case: "列出所有可用的 Microsoft Clarity 工具和功能"

在继续之前，查看返回的工具、其描述和输入模式。

2. 执行 Microsoft Clarity 操作

发现工具后，通过以下方式执行：

RUBE_MULTI_EXECUTE_TOOL:
  tools:
    - tool_slug: "<发现的工具标识>"
      arguments: {<符合模式的参数>}
  memory: {}
  sync_response_to_workbench: false

3. 多步骤工作流

对于涉及多个 Microsoft Clarity 操作的复杂工作流：

1. 搜索所有相关工具：RUBE_SEARCH_TOOLS 带有特定用例
2. 首先执行先决条件步骤（例如，先获取后更新）
3. 使用工具响应在步骤之间传递数据
4. 对于批量操作或数据处理，使用 RUBE_REMOTE_WORKBENCH

常见模式

操作前搜索

始终在创建新资源前搜索现有资源，以避免重复。

分页

许多列表操作支持分页。检查响应中的 next_cursor 或 page_token，并在耗尽前继续获取。

错误处理

• 在继续前检查工具响应中的错误
• 如果工具失败，验证连接是否仍为 ACTIVE
• 如果连接过期，通过 RUBE_MANAGE_CONNECTIONS 重新认证

批量操作

对于批量操作，使用 RUBE_REMOTE_WORKBENCH，在循环中使用 ThreadPoolExecutor 并行执行 run_composio_tool()。

已知陷阱

• 始终首先搜索工具：工具模式和可用操作可能更改。在通过 RUBE_SEARCH_TOOLS 发现之前，切勿硬编码工具标识。
• 检查连接状态：在执行任何工具前，确保 Microsoft Clarity 连接为 ACTIVE。过期的 OAuth 令牌需要重新认证。
• 尊重速率限制：如果收到速率限制错误，减少请求频率并实施退避机制。
• 验证模式：始终传递严格符合模式的参数。当返回 schemaRef 而非 input_schema 时，使用 RUBE_GET_TOOL_SCHEMAS 加载完整输入模式。

快速参考

操作	方法
查找工具	RUBE_SEARCH_TOOLS 带有 Microsoft Clarity 特定用例
连接	RUBE_MANAGE_CONNECTIONS 工具包为 microsoft_clarity
执行	RUBE_MULTI_EXECUTE_TOOL 带有发现的工具标识
批量操作	RUBE_REMOTE_WORKBENCH 带有 run_composio_tool()
完整模式	RUBE_GET_TOOL_SCHEMAS 用于带有 schemaRef 的工具

工具包文档: composio.dev/toolkits/microsoft_clarity