企业官网建设流程全解析

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

本文是一份针对 awesome-claude-skills 仓库中composio-skills/hyperbrowser-automationSkill 的完整实战指南。它面向需要在 Claude.ai、Claude Code 或 Claude API 中直接驱动 Hyperbrowser 浏览器自动化服务的开发者，讲解如何通过 Composio 的 Rube MCP 完成工具发现、连接管理与工具执行的全流程。读完本文，你将掌握「先搜索 Schema → 检查连接状态 → 按 Schema 执行工具」的安全自动化模式，以及如何在仓库中定位、安装和复用这套 Skill。

Skill 概览：hyperbrowser-automation 能做什么

hyperbrowser-automation是 awesome-claude-skills 仓库中 composio-skills 系列的一员，该系列为 78 个 SaaS 应用提供预构建的工作流 Skill（见 README.md 中 "App Automation via Composio" 一节）。该 Skill 的核心定位是：通过 Composio 的 Hyperbrowser toolkit 与 Rube MCP 自动化 Hyperbrowser 操作。

从 Skill 的 YAML frontmatter（即 SKILL.md 第 1-6 行）可以读出它的元信息：

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

• name：Skill 标识符，遵循仓库 CONTRIBUTING.md 规定的「小写 + 连字符」命名规范；
• description：一句话说明用途，并直接点出最重要的一条使用纪律——Always search tools first for current schemas（执行前必须先搜索工具以获取当前 Schema）；
• requires.mcp: [rube]：声明该 Skill 依赖名为rube的 MCP 服务器，这与 Claude Skills 的标准格式一致：Skill 本身不内嵌工具，而是约定好依赖的 MCP 连接与工作流行为。

值得说明的是，仓库中还包含多个浏览器相关 Skill，它们共享同一套 Rube MCP 模式，可作为对照阅读：browser-tool-automation、browserbase-tool-automation 以及功能更丰富的 firecrawl-automation。如果你需要在不同浏览器自动化服务之间切换，这套学习成本可以复用到多个 Skill 上。

工作原理：Skill、MCP 与工具的三层分工

在深入实操之前，有必要先理清 README.md 中阐释的分层模型：Skills 不是 MCP 服务器，也不是工具。

• MCP 定义 Agent 如何连接外部系统——认证、传输、工具发现；
• 工具是 Agent 实际调用的单个函数；
• Skill 则定义工作流——做什么、按什么顺序、带什么护栏。

在生产环境中三者协同运行：MCP 负责接入，工具负责动作，Skill 负责行为规范。hyperbrowser-automation正是这种分层思想的产物：它通过rubeMCP 获取工具，通过RUBE_*系列工具执行动作，而 Skill 文档本身为 Agent 规定了「搜索 → 连接 → 执行」的固定节奏，避免 Agent 在 Schema 变化后仍然硬编码旧的工具参数。

另一个关键机制是 Skills 的渐进式加载（progressive loading，见 README.md）：会话启动时 Agent 只看到每个 Skill 的名称与描述（约 100 token），完整的 SKILL.md 正文（通常小于 5000 token）只有在 Agent 判断当前任务相关时才会加载。这正是为什么 frontmatter 中的description必须写清楚「何时使用」，也是本文档反复强调RUBE_SEARCH_TOOLS优先的原因之一。

前置条件

在运行任何工作流之前，需要确认以下三项（见 SKILL.md 第 14-18 行）：

1. Rube MCP 必须已连接，且RUBE_SEARCH_TOOLS工具可用；
2. 已通过RUBE_MANAGE_CONNECTIONS建立 Hyperbrowser 连接（toolkit 为hyperbrowser）；
3. 始终先调用RUBE_SEARCH_TOOLS获取当前工具 Schema，再执行具体操作。

环境搭建：接入 Rube MCP

搭建过程非常轻量，核心只有一句话：在客户端配置中将https://rube.app/mcp添加为 MCP 服务器，无需任何 API Key——加上端点即可工作。

按 SKILL.md 第 20-27 行，推荐按以下四步完成验证：

1. 验证 Rube MCP 可用：确认RUBE_SEARCH_TOOLS有响应；
2. 建立连接：调用RUBE_MANAGE_CONNECTIONS，传入 toolkithyperbrowser；
3. 完成认证：如果连接状态不是 ACTIVE，则跟随返回的认证链接完成授权设置；
4. 确认状态：在运行任何工作流之前，确认连接状态显示为 ACTIVE。

这里「无 API Key」仅指 Rube MCP 端点本身的接入方式；Hyperbrowser 账号的连接认证仍需通过第 2、3 步完成。从仓库其他 Skill（如 composio-automation）可以看到完全一致的设置流程，说明这是 Composio 系列 Skill 的统一接入范式。

工具发现：一切从 RUBE_SEARCH_TOOLS 开始

这是整个 Skill 最重要的一条纪律，frontmatter 的 description 里就写明了：工具 Schema 会变化，永远不要硬编码工具 slug 或参数，必须先调用RUBE_SEARCH_TOOLS。

文档给出的发现示例为（SKILL.md 第 33-37 行）：

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

调用后，该工具会返回四类关键信息：

• 可用的工具 slug（tool slugs）；
• 输入 Schema（input schemas），即每个工具要求的字段名与类型；
• 推荐的执行计划（recommended execution plans）；
• 已知陷阱（known pitfalls）。

session: {generate_id: true}用于在首次调用时生成一个新的会话 ID，后续工作流中的连接检查与工具执行都复用它。known_fields: ""留空表示不预设任何已知字段，完全交给 Rube 返回最新 Schema。

核心工作流三步法

SKILL.md 第 41-69 行给出了每次 Hyperbrowser 自动化任务的标准节奏，共三步。

Step 1：发现可用工具

在具体执行前，先用针对性的 use case 搜索工具（复用已有会话 ID）：

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

把use_case换成你实际要做的事（例如启动浏览器会话、导航到某个 URL、提取页面数据等），从返回结果中挑选对应的tool_slug及其参数 Schema。

Step 2：检查连接

执行前确认 Hyperbrowser 连接处于 ACTIVE 状态：

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

这一步是安全护栏：如果连接过期或未完成认证，直接执行工具会得到无意义的失败结果，甚至触发认证错误。

Step 3：执行工具

拿到 slug 与 Schema 后，通过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数组支持一次提交多个工具调用；每个元素必须严格使用搜索结果返回的字段名与类型。注意memory: {}是必传参数——即使没有任何上下文记忆也要显式传入空对象，这是文档特别强调的兼容性要求。

参数语义与执行细节

结合三步法中的示例调用，可以把几个关键参数的含义拆解如下：

关于会话的生命周期，文档的指引很明确：工作流内复用同一个会话 ID；开启新工作流时生成新的会话 ID。这意味着一个「搜索 → 连接 → 执行」的完整闭环应该共享同一个会话，用于保持上下文连贯；而不同任务之间则不应串用会话，以免状态污染。

已知陷阱与规避

SKILL.md 第 71-78 行列出六条经过实战沉淀的注意事项，逐条解读如下：

1. 永远先搜索：工具 Schema 会变化，不要在没有调用RUBE_SEARCH_TOOLS的情况下硬编码工具 slug 或参数。这是第一条也是最重要的一条——Hyperbrowser 的 API 演进会直接反映在工具 Schema 上，旧参数可能在某个时间点失效。

2. 检查连接：执行工具前，务必通过RUBE_MANAGE_CONNECTIONS确认连接为 ACTIVE 状态。连接失效是最常见的静默失败源。

3. Schema 合规：严格使用搜索结果中的字段名与类型。多余字段或字段名拼写差异都会导致调用被拒绝。

4. memory 参数必传：RUBE_MULTI_EXECUTE_TOOL的每次调用都必须包含memory，即使为空对象{}。遗漏该参数可能导致调用报错。

5. 会话复用：同一工作流内复用会话 ID，新工作流才生成新 ID。这有助于保持状态连贯，同时避免跨任务污染。

6. 分页处理：检查响应中是否存在分页令牌（pagination tokens），如有则持续获取直到数据拉取完整。忽略分页会导致只拿到部分结果而不自知。

可以对照 firecrawl-automation 的 "Known Pitfalls" 一节看到同样的纪律体系（如异步任务轮询、429 限流、嵌套响应校验），说明「搜索优先 + 连接校验 + 响应完整性」是这组 Skill 通用的防坑准则。

快速参考表

SKILL.md 第 80-88 行的速查表覆盖了五种核心操作：

其中批量操作路径（RUBE_REMOTE_WORKBENCH）适合需要对多个页面或多个会话执行同类型操作的场景；而RUBE_GET_TOOL_SCHEMAS则在搜索返回结果中标记了schemaRef（即 Schema 引用）时使用，可拿到比搜索摘要更完整的字段定义。

在 awesome-claude-skills 仓库中的安装与使用

该 Skill 位于仓库的 composio-skills/hyperbrowser-automation/ 目录，结构即标准的「Skill 目录 + SKILL.md」形态（参见 CONTRIBUTING.md 中定义的 Skill 结构规范）。要在自己的环境中启用它，可按照 README.md 的 Claude Code 安装步骤操作：

1. 将 Skill 目录放入~/.config/claude-code/skills/：

   mkdir -p ~/.config/claude-code/skills/ cp -r hyperbrowser-automation ~/.config/claude-code/skills/

2. 校验元数据：

   head ~/.config/claude-code/skills/hyperbrowser-automation/SKILL.md

3. 启动 Claude Code：

   claude

Skill 会在相关任务出现时自动加载并激活；如果你使用的是 Claude.ai 或 Claude API，同样支持此 Skill（在 Claude.ai 中通过技能图标添加上传）。注意：Skill 只在 agent 判断当前任务相关时才加载正文，因此描述中「Always search tools first」的提醒能否生效，取决于 Agent 是否在进入 Hyperbrowser 任务时激活了本 Skill。

如果你希望进一步理解这套 Rube MCP 模式的整体设计，推荐继续阅读仓库中的 README.md（特别是 "App Automation via Composio" 章节与 composio-automation 这份同构 Skill），两者可以相互印证各参数的一致语义，帮助你更快地把这套方法论迁移到其他 78 个应用的自动化场景中。

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