用途:通过 Rube MCP 调用 Composio 的 Google Analytics 工具包,自动化 Google Analytics 4(GA4)的报告查询与属性管理。
前置条件:Rube MCP 已连接且 RUBE_SEARCH_TOOLS 可用;通过 RUBE_MANAGE_CONNECTIONS 建立 toolkit 为 google_analytics 的活动连接;执行任何工作流前始终先调用 RUBE_SEARCH_TOOLS 获取当前工具模式,并确认连接状态为 ACTIVE。
设置:在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器,无需 API 密钥;随后用 RUBE_MANAGE_CONNECTIONS 连接 google_analytics,若未激活则按返回的认证链接完成 Google OAuth。
主要能力:
- 列出账户与属性:GOOGLE_ANALYTICS_LIST_ACCOUNTS、GOOGLE_ANALYTICS_LIST_PROPERTIES,支持 pageSize、pageToken、filter,属性 ID 形如 properties/123456,账户 ID 形如 accounts/12345。
- 标准报告:先用 LIST_PROPERTIES 获取属性 ID,可选 GET_METADATA 发现维度与指标、CHECK_COMPATIBILITY 验证兼容性,再用 RUN_REPORT 执行,支持 dateRanges、dimensions、metrics、过滤器、orderBys、limit、offset。日期格式为 YYYY-MM-DD 或 today、yesterday、7daysAgo、30daysAgo 等相对值;每报告最多 9 个维度。
- 批量报告:GOOGLE_ANALYTICS_BATCH_RUN_REPORTS,单次最多 5 个请求,且须针对同一属性。
- 透视报告:GOOGLE_ANALYTICS_RUN_PIVOT_REPORT,透视所用维度须同时列在顶层 dimensions 中。
- 漏斗报告:GOOGLE_ANALYTICS_RUN_FUNNEL_REPORT,支持 funnel 步骤与 funnelBreakdown,分开放漏斗与封闭漏斗,处理时间可能较长。
- 关键事件:GOOGLE_ANALYTICS_LIST_KEY_EVENTS,参数 parent 为属性资源名,支持 pageSize、pageToken。
常用维度与指标示例:date、city、country、deviceCategory、sessionSource、sessionMedium、pagePath、pageTitle、eventName;activeUsers、sessions、screenPageViews、eventCount、conversions、totalRevenue、bounceRate、averageSessionDuration。
限制与注意事项:属性 ID 必须使用完整资源名格式;维度与指标并非全部兼容,复杂报告前应先用 CHECK_COMPATIBILITY;报告数据嵌套在 rows 中,值以字符串返回;空报告可能不含 rows 键;账号/属性分页用 pageToken,报告分页用 offset 与 limit;今日数据可能因处理延迟而不完整。本技能输出不能替代环境特定的验证、测试或专家审查;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。