基于 Rube MCP 自动执行 Yousearch 任务Composio Yousearch Toolkit 实战指南【免费下载链接】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导读本文面向使用 Codex CLI / API 的开发者讲解如何借助 Composio 的 Yousearch 工具箱与 Rube MCP 网关以一套先发现、再连接、后执行的标准流程自动化 Yousearch 操作。读完本文你将掌握RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL三个核心 MCP 工具的用法学会规避工具模式变更、连接状态、Schema 合规性等常见陷阱并将这套模式复用到仓库中其他数百个composio-skills/*-automation技能中。背景技能、MCP 与 Composio 的关系本仓库awesome-codex-skills是一个精选的 Codex 实用技能集合每个技能以独立目录 SKILL.md的形式存在通过 frontmatter 中的name与description元数据让 Codex 在合适的任务场景下自动触发技能详见 README.md。技能本身只负责告诉 Agent如何工作而真正的实际动作依赖 MCP 网关提供的工具访问能力。Composio 的 MCP Gateway 以单一 MCP 端点聚合 1000 集成内置认证、团队级访问控制与审计日志见 README.md。composio-skills/yousearch-automation/SKILL.md正是这条链路的一个具体落地用 Rube MCP 作为统一入口自动操作 Composio 的 Yousearch 工具箱。该技能与仓库中的composio-skills/composio-automation/SKILL.md、composio-skills/composio-search-automation/SKILL.md等数百个技能共享同一套结构模板区别仅在于requires.mcp: [rube]声明与所操作的 toolkit 名称。这意味着你学透本文的流程后可以无障碍迁移到仓库内任意一个*-automation技能。技能元数据与前置条件composio-skills/yousearch-automation/SKILL.md的 frontmatter 声明了该技能的身份--- name: yousearch-automation description: Automate Yousearch tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---其中requires.mcp: [rube]是关键声明它告诉 Codex 该技能依赖名为rube的 MCP 服务器。运行任何工作流前必须满足以下前置条件Rube MCP 必须已连接RUBE_SEARCH_TOOLS工具可用必须存在有效的 Yousearch 连接通过RUBE_MANAGE_CONNECTIONS以toolkit: yousearch建立并保持 ACTIVE 状态始终先调用RUBE_SEARCH_TOOLS获取当前的工具 Schema切勿凭记忆硬编码工具参数。这三个前提贯穿了整个技能的设计理念工具模式是可变的连接状态是必须先验证的执行前必须基于实时 Schema。环境搭建接入 Rube MCP搭建环节非常轻量核心动作只有一个获取 Rube MCP在客户端配置中将https://rube.app/mcp添加为 MCP 服务器无需任何 API Key添加端点即可使用。这是该技能与需要繁琐 OAuth 配置的传统集成的最大区别——端点即服务。接入后按以下顺序完成环境校验通过确认RUBE_SEARCH_TOOLS有响应验证 Rube MCP 已可用调用RUBE_MANAGE_CONNECTIONS传入toolkit: yousearch若连接状态不是 ACTIVE跟随返回的认证链接完成授权设置在运行任何工作流之前再次确认连接状态显示为 ACTIVE。步骤 3 值得注意Yousearch 属于需要外部授权的服务Composio 的连接管理工具会返回一个认证链接由你或让用户在浏览器中完成授权后连接才会转为 ACTIVE。工具发现RUBE_SEARCH_TOOLS该技能反复强调Always search tools first永远先搜索工具。原因很直接Composio 平台上工具 Schema 会随服务方 API 演进而变更硬编码的 tool slug 或参数在几天后可能就失效了。首次使用时用generate_id让 Rube 为你创建一个新会话并传入 Yousearch 相关的use_caseRUBE_SEARCH_TOOLS queries: [{use_case: Yousearch operations, known_fields: }] session: {generate_id: true}调用返回四类关键信息可用的tool slugs工具标识符每个工具的input schemas输入参数结构推荐的execution plans执行方案已知的pitfalls已知陷阱提示。后续工作流中如果需要对返回结果做更深层校验可以配合快速参考表中的RUBE_GET_TOOL_SCHEMAS获取带schemaRef工具的完整 Schema。核心工作流模式三步走当技能进入正式执行阶段遵循固定的三步模式。所有请求都应复用同一会话 ID保持工作流上下文连续。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Yousearch task}] session: {id: existing_session_id}与首次发现不同这一步复用已有session_iduse_case描述当前要完成的具体任务例如搜索 Yousearch 项目信息拉取 Yousearch 的搜索记录等。返回的 tool slug 将作为下一步执行的真实依据。Step 2检查连接RUBE_MANAGE_CONNECTIONS toolkits: [yousearch] session_id: your_session_id执行任何工具前务必确认连接为 ACTIVE。若为 PENDING 或 INACTIVE应回到 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与arguments必须严格来自 Step 1 的搜索结果字段名与类型必须与 Schema 完全一致memory参数必须始终携带即使当前无上下文也传{}——它是工具间传递状态的通道。需要批量操作时可改用快速参考表中的RUBE_REMOTE_WORKBENCH并在远端工作台内调用run_composio_tool()把多个工具调用组织成一段可复用的远端执行单元。已知陷阱清单技能文档总结了 6 条实战中最高频的失败诱因逐条对照可显著提升任务成功率永远先搜索工具 Schema 会变。未调用RUBE_SEARCH_TOOLS之前绝不硬编码 tool slug 或参数检查连接执行工具前必须通过RUBE_MANAGE_CONNECTIONS确认状态为 ACTIVESchema 合规严格使用搜索结果中的字段名与类型一个字段名拼写错误都会导致执行失败Memory 参数RUBE_MULTI_EXECUTE_TOOL调用必须包含memory即使为空也要传{}会话复用同一工作流内复用会话 ID开启新工作流时生成新 ID分页处理检查响应中的分页令牌pagination tokens持续翻页直到数据取完为止避免结果截断。快速参考表操作方案查找工具使用 Yousearch 特定 use case 调用RUBE_SEARCH_TOOLS建立连接以toolkit: yousearch调用RUBE_MANAGE_CONNECTIONS执行工具用已发现的 tool slugs 调用RUBE_MULTI_EXECUTE_TOOL批量操作在RUBE_REMOTE_WORKBENCH中使用run_composio_tool()完整 Schema对带schemaRef的工具使用RUBE_GET_TOOL_SCHEMAS这张表可以作为你编写 Agent 提示词时的速查索引也可以直接嵌入到自己的 SKILL.md 中作为执行约定。源码佐证同一模式在仓库中的一致性为确认上述流程不是孤立设计可以在仓库中横向对比验证composio-skills/composio-automation/SKILL.md 与 composio-skills/composio-search-automation/SKILL.md 均采用完全相同的Prerequisites → Setup → Tool Discovery → Core Workflow Pattern三步→ Known Pitfalls → Quick Reference结构差异仅在 toolkit 名称分别为composio、composio_search、yousearch以及各自的官方 Toolkit 文档链接包括RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL、RUBE_REMOTE_WORKBENCH、RUBE_GET_TOOL_SCHEMAS五个工具在全部技能中的签名完全一致。由此可以推断这套搜索 → 连接 → 执行的模式是 Composio 技能族的标准执行协议而非 Yousearch 特有。理解本文后你可以近乎零成本地将该流程泛化到仓库composio-skills/目录下任意一个*-automation技能从-21risk-automation到zyte-api-automation数百个目录结构完全同构。实践要点总结接入成本极低Rube MCP 仅需一个端点https://rube.app/mcp无 API Key流程纪律是成功关键先搜索、再验连接、后执行三步顺序不可颠倒以 Schema 为准工具 slug 与参数永远以RUBE_SEARCH_TOOLS的实时返回为准会话与分页管理工作流内复用 session跨工作流新建 session有分页令牌就翻到底模式可迁移Yousearch 只是这套协议的一个实例掌握后可快速上手仓库内全部 Composio 集成技能。【免费下载链接】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），仅供参考