基于 Rube MCP 自动化 Cloudflare Browser Rendering：awesome-claude-skills 技能实战指南

本文聚焦 awesome-claude-skills 仓库中 cloudflare-browser-rendering-automation 技能，讲解如何通过 Rube MCP（Composio 提供）以标准化的「搜索工具 → 检查连接 → 执行调用」三步模式，让 Claude 等 Agent 自动完成 Cloudflare Browser Rendering（浏览器渲染）相关操作。读完本文，你将掌握 Rube MCP 的接入方式、工具发现机制、会话与分页处理规范，以及直接可复制的 MCP 调用序列。

一、技能定位与整体架构

awesome-claude-skills 是一个收录 1000+ 生产级 Claude Skills 的精选仓库，其中 composio-skills/ 目录存放的是通过 Rube MCP (Composio) 预构建的 SaaS 应用工作流技能。根据仓库 README 的说明，这类技能为每个应用内置了工具序列、参数指导、已知陷阱（pitfalls）和快速参考表，并且全部使用从 Composio API 发现的真实工具 slug（tool slug），而不是硬编码的猜测值。

本技能 cloudflare-browser-rendering-automation 是这套体系中的一员，其 YAML frontmatter（SKILL.md）声明了：

name: cloudflare-browser-rendering-automation
description: "Automate Cloudflare Browser Rendering tasks via Rube MCP (Composio). Always search tools first for current schemas."
requires:
  mcp: [rube]

这里 requires.mcp: <a href="https://link.gitcode.com/i/a9fd41e2a482489be840e504a7d8ced8" target="_blank">rube] 明确指出了技能运行的前提：Agent 环境中必须挂载名为 rube 的 MCP 服务器。技能的运行模式遵循 Claude Skills 的标准机制——SKILL.md 携带 name 与 description 供 Agent 在会话启动时渐进式加载，只有任务与技能相关时才会加载正文，从而在托管数百个技能的同时保持上下文窗口精简（见 [README 对 Skills 加载机制的说明）。

二、前置条件

在执行任何 Cloudflare Browser Rendering 工作流之前，必须满足以下三个条件（对应 SKILL.md 的 Prerequisites 章节）：

1. Rube MCP 已连接：环境中可用 RUBE_SEARCH_TOOLS 工具，这是整个技能体系的入口；
2. Cloudflare Browser Rendering 连接已激活：通过 RUBE_MANAGE_CONNECTIONS 工具建立 toolkit 为 cloudflare_browser_rendering 的连接，且状态为 ACTIVE；
3. 先搜索后执行：任何情况下都要先调用 RUBE_SEARCH_TOOLS 获取当前的工具 schema，因为工具 schema 会随 Composio API 演进而变化。

从仓库中同构的 composio-automation 技能 与 cloudflare-automation 技能 可以看到，这套前置条件在全部 composio-skills 中保持一致，区别仅在于 toolkit 名称，本技能对应的 toolkit 为 cloudflare_browser_rendering。

三、快速搭建：一分钟接入 Rube MCP

接入过程无需申请 API key，步骤非常轻量（Setup 章节）：

获取 Rube MCP：在你的客户端配置中，将 https://rube.app/mcp 添加为 MCP 服务器。无需任何 API key——只需添加端点即可工作。

随后按顺序完成 4 个验证步骤：

1. 确认 Rube MCP 可用：验证 RUBE_SEARCH_TOOLS 能正常响应；
2. 调用 RUBE_MANAGE_CONNECTIONS，传入 toolkit cloudflare_browser_rendering；
3. 若连接状态不是 ACTIVE，按照返回的授权链接完成设置（典型场景为 Cloudflare 账号的 OAuth 授权，参照 connect-apps-plugin 的说明，首次使用应用时需要通过授权流程）；
4. 确认连接状态显示 ACTIVE 后再运行任何工作流。

需要强调的是，授权与连接管理均由 Composio 在底层处理（仓库 connect-apps-plugin 同样采用该机制），技能本身不持有任何密钥，Agent 只负责按 schema 发起调用。

四、工具发现：RUBE_SEARCH_TOOLS 是唯一正确的入口

技能反复强调「Always search tools first」。在执行任何工作流前，必须先发现当前可用的工具，标准请求格式如下（Tool Discovery 章节）：

RUBE_SEARCH_TOOLS
queries: [{use_case: "Cloudflare Browser Rendering operations", known_fields: ""}]
session: {generate_id: true}

该调用返回四类关键信息：

• 可用工具 slug：即后续 RUBE_MULTI_EXECUTE_TOOL 调用中 tool_slug 字段的值来源；
• 输入 schema：每个工具的参数名、类型与必填项定义；
• 推荐执行计划：针对该 use case 的推荐工具调用顺序；
• 已知陷阱：Composio 侧沉淀的常见错误与规避方式。

首次发现工具时使用 session: {generate_id: true} 生成新的会话 ID；在工作流进行中复用已有会话时，改为 session: {id: "existing_session_id"}（见 Core Workflow Pattern）。

五、核心工作流：搜索 → 检查 → 执行

技能的完整工作流由三个步骤构成，下面按 SKILL.md 的 Core Workflow Pattern 逐段给出可直接复制的调用模板。

步骤 1：发现可用工具

RUBE_SEARCH_TOOLS
queries: [{use_case: "your specific Cloudflare Browser Rendering task"}]
session: {id: "existing_session_id"}

将 use_case 替换为具体的浏览器渲染任务描述（例如截图、HTML 转 PDF、页面内容提取等），并复用当前工作流的会话 ID。返回结果中的 tool_slug 将作为下一步的执行依据。

步骤 2：检查连接状态

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

传入 toolkit 数组与当前会话 ID，确认返回的连接状态为 ACTIVE。连接失效或未授权时，应回到 Setup 阶段重新完成授权，而不是强行执行工具。

步骤 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 compliance）；
• memory 参数必须始终携带，即使为空也要传 {}——这是技能明确列出的执行要求。

六、已知陷阱：六条必须遵守的守则

技能在 Known Pitfalls 章节 总结了六条实战守则，这也是 Agent 在执行时最常踩坑的地方：

陷阱	正确做法
总是先搜索	工具 schema 会变化。未经 RUBE_SEARCH_TOOLS 就硬编码工具 slug 或参数是最大的错误来源
检查连接	执行工具前必须确认 RUBE_MANAGE_CONNECTIONS 显示 ACTIVE 状态
Schema 合规	严格使用搜索结果中的精确字段名与类型，不要凭记忆猜测参数
Memory 参数	RUBE_MULTI_EXECUTE_TOOL 调用必须携带 memory，即使为空（{}）
会话复用	同一工作流内复用会话 ID；只有开启新工作流时才生成新的 ID
分页处理	检查响应中是否包含分页令牌（pagination tokens），有则继续拉取直到数据完整

其中「先搜索」与「分页处理」两条尤为关键：前者保证调用永远与当前 API 版本对齐，后者保证批量结果不会因分页而遗漏。这套守则在 composio-automation 等全部 composio-skills 技能中完全一致，属于可跨应用复用的通用规范。

七、快速参考表

技能以一张速查表总结了全部操作入口（Quick Reference）：

操作	方法
查找工具	RUBE_SEARCH_TOOLS，use case 填写 Cloudflare Browser Rendering 相关任务描述
建立连接	RUBE_MANAGE_CONNECTIONS，toolkit 传 cloudflare_browser_rendering
执行调用	RUBE_MULTI_EXECUTE_TOOL，使用搜索发现的工具 slug
批量操作	RUBE_REMOTE_WORKBENCH，配合 run_composio_tool() 函数
获取完整 schema	RUBE_GET_TOOL_SCHEMAS，适用于搜索结果中包含 schemaRef 的工具

• RUBE_REMOTE_WORKBENCH：面向批量/远程执行场景，通过 run_composio_tool() 在远端工作台编排工具，适合需要多轮调用或并行处理的复杂渲染任务；
• RUBE_GET_TOOL_SCHEMAS：当搜索结果返回 schemaRef 引用时，用该工具拉取工具的完整 schema 定义，补齐搜索结果的字段细节。

八、与其他 Rube 技能的关系

本技能并非孤立存在。整个 composio-skills/ 目录下还有大量同构技能，例如 composio-automation、cloudflare-automation，它们在接入方式、三步工作流、陷阱守则与快速参考结构上完全一致，差异仅在 toolkit 名称与 use case 描述。这意味着：

• 学习本技能后，你可以无障碍迁移到仓库中其他 78 个 SaaS 应用的自动化技能（见 README）；
• 当需要同时操作 Cloudflare 的多个产品面（如常规 Cloudflare API 与 Browser Rendering）时，可分别连接 cloudflare 与 cloudflare_browser_rendering 两个 toolkit，并在各自会话中执行对应调用。

从源码结构看，这套模式的设计意图是「一个统一入口（Rube MCP）+ 按应用封装的技能指令」，把工具发现、连接管理、schema 合规等通用复杂度下沉到 MCP 层，而技能层只负责定义流程与守则，这正是 Claude Skills「定义工作流、MCP 提供访问、工具承载动作」三层协作模型（README）在浏览器渲染场景下的具体落地。

---

参考文件：核心技能文档 cloudflare-browser-rendering-automation/SKILL.md；同构参考 composio-automation/SKILL.md 与 cloudflare-automation/SKILL.md；整体机制见 README.md；Composio 连接原理见 connect-apps-plugin/README.md。