通过 Rube MCP 自动化 Hyperbrowser 操作awesome-codex-skills 实战技能指南【免费下载链接】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本文基于 awesome-codex-skills 仓库中的 hyperbrowser-automation 技能文档完整讲解如何借助 Composio 的 Hyperbrowser 工具集Toolkit与 Rube MCP让 Codex Agent 自动完成浏览器自动化操作。读完本文你将掌握 Rube MCP 的连接配置、工具发现Tool Discovery、连接状态管理、多工具批量执行的标准调用链以及避免踩坑的六条关键实践规范。一、技能定位一个 Codex Skill 是如何组织的在 awesome-codex-skills 仓库中每个技能都是一个独立目录目录内的SKILL.md是技能的核心文件。根据仓库 README.md 的说明Codex 通过SKILL.md的 YAML frontmatter 元数据name与description来决定何时触发某个技能只有在技能被触发后才会加载正文从而保持上下文精简。hyperbrowser-automation 技能 的 frontmatter 如下--- name: hyperbrowser-automation description: Automate Hyperbrowser tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---从这段元数据可以读出三层信息技能名称hyperbrowser-automation明确了该技能的职责范围——Hyperbrowser 相关的自动化操作触发描述descriptionCodex 在会话中根据自然语言任务与该描述进行匹配当用户提出与 Hyperbrowser 自动化相关的请求时自动触发本技能依赖声明requires.mcp: [rube]这是本技能运行的前提它强制要求当前客户端环境中已经挂载名为rube的 MCP 服务器即 Rube MCP。这种frontmatter 元数据 正文指令的结构贯穿整个仓库composio-skills目录下上百个自动化技能如 composio-automation、browserless-automation、composio-search-automation 等均采用完全一致的模板只是将工具集名称替换为各自的 toolkit。可以说hyperbrowser-automation 是这一整套经 Rube MCP 调用 Composio 工具集体系中面向浏览器自动化领域的具体化实例。二、前置条件运行本技能前必须满足的三项要求在触发任何 Hyperbrowser 工作流之前需要先确认以下三项前置条件均已满足Rube MCP 必须已连接技能内所有核心调用如RUBE_SEARCH_TOOLS都依赖 Rube MCP 暴露的工具若 MCP 未挂载技能将无法执行任何操作存在 ACTIVE 状态的 Hyperbrowser 连接需要通过RUBE_MANAGE_CONNECTIONS建立并激活 toolkit 为hyperbrowser的连接这是实际调用 Hyperbrowser 工具的鉴权基础始终先执行RUBE_SEARCH_TOOLS这是本技能反复强调的第一原则后续章节会详细解释原因。从仓库结构看hyperbrowser-automation/SKILL.md 是独立成目录的完整技能不含 scripts 或 references 子目录这说明该技能的指令全部内联在SKILL.md正文中属于典型的轻量级纯指令型技能。三、环境搭建接入 Rube MCP 并激活 Hyperbrowser 连接3.1 添加 Rube MCP 服务器Rube MCP 的接入方式极其简单——无需申请任何 API Key只需在客户端的 MCP 服务器配置中追加一个端点地址https://rube.app/mcp即可完成接入。以 Codex 为例在客户端配置中新增 MCP 服务器条目将 URL 指向该端点后重启客户端使配置生效。接入后即可在工具列表中看到以RUBE_前缀命名的一系列工具这正是后续所有调用依赖的 MCP 工具族。3.2 建立并激活 Hyperbrowser 连接完成 MCP 接入后按照技能文档的四个步骤完成连接初始化验证 Rube MCP 可用确认RUBE_SEARCH_TOOLS能够正常响应这是判断 MCP 通道是否打通的最快方式发起连接调用RUBE_MANAGE_CONNECTIONS传入 toolkithyperbrowser完成授权如果返回的连接状态不是 ACTIVE按照响应中返回的授权链接完成账号/凭证绑定流程确认状态在运行任何工作流之前再次确认连接状态已变为 ACTIVE。3.3 安装到 Codex 的两种方式仓库 README.md 提供了将技能安装到$CODEX_HOME/skills默认~/.codex/skills的两种途径推荐使用技能安装器。通过仓库 skill-installer 中的脚本一键安装安装后重启 Codex 即可加载新技能元数据手动安装将技能目录复制到$CODEX_HOME/skills/下重启 Codex然后在会话中描述任务即可触发。四、工具发现为什么永远先搜索技能文档在多个位置反复强调一个核心原则工具 Schema 会随版本变化永远不要硬编码工具 slug 或参数执行前必须调用RUBE_SEARCH_TOOLS。工具发现的标准调用示例如下RUBE_SEARCH_TOOLS queries: [{use_case: Hyperbrowser operations, known_fields: }] session: {generate_id: true}该调用的返回内容包含四类关键信息返回项说明可用工具 slug当前版本下 Hyperbrowser 工具集中实际可用的工具标识符输入 Schema每个工具参数的字段名、类型与必填性约束推荐执行计划针对目标任务的建议调用顺序与组合方式已知陷阱该工具集在实践中的已知注意事项在实际执行特定任务时应将use_case替换为具体任务的描述例如 your specific Hyperbrowser task并复用已有会话 IDRUBE_SEARCH_TOOLS queries: [{use_case: your specific Hyperbrowser task}] session: {id: existing_session_id}从源码结构可以推断这套先发现、后执行的设计是为了应对工具集 Schema 的动态演进——工具新增、参数调整、字段废弃都是常态只有以搜索结果为唯一事实来源才能保证调用始终符合当前版本的契约。五、核心工作流标准的发现—检查—执行三步模式5.1 发现可用工具针对具体任务调用RUBE_SEARCH_TOOLS获取该任务相关的工具 slug 与输入 Schema。这是整个工作流的入口确保后续执行步骤的参数都有据可依。5.2 检查连接状态调用RUBE_MANAGE_CONNECTIONS确认 Hyperbrowser 连接仍处于 ACTIVE 状态RUBE_MANAGE_CONNECTIONS toolkits: [hyperbrowser] session_id: your_session_idtoolkits数组指定要检查的工具集此处为hyperbrowsersession_id关联当前工作流的会话上下文。连接是工具调用的鉴权前提状态异常时必须先处理连接再继续。5.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调用要点tool_slug必须来自第一步RUBE_SEARCH_TOOLS的搜索结果严禁硬编码arguments必须严格遵循搜索返回的 Schema字段名与类型都要精确匹配memory参数必须始终携带即使为空也要传{}session_id复用当前工作流的会话 ID。RUBE_MULTI_EXECUTE_TOOL的多工具特性意味着tools数组可以包含多个工具条目这为在同一次调用中编排多个 Hyperbrowser 操作例如先打开页面、再提取内容、后执行交互提供了可能。六、进阶用法批量操作与完整 Schema 获取除标准三步流程外技能文档的快速参考表还提供了两种进阶用法批量操作使用RUBE_REMOTE_WORKBENCH配合run_composio_tool()函数。当需要以编程方式在远程工作台环境中批量执行多个 Composio 工具时可以在run_composio_tool()中按工具签名传入参数适合数据量较大或需要循环执行的场景完整 Schema 获取使用RUBE_GET_TOOL_SCHEMAS。当搜索返回的工具带有schemaRef引用时可通过该工具获取更完整的 Schema 定义适合需要深度定制参数或排查参数类型问题时使用。七、六大已知陷阱与规避策略技能文档总结了六条实践规范这是长期使用 Rube MCP 自动化框架的经验沉淀永远先搜索工具 Schema 会变化不调用RUBE_SEARCH_TOOLS就硬编码 slug 或参数是导致调用失败的首要原因先检查连接执行工具前必须确认RUBE_MANAGE_CONNECTIONS返回 ACTIVE 状态连接失效时任何工具调用都会失败严格遵循 Schema使用搜索结果中的精确字段名与类型不要凭记忆猜测参数结构始终携带 memory 参数RUBE_MULTI_EXECUTE_TOOL调用中即使无状态也要传memory: {}缺失该字段可能导致调用被拒绝会话复用策略同一工作流内复用 session ID 以保持上下文连续性开启新工作流时再生成新的 session ID处理分页检查响应中是否包含分页令牌pagination token若存在则需持续获取直到数据完整避免因分页截断导致结果不完整。八、快速参考速查表以下速查表覆盖了使用本技能时最常用的五种操作可直接作为日常开发的口袋参考操作方式查找工具RUBE_SEARCH_TOOLS传入 Hyperbrowser 相关的 use_case建立连接RUBE_MANAGE_CONNECTIONStoolkit 设为hyperbrowser执行操作RUBE_MULTI_EXECUTE_TOOL传入发现到的工具 slug批量操作RUBE_REMOTE_WORKBENCHrun_composio_tool()获取完整 SchemaRUBE_GET_TOOL_SCHEMAS用于带schemaRef的工具九、适用场景与边界说明本技能适用于所有需要让 Codex Agent 驱动 Hyperbrowser 完成浏览器自动化任务的场景典型的任务形态包括网页数据抓取、页面状态检查、浏览器交互操作等具体能调用哪些工具以RUBE_SEARCH_TOOLS返回结果为准。需要说明的使用边界技能本身不包含 Hyperbrowser 的鉴权凭证凭证通过RUBE_MANAGE_CONNECTIONS的授权链接流程绑定每个使用者需独立完成自己的连接激活本文所有调用参数RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL、RUBE_REMOTE_WORKBENCH、RUBE_GET_TOOL_SCHEMAS均直接来源于 hyperbrowser-automation 技能文档实际执行时请始终以技能文档与实时工具搜索结果为准不要依赖本文或任何历史调用中的静态示例若需深入了解该技能族在其他工具集上的同构用法可对照阅读仓库内同目录下的 composio-automation 与 browserless-automation 等技能文档它们共享同一套发现—检查—执行骨架仅工具集名称不同。掌握以上模式后你便可以在 Codex 会话中稳定地编排 Hyperbrowser 浏览器自动化任务并在工具集 Schema 持续演进的环境中保持调用的健壮性。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考