基于 Rube MCP 与 Composio 自动执行 Keen IO 分析任务的 Codex Skill 实战指南【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills导读本指南以开源仓库 awesome-codex-skills 中的 keen-io-automation Skill 为蓝本讲解如何通过 Rube MCPComposio 的 MCP 网关在 Codex 中自动发现、连接并执行 Keen IO 分析类工具调用。读完本文你将掌握完整的工具发现 → 连接检查 → 多工具执行工作流理解RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL等核心 MCP 工具的用法与已知陷阱并能照搬这套模式自动化任意 Keen IO 任务。一、背景Keen IO 自动化与 Rube MCPKeen IO 是面向事件数据的分析平台常用于埋点分析、漏斗与留存统计等场景。传统接入方式是调用其 REST API 并自行管理鉴权而 keen-io-automation 提供了一条更简洁的路径通过 Composio 的 Keen IO toolkit经由 Rube MCP 暴露为统一的 MCP 工具让 Codex Agent 直接以自然语言驱动真实的 API 调用。该 Skill 的 frontmatter 声明了其触发条件与依赖name: keen-io-automation description: Automate Keen IO tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube]requires.mcp声明该 Skill 运行时依赖名为rube的 MCP 服务器description被 Codex 用于在会话中按语义自动触发该 Skill这是本仓库所有 Skill 的通用约定详见 README.md 与 skill-installer/SKILL.mdAlways search tools first for current schemas 直接点出本 Skill 的第一原则工具 schema 会变先搜索、后执行。二、前置条件Prerequisites在运行任何 Keen IO 工作流之前必须满足以下三点Rube MCP 已连接客户端环境中存在可响应的RUBE_SEARCH_TOOLS工具Keen IO 连接已激活通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为keen_io的有效连接先搜索再执行每次执行前调用RUBE_SEARCH_TOOLS获取当前工具 schema禁止硬编码 tool slug 或参数。从依赖声明可以看出这套 Skill 面向的是已具备 Rube MCP 运行时的 Codex 环境若尚未安装 MCP可参考仓库中 mcp-builder 了解 MCP 服务器的构建与评估方式。三、Setup接入 Rube MCP 并建立 Keen IO 连接获取 Rube MCP在客户端配置中添加https://rube.app/mcp作为 MCP 服务器端点无需任何 API Key添加端点即可生效。接入后按以下顺序完成连接初始化验证可用性确认RUBE_SEARCH_TOOLS有响应发起连接调用RUBE_MANAGE_CONNECTIONStoolkit 传keen_io完成鉴权若连接状态不是ACTIVE跟随返回的 auth link 完成 Keen IO 账号授权确认状态在运行任何工作流之前确认连接状态显示为ACTIVE。这条流程与仓库中 connect/SKILL.md 描述的 Composio CLI 连接思路一致composio link toolkit一次 OAuth、长期生效区别在于 Rube 路径完全通过 MCP 工具完成不依赖本地 CLI。四、工具发现Tool DiscoveryKeen IO toolkit 的具体工具 slug 与入参 schema 会随版本演化因此任何工作流的起点都是工具发现。推荐的发现请求如下RUBE_SEARCH_TOOLS queries: [{use_case: Keen IO operations, known_fields: }] session: {generate_id: true}该调用会返回可用的工具 slugtool slugs列表每个工具的输入 schema推荐的执行计划execution plans已知陷阱known pitfalls提示。在首次调用中通过session: {generate_id: true}让系统生成一个新的会话 ID作为后续所有步骤的会话上下文。五、核心工作流模式Core Workflow Pattern无论具体任务是什么Keen IO 自动化都遵循三步模式发现 → 检查连接 → 执行。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Keen IO task}] session: {id: existing_session_id}将use_case替换为具体的 Keen IO 任务描述例如查询事件、创建数据集、拉取分析结果并复用已有会话 ID。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [keen_io] session_id: your_session_id确认返回状态为ACTIVE。若为其他状态回到 Setup 步骤跟随鉴权链接重新完成授权。Step 3执行工具RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: TOOL_SLUG_FROM_SEARCH, arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: your_session_id执行时注意tool_slug必须来自 Step 1 的搜索结果不要凭记忆填写arguments的字段名与类型必须严格符合 Step 1 返回的 schemamemory参数必须始终携带即使为空也要传{}session_id复用当前工作流的会话 ID。该 Skill 设计为单次多工具批量执行RUBE_MULTI_EXECUTE_TOOL适合把查询多个事件 → 汇总指标这类复合任务放在一次调用中完成如需更复杂的编排可参考 connect/SKILL.md 中的composio run工作流脚本方式。六、已知陷阱Known Pitfalls原文档总结了六条在实战中极易踩坑的注意事项逐条解读如下陷阱说明Always search first工具 schema 会变化。未经RUBE_SEARCH_TOOLS确认就硬编码 tool slug 或参数是最常见的失败原因Check connection执行前必须确认RUBE_MANAGE_CONNECTIONS返回ACTIVE连接过期会直接导致执行失败Schema compliance参数必须使用搜索结果中的精确字段名与类型大小写、嵌套结构都不能想当然Memory parameterRUBE_MULTI_EXECUTE_TOOL调用中必须携带memory参数即使为空也要传{}Session reuse同一工作流内复用会话 ID新工作流生成新 ID避免上下文串扰Pagination检查响应中的分页 tokenpagination tokens若存在则继续拉取直到数据完整防止只拿到第一页其中分页一条尤其值得注意Keen IO 的查询结果可能很大Agent 必须在拿到响应后主动检查分页标记并循环拉取这是保证分析结果完整性的关键细节。七、快速参考表Quick Reference操作方式查找工具RUBE_SEARCH_TOOLS Keen IO 专属 use case建立连接RUBE_MANAGE_CONNECTIONS toolkitkeen_io执行工具RUBE_MULTI_EXECUTE_TOOL 搜索到的 tool slug批量操作RUBE_REMOTE_WORKBENCHrun_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS针对带schemaRef的工具五种操作各司其职常规单步执行走RUBE_MULTI_EXECUTE_TOOL需要批量或脚本化运行时切换到RUBE_REMOTE_WORKBENCH在其中以run_composio_tool()编程式调用当工具以schemaRef引用外部 schema 时用RUBE_GET_TOOL_SCHEMAS拉取完整定义避免因 schema 不全导致参数构造错误。八、在仓库中的定位与安装方式keen-io-automation 位于仓库的composio-skills/目录下该目录收录了大量通过 Rube MCPComposio自动化第三方服务的同类 Skill如ahrefs-automation、google-maps-automation等它们共享同一套RUBE_SEARCH_TOOLS/RUBE_MANAGE_CONNECTIONS/RUBE_MULTI_EXECUTE_TOOL工作流骨架——掌握本文即掌握了整个目录的通用方法论。安装该 Skill 到 Codex 环境可复用仓库提供的安装器详见 skill-installer/SKILL.mdpython skill-installer/scripts/install-skill-from-github.py \ --repo ComposioHQ/awesome-codex-skills \ --path composio-skills/keen-io-automation安装完成后重启 Codex 使其重新加载 Skill 元数据之后在会话中自然描述 Keen IO 任务Codex 便会根据该 Skill 的descriptionfrontmatter 自动触发。九、小结Keen IO 自动化的核心不在于记住某个具体 API而在于建立先搜索、再连接、后执行的纪律用RUBE_SEARCH_TOOLS获取实时工具 schema 与执行计划用RUBE_MANAGE_CONNECTIONS保证连接处于ACTIVE用RUBE_MULTI_EXECUTE_TOOL或RUBE_REMOTE_WORKBENCH执行工具始终携带memory、复用会话、处理分页。将这套模式套用到 Keen IO 的事件查询、数据集管理与分析统计任务上即可让 Codex Agent 从生成分析建议升级为直接完成分析动作这也是本仓库 README.md 所倡导的让 Skill 拥有真实世界行动能力的落地范例。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考