企业官网建设流程全解析

基于 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 配置的传统集成的最大区别——端点即服务。接入后按以下顺序完成环境校验：

1. 通过确认RUBE_SEARCH_TOOLS有响应，验证 Rube MCP 已可用；
2. 调用RUBE_MANAGE_CONNECTIONS，传入toolkit: yousearch；
3. 若连接状态不是 ACTIVE，跟随返回的认证链接完成授权设置；
4. 在运行任何工作流之前，再次确认连接状态显示为 ACTIVE。

步骤 3 值得注意：Yousearch 属于需要外部授权的服务，Composio 的连接管理工具会返回一个认证链接，由你（或让用户）在浏览器中完成授权后，连接才会转为 ACTIVE。

工具发现：RUBE_SEARCH_TOOLS

该技能反复强调"Always search tools first"（永远先搜索工具）。原因很直接：Composio 平台上工具 Schema 会随服务方 API 演进而变更，硬编码的 tool slug 或参数在几天后可能就失效了。

首次使用时，用generate_id让 Rube 为你创建一个新会话，并传入 Yousearch 相关的use_case：

RUBE_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_id，use_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确认状态为 ACTIVE；
• Schema 合规：严格使用搜索结果中的字段名与类型，一个字段名拼写错误都会导致执行失败；
• Memory 参数：RUBE_MULTI_EXECUTE_TOOL调用必须包含memory，即使为空也要传{}；
• 会话复用：同一工作流内复用会话 ID；开启新工作流时生成新 ID；
• 分页处理：检查响应中的分页令牌（pagination tokens），持续翻页直到数据取完为止，避免结果截断。

快速参考表

这张表可以作为你编写 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