基于 Rube MCP 自动化 Tomba 数据操作：awesome-codex-skills 中 tomba-automation 技能实战指南

基于 Rube MCP 自动化 Tomba 数据操作awesome-codex-skills 中 tomba-automation 技能实战指南【免费下载链接】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本篇技术指南以 tomba-automation 技能文档为核心讲解如何在 Codex 中通过 Rube MCP 桥接 Composio 的 Tomba 工具包实现对 Tomba 邮箱查找与验证类数据操作的全流程自动化。读完本文你将掌握 Rube MCP 的连接配置、工具发现RUBE_SEARCH_TOOLS、连接管理RUBE_MANAGE_CONNECTIONS与批量执行RUBE_MULTI_EXECUTE_TOOL的标准调用范式并能复用在销售线索收集、联系人信息补全等真实业务场景中。技能是什么一个 Codex Skill 的定位tomba-automation是 awesome-codex-skills 仓库 composio-skills 目录下数百个XX-automation技能之一。按照仓库 README.md 的说明Codex skills 是模块化的指令包每个技能拥有独立的文件夹与SKILL.md通过 YAML frontmatter 中的name与description元数据声明自身职责Codex 根据用户请求自动触发匹配的技能并在触发后才加载正文从而保持上下文精简。tomba-automation 的 frontmatter 如下--- name: tomba-automation description: Automate Tomba tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---其中requires: mcp: [rube]明确声明了本技能强依赖 Rube MCP 这一外部工具服务器——没有它技能中的全部工作流都无法执行。description末尾的 Always search tools first for current schemas 则点出了本技能最核心的纪律先查工具、再执行。从使用场景看Tomba 属于 B2B 销售与营销链路中的邮箱查找/验证类数据服务本技能的意义在于让 Agent 摆脱只输出建议的局限真正把查询动作落地到 Tomba API 上。需要说明的是具体可用的 Tomba 操作如邮箱查找、验证、公司信息查询等以RUBE_SEARCH_TOOLS返回的实时工具清单为准切勿凭印象硬编码。前置条件在执行任何 Tomba 工作流之前技能要求同时满足以下三个条件Rube MCP 已连接客户端中已配置 Rube MCP且RUBE_SEARCH_TOOLS工具可用Tomba 连接已激活通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为tomba的连接且状态为 ACTIVE先搜索工具每次任务前必须先调用RUBE_SEARCH_TOOLS获取当前最新的工具 schema。第三点是反复强调的硬性要求因为第三方工具平台的 schema 会随版本演进硬编码的工具 slug 或参数可能随时失效。第一步接入 Rube MCPSetupRube MCP 是本技能的底层通道。按技能文档接入方式极为轻量将https://rube.app/mcp作为 MCP server 添加到你的客户端配置中无需任何 API Key——添加端点即可工作。完成接入后按以下顺序完成初始化验证RUBE_SEARCH_TOOLS可正常响应确认 Rube MCP 已就绪调用RUBE_MANAGE_CONNECTIONS传入 toolkittomba若连接状态不是 ACTIVE跟随返回的认证链接完成 Tomba 授权确认连接状态变为 ACTIVE 后再开始执行任何工作流。认证完成后连接会持久化后续会话无需重复授权这与仓库中 connect 技能描述的composio link toolkitOAuth 一次、连接常驻的机制是同一套设计哲学。第二步工具发现Tool Discovery在正式执行业务前必须先做工具发现。技能文档给出的标准调用如下RUBE_SEARCH_TOOLS queries: [{use_case: Tomba operations, known_fields: }] session: {generate_id: true}调用返回的内容包括可用的工具 slugtool slugs输入 schemainput schemas即每个工具的参数结构推荐的执行计划recommended execution plans已知的坑known pitfalls。其中session: {generate_id: true}表示让系统为本次会话生成一个全新的会话 ID——这适用于开启一个全新工作流的场景若是在已有工作流中继续则应改用session: {id: existing_session_id}复用会话。use_case字段应替换为你具体的 Tomba 任务描述例如邮箱查找、联系人验证等known_fields可填入已知的参数字段名用于辅助系统给出更精准的工具推荐。第三步核心工作流模式三步曲技能将 Tomba 自动化抽象为稳定的三步模式任何任务都按此节奏推进。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Tomba task}] session: {id: existing_session_id}与第二步的工具发现不同这里是面向具体任务的精准查询use_case填入本次要完成的 Tomba 任务描述session携带既有会话 ID在同一工作流内延续上下文。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [tomba] session_id: your_session_id执行前再次确认 toolkittomba的连接状态。若此处返回 ACTIVE则可以放心进入执行阶段若状态异常应回到初始化流程重新走认证。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必须来自RUBE_SEARCH_TOOLS的搜索结果不能凭记忆硬编码arguments必须严格符合搜索结果返回的 schema字段名与类型逐一对应memory参数必须始终携带即使为空也要写{}session_id复用当前工作流的会话 ID。RUBE_MULTI_EXECUTE_TOOL的tools字段是一个数组意味着一次调用即可编排多个 Tomba 工具串行/批量执行这是构建复合业务流水线的核心入口。已知陷阱清单Known Pitfalls技能文档总结了六条实战经验直接决定了自动化任务的成败陷阱应对原则工具 schema 会变永远不要硬编码 tool slug 或参数执行前必须先调RUBE_SEARCH_TOOLS连接可能失效执行前用RUBE_MANAGE_CONNECTIONS确认状态为 ACTIVE参数不符会报错严格使用搜索结果中的字段名与类型不增不减漏传 memoryRUBE_MULTI_EXECUTE_TOOL每次调用都必须带memory可为空对象{}会话乱用同一工作流内复用 session ID开启新工作流时生成新 ID分页遗漏响应中出现分页 token 时持续拉取直到取完所有数据其中先搜索再执行被列为第一优先级这是 Rube MCP 模式下与常规直接调用 API 最大的思维差异——工具即契约契约以搜索结果为唯一权威。快速参考表Quick ReferenceOperationApproachFind toolsRUBE_SEARCH_TOOLSwith Tomba-specific use caseConnectRUBE_MANAGE_CONNECTIONSwith toolkittombaExecuteRUBE_MULTI_EXECUTE_TOOLwith discovered tool slugsBulk opsRUBE_REMOTE_WORKBENCHwithrun_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMASfor tools withschemaRef对照表补充说明两点Bulk ops批量操作当需要执行大规模批量调用时可切换到RUBE_REMOTE_WORKBENCH并在其执行环境中通过run_composio_tool()编程式地循环调用 Tomba 工具适合线索批量补全、批量验证等场景Full schema完整 schema若搜索结果中的工具带有schemaRef引用即 schema 被单独引用存储需用RUBE_GET_TOOL_SCHEMAS获取完整展开的 schema 后再构造参数。模式的价值一个模板千种集成值得注意的是tomba-automation 并非孤立存在。在 composio-skills 目录下ahrefs、apollo、clearbit、hunter、zoominfo 等数百个自动化技能采用了完全相同的 Rube MCP 三工具模式RUBE_SEARCH_TOOLS→RUBE_MANAGE_CONNECTIONS→RUBE_MULTI_EXECUTE_TOOL。这意味着你掌握的这套调用范式可以无缝迁移到仓库中任何其他-automation技能上只需替换 toolkit 名称与use_case描述即可。这与 README.md 中MCP Gateway 提供单一 MCP 端点接入 1000 集成的定位互为印证对 Agent 而言所有第三方服务收敛为统一的工具发现与执行协议。如何安装与启用本技能本技能属于仓库 composio-skills/tomba-automation 目录安装方式与仓库其他技能一致方式一推荐使用 skill-installer 提供的脚本 install-skill-from-github.py将技能安装到$CODEX_HOME/skills默认~/.codex/skills方式二手动将 composio-skills/tomba-automation 目录复制到$CODEX_HOME/skills/下安装完成后重启 Codex以加载技能元数据在会话中描述你的 Tomba 任务Codex 会根据description自动触发本技能同时确保客户端已配置 Rube MCP 端点https://rube.app/mcp。小结tomba-automation 技能展示了Agent 能力边界的一种优雅解法业务逻辑Tomba 的数据能力由 Composio 工具包提供连接与鉴权由 Rube MCP 统一管理而 Codex 只负责按发现 → 检查 → 执行的固定节奏编排调用。对开发者而言掌握这套模式不仅能驾驭 Tomba更能直接解锁 composio-skills 中数百个同构技能让 Agent 从会说走向真做。【免费下载链接】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），仅供参考