使用 Rube MCP 与 Composio 自动化 Brilliant Directories：基于 awesome-claude-skills 的实战指南

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

Brilliant Directories 是一款面向会员制目录网站的建站平台，其后台操作繁琐且接口文档变动频繁。本指南以 awesome-claude-skills 仓库中的 brilliant-directories-automation 技能 为骨架，完整讲解如何通过 Rube MCP（Composio 的托管接入层）对 Brilliant Directories 进行工具发现、连接管理与批量执行，帮助你掌握"先搜索 Schema、再校验连接、最后执行工具"的可靠自动化范式，并理解底层各 Rube 工具的职责与调用细节。

技能定位：仓库 78 个 SaaS 自动化技能之一

该技能文件（SKILL.md）是 awesome-claude-skills 仓库中composio-skills目录下的一个 Claude Skill，其 frontmatter 定义如下：

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

三个字段各有含义：

• name：技能的机器可读标识，用于在客户端中引用该技能；
• description：告诉 Agent 该技能适用于哪类任务——通过 Rube MCP 自动化 Brilliant Directories 操作，并强调"始终先搜索工具以获取最新 Schema"；
• requires.mcp：声明该技能运行所依赖的 MCP 服务器为rube，即在你的 MCP 配置中必须存在名为rube的服务器。

仓库 README.md 的 "App Automation via Composio" 一节对此类技能做了总述：仓库为 78 个 SaaS 应用提供了预构建的工作流技能，全部经由 Rube MCP（Composio）运行，每个技能都包含工具调用序列、参数指南、已知陷阱和快速参考表，且使用从 Composio API 实时发现的真实工具 slug。brilliant-directories-automation正是其中针对目录网站场景的一个。仓库中 composio-automation 等其他技能文件与本文档共享同一套工作流骨架，可互为印证。

前置条件

在运行任何 Brilliant Directories 自动化工作流之前，必须满足以下三项条件：

1. Rube MCP 已连接：确认RUBE_SEARCH_TOOLS工具可用（这是 Rube MCP 是否生效的直接标志）；
2. Brilliant Directories 连接已激活：通过RUBE_MANAGE_CONNECTIONS并指定 toolkit 为brilliant_directories建立连接，且状态为 ACTIVE；
3. 先搜索工具：任何工作流开始前都必须调用RUBE_SEARCH_TOOLS获取当前的工具 Schema——这是整个技能最核心的纪律，因为工具 slug 与参数会随服务端更新而变动。

初始化设置：接入 Rube MCP 端点

Rube MCP 的接入成本极低，无需申请任何 API Key——只需在客户端的 MCP 服务器配置中添加入口地址即可：

https://rube.app/mcp

添加完成后按以下 4 步完成连接初始化：

1. 验证可用性：调用RUBE_SEARCH_TOOLS，确认能够收到正常响应；
2. 发起连接：调用RUBE_MANAGE_CONNECTIONS，参数中指定 toolkit 为brilliant_directories；
3. 完成授权：如果返回的连接状态不是 ACTIVE，则按照返回的授权链接完成账号授权（OAuth 流程）；
4. 确认状态：在工作流运行前，务必确认连接状态显示为 ACTIVE。

工具发现：用 RUBE_SEARCH_TOOLS 获取动态 Schema

Brilliant Directories 的工具集并非静态写死，而是通过RUBE_SEARCH_TOOLS按需发现。首次调用时使用以下格式：

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

• queries.use_case：描述你打算执行的业务场景（例如发布目录条目、管理会员资料、处理订单等），Agent 会据此匹配最相关的工具；
• queries.known_fields：如果你已知部分字段名可以预先填入，未知则留空；
• session.generate_id: true：让 Rube 为该次会话自动生成会话 ID，便于后续工作流复用。

调用返回的内容通常包含四类信息：可用工具的 slug 列表、输入参数 Schema、推荐的执行计划（recommended execution plans）以及已知陷阱（known pitfalls）。这些信息是后续构造RUBE_MULTI_EXECUTE_TOOL参数的直接依据。

核心工作流：三步执行模式

Step 1：发现可用工具

在已有会话的基础上继续发现特定任务的工具：

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

注意此处复用已有会话 ID（session.id），与首次调用时的generate_id: true形成对照：同一个工作流内应复用会话，新工作流再生成新会话。

Step 2：检查连接

执行任何工具前，确认brilliant_directories连接处于 ACTIVE：

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

Step 3：执行工具

使用RUBE_MULTI_EXECUTE_TOOL执行发现到的工具，可一次提交多个工具调用：

RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: "TOOL_SLUG_FROM_SEARCH", arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: "your_session_id"

参数说明：

• tools：数组，每个元素包含tool_slug（必须来自RUBE_SEARCH_TOOLS的搜索结果，绝不能硬编码）和arguments（字段名与类型必须与搜索结果返回的 Schema 严格一致）；
• memory：必须始终携带，即使为空也要写{}——它是工具间传递上下文状态的关键参数；
• session_id：复用当前工作流的会话 ID。

已知陷阱与规避要点

该技能总结了六条经过实战验证的常见陷阱，务必逐条落实：

1. 永远先搜索再执行：工具 Schema 会变化。不调用RUBE_SEARCH_TOOLS就硬编码工具 slug 或参数，是绝大多数失败的根源；
2. 执行前校验连接：工具执行前通过RUBE_MANAGE_CONNECTIONS确认状态为 ACTIVE，避免在连接失效的情况下白跑请求；
3. Schema 严格合规：参数必须使用搜索结果给出的精确字段名和类型，多字段、少字段或类型不符都会导致执行失败；
4. memory 参数必填：RUBE_MULTI_EXECUTE_TOOL调用中始终携带memory参数，即使是空对象{}，省略会破坏调用契约；
5. 会话按需复用：同一工作流内复用会话 ID（保持上下文连续），新工作流则生成新会话，避免上下文串扰；
6. 关注分页：响应中若出现分页 token，应持续请求直到数据拉取完整，否则会漏掉后续批次的数据。

快速参考表

这张表构成了该技能的四层能力矩阵：日常单工具调用走前三行，批量数据处理走RUBE_REMOTE_WORKBENCH（在远程工作台中用run_composio_tool()包装多个调用），而当搜索返回的工具带有schemaRef引用、需要展开完整参数结构时，再用RUBE_GET_TOOL_SCHEMAS拉取全量 Schema。

工作流完整串接示例

将上述各环节串联起来，一次完整的 Brilliant Directories 自动化会话形如：

1. 首次调用RUBE_SEARCH_TOOLS（session.generate_id: true），拿到会话 ID 与工具清单；
2. 调用RUBE_MANAGE_CONNECTIONS完成/确认brilliant_directories授权，确认 ACTIVE；
3. 复用会话 ID 再次RUBE_SEARCH_TOOLS细化具体任务，获得目标工具 slug 与参数 Schema；
4. 按 Schema 组装RUBE_MULTI_EXECUTE_TOOL请求（携带memory: {}），执行并检查分页；
5. 需要批量场景时切换到RUBE_REMOTE_WORKBENCH的run_composio_tool()编排多个调用。

结语

brilliant-directories-automation技能的价值不在于列出某个固定 API 清单——因为第三方工具 Schema 天然会漂移——而在于建立一套"动态发现 + 连接校验 + Schema 合规执行"的稳健自动化范式。这套范式在仓库 78 个 Composio 自动化技能中完全通用，掌握它之后，无论是 Brilliant Directories 还是其他接入 Composio 的 SaaS 应用，你都能用同一套方法论快速落地可靠的自动化工作流。

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