企业官网建设流程全解析

• AI 技能
• AI 插件
• 人工智能
• 工作流自动化

本指南以开源仓库awesome-claude-skills中 composio-skills/yousearch-automation/SKILL.md 为绝对主体，系统讲解如何让 Claude 通过 Rube MCP（Composio 提供）自动完成 Yousearch 相关的搜索、连接与批量操作。读完本文，你将掌握"先搜索工具 → 检查连接 → 多工具执行"的完整工作流范式、各 MCP 工具的调用负载格式，以及避免硬编码 schema 的关键陷阱，可直接在 Claude Code、Claude.ai 等支持 Skills 的环境中落地运行。

Skill 概览：yousearch-automation 是什么

yousearch-automation是一个标准的 Claude Skill 包，其核心载体是SKILL.md文件，由 YAML frontmatter 与 Markdown 指令两部分组成。文件开头（composio-skills/yousearch-automation/SKILL.md）声明了三个关键元信息：

name: yousearch-automation description: "Automate Yousearch tasks via Rube MCP (Composio). Always search tools first for current schemas." requires: mcp: [rube]

• name：Skill 的唯一标识，加载时作为元数据被 Agent 看到；
• description：向 Agent 描述该 Skill 的能力边界，并显式强调"Always search tools first for current schemas"（永远先搜索工具、再拿当前 schema），这是整套工作流的第一原则；
• requires.mcp：声明该 Skill 依赖名为rube的 MCP 服务器，即 Rube MCP。

该 Skill 的本质定位是：通过 Composio 的 Yousearch toolkit，经由 Rube MCP 这一统一入口，把 Yousearch 的搜索与数据操作能力封装成 Claude 可直接编排执行的工作流。它不直接硬编码某个具体 API 调用，而是依赖 Rube MCP 提供的四个核心工具完成"发现—连接—执行"闭环。

前置条件

在执行任何 Yousearch 自动化任务之前，需要满足以下条件（composio-skills/yousearch-automation/SKILL.md）：

1. Rube MCP 必须已连接：环境中必须存在可响应的RUBE_SEARCH_TOOLS工具；
2. 有效的 Yousearch 连接：通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为yousearch的 ACTIVE 连接；
3. 先搜索后执行：任何操作前都必须调用RUBE_SEARCH_TOOLS获取当前工具 schema，避免因 schema 变更导致调用失败。

从仓库结构看，这一"前置条件"并非 yousearch 独有——README.md 的 "App Automation via Composio" 一节说明，该目录下共收录了 78 个 SaaS 应用的预置工作流 Skill，每个 Skill 都遵循同一套"工具序列 + 参数指引 + 已知坑点 + 快速参考表"模板，yousearch-automation 正是其中之一。

环境搭建：接入 Rube MCP

搭建过程非常轻量，核心只有一步：把https://rube.app/mcp作为 MCP 服务器添加到你的客户端配置中。按原文档说明，这一过程无需任何 API Key——添加端点即可直接工作（composio-skills/yousearch-automation/SKILL.md）。

完成端点添加后，按以下顺序完成环境验证（composio-skills/yousearch-automation/SKILL.md）：

1. 调用RUBE_SEARCH_TOOLS，确认 Rube MCP 已可用；
2. 调用RUBE_MANAGE_CONNECTIONS，传入 toolkityousearch；
3. 若连接状态不是 ACTIVE，点击返回的授权链接完成 Yousearch 账号连接；
4. 在运行任何工作流前，再次确认连接状态为 ACTIVE。

这套"先验证工具、再验证连接、最后才执行"的顺序，是整个 Skill 保证可靠性的根基：连接未就绪就执行工具，只会得到授权类错误。

工具发现（Tool Discovery）：一切操作的起点

该 Skill 反复强调一个核心方法论：执行任何工作流之前，必须先发现可用工具。工具发现的调用格式如下（composio-skills/yousearch-automation/SKILL.md）：

RUBE_SEARCH_TOOLS queries: [{use_case: "Yousearch operations", known_fields: ""}] session: {generate_id: true}

调用后会返回以下关键信息：

• 可用工具 slug：即后续RUBE_MULTI_EXECUTE_TOOL中tool_slug字段的取值来源；
• 输入 schema：每个工具的合法参数结构与类型定义；
• 推荐执行计划：针对当前 use case 的推荐调用顺序；
• 已知坑点：该工具集的常见失败模式。

之所以"永远先搜索"，是因为工具 schema 是动态演进的——工具的 slug、参数名、字段类型都可能随上游 API 更新而变化。硬编码任何 slug 或参数，都会在 schema 变更后静默失败。这一点在原文档的 Known Pitfalls 中被列为第一坑点（composio-skills/yousearch-automation/SKILL.md）。

核心工作流模式：三步闭环

整个 Yousearch 自动化流程被凝练为三个步骤，构成一个可复用的闭环模式（composio-skills/yousearch-automation/SKILL.md）。

Step 1：发现可用工具

针对你的具体任务发起搜索，注意在此步骤复用已有会话 ID 而非新建：

RUBE_SEARCH_TOOLS queries: [{use_case: "your specific Yousearch task"}] session: {id: "existing_session_id"}

use_case描述越具体，返回的工具推荐越精准。相比首次发现的generate_id: true，此处在同一工作流内使用既有session.id，以保持会话连续性。

Step 2：检查连接

确认 Yousearch 连接处于 ACTIVE 状态：

RUBE_MANAGE_CONNECTIONS toolkits: ["yousearch"] session_id: "your_session_id"

toolkits传入数组形式，session_id与 Step 1 保持一致。若返回状态非 ACTIVE，应回到 Setup 阶段完成授权，而不是继续往下执行。

Step 3：执行工具

使用搜索阶段拿到的工具 slug，按 schema 传入参数：

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参数必须始终携带，即使没有跨步记忆需求也要显式传空对象{}。

已知坑点详解：六条实战红线

原文档用专门章节列出了六个高频陷阱（composio-skills/yousearch-automation/SKILL.md），这是整套工作流最直接的防错清单：

快速参考：四个 MCP 工具的分工

原文档以表格形式给出了全流程中四个核心 MCP 工具的分工（composio-skills/yousearch-automation/SKILL.md）：

这张表是四工具分工的最小记忆单元：日常单次操作走"搜索 → 连接 → 执行"三件套；面对批量任务则升级到RUBE_REMOTE_WORKBENCH远程执行；当工具 schema 过于庞大（以schemaRef引用形式返回）时，再通过RUBE_GET_TOOL_SCHEMAS拉取完整定义。

从仓库结构看：模板化 Skill 的适用边界

对照同目录下的其他 77 个自动化 Skill（如 composio-skills/hubspot-automation/SKILL.md 等同模板文件）可以发现，yousearch-automation 的文档结构是一个经过反复验证的通用范式：frontmatter 声明依赖 → 前置条件 → 环境搭建 → 工具发现 → 三步工作流 → 坑点清单 → 快速参考表。这种模板化的价值在于：无论目标是 Yousearch 还是其他任何 Composio 支持的 SaaS，Agent 只需替换use_case与toolkits名称，即可复用整套编排逻辑。

从 SKILL.md 的description与正文措辞可以推断，设计者刻意将"当前 schema 以搜索为准"作为最高原则写入指令，其意图是让 Skill 在工具 API 频繁演进的环境中长期保持可用——这也是该模板 Skill 最值得借鉴的设计思想。实际使用中，你完全可以在本 Skill 基础上，把use_case扩展为更细粒度的 Yousearch 业务场景（如特定类型的内容检索、定时批量拉取等），但必须始终保留"先搜索、再执行"的铁律。

本文全部内容基于仓库中 composio-skills/yousearch-automation/SKILL.md 及其所属的 composio-skills 目录结构撰写，未超出仓库现有文档与代码证据范围。

• AI 技能
• AI 插件
• 人工智能
• 工作流自动化