使用 Rube MCP 自动化 Zyte APIawesome-codex-skills 中的 Codex 实战技能解析【免费下载链接】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本篇技术指南围绕仓库 composio-skills/zyte-api-automation/SKILL.md 展开完整讲解如何让 Codex 通过 Rube MCPComposio 的 Zyte API toolkit连接并驱动 Zyte API完成网页数据抓取相关操作的发现、鉴权与执行。读完本文你将掌握先搜索工具 Schema → 校验连接状态 → 按 Schema 执行的三步自动化工作流以及 session 复用、内存参数、分页处理等一组可复用的实战避坑要点并能在 Codex CLI / API 环境中直接落地这套技能。一、技能定位一份给 Codex 的可执行说明书在 awesome-codex-skills 仓库中每个技能都是一个独立文件夹内含一份SKILL.md。Codex 通过文件头部 YAML frontmatter 中的name与description判断何时触发该技能仅在触发后才加载正文从而保持上下文精简这一机制在仓库 README.md 中有明确说明。zyte-api-automation的 frontmatter 如下--- name: zyte-api-automation description: Automate Zyte API tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---两个关键信息点description 声明了使用边界该技能用于通过 Rube MCP 自动化 Zyte API 任务并要求先搜索工具以获取当前 Schema——这句Always search tools first是整份文档的最高优先级原则requires 声明了依赖技能运行时需要一个名为rube的 MCP 服务器。也就是说本技能不直接封装 Zyte 的 REST 接口而是站在 Rube MCP 之上把 Zyte API 的能力以可被 Codex 直接调用的工具形式暴露出来。二、前置条件Prerequisites开始之前需要确认三项条件Rube MCP 已连接Codex 客户端中必须能看到RUBE_SEARCH_TOOLS等 Rube 工具Zyte API 连接处于 ACTIVE 状态通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为zyte_api的活跃连接每次执行前先调用RUBE_SEARCH_TOOLS工具的 slug 与输入参数会随平台迭代而变化禁止凭记忆硬编码。这三项共同构成文档反复强调的安全边界永远以实时搜索结果为准而非以历史经验为准。三、环境搭建Setup3.1 接入 Rube MCPRube MCP 的接入方式非常轻量在 MCP 客户端配置中添加端点https://rube.app/mcp即可无需申请 API Key添加后即生效。配置完成后Codex 便能在会话中看到以RUBE_为前缀的工具族。3.2 建立 Zyte API 连接按以下步骤完成连接初始化通过确认RUBE_SEARCH_TOOLS有响应验证 Rube MCP 已就绪调用RUBE_MANAGE_CONNECTIONS传入 toolkitzyte_api若连接状态不是 ACTIVE跟随返回的授权链接完成 OAuth 设置在运行任何工作流之前确认连接状态已变为 ACTIVE。从仓库结构看这一接入 Rube → 连接指定 toolkit → 验证 ACTIVE的初始化流程是 composio-skills 家族composio-automation、composio-search-automation、webscraping-ai-automation 等数百个同类技能共同遵循的标准模板可以复用同一套心智模型去操作任意 toolkit。四、工具发现Tool Discovery在编写任何具体任务之前先执行工具发现请求RUBE_SEARCH_TOOLS queries: [{use_case: Zyte API operations, known_fields: }] session: {generate_id: true}返回结果通常包含四类信息可用的工具 slug 列表决定后续调用哪个工具输入 Schema每个工具接受的字段名、类型与必填项推荐的执行计划平台给出的建议调用序列已知陷阱该工具的历史踩坑提示。其中use_case应替换为你的具体任务描述known_fields留空即可session.generate_id: true表示由平台生成一个新的会话标识用于串联本次发现与后续执行。五、核心工作流三步模式Core Workflow Pattern无论目标 Zyte API 任务是什么执行节奏都固定为三步发现工具 → 校验连接 → 执行工具。第 1 步发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Zyte API task}] session: {id: existing_session_id}与初始化阶段不同的是这里传入的是既有session.id而非 generate_id以保持与当前工作流的上下文连续。第 2 步校验连接RUBE_MANAGE_CONNECTIONS toolkits: [zyte_api] session_id: your_session_id执行前最后一次确认zyte_api连接为 ACTIVE避免在未授权状态下发起无效调用。第 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必须取自第 1 步搜索结果的真实 slug不要臆造arguments必须严格符合搜索返回的 Schema 字段名与类型memory参数必须存在即使为空也要显式传{}session_id复用当前工作流的会话保证多步骤操作的状态连续性。六、已知陷阱与最佳实践Known Pitfalls文档明确列出六条高频踩坑点逐条落实即可显著提升自动化稳定性始终先搜索Always search first工具 Schema 会变化。未经RUBE_SEARCH_TOOLS校验绝不硬编码工具 slug 或参数校验连接Check connection执行工具前确认RUBE_MANAGE_CONNECTIONS返回 ACTIVE 状态Schema 合规Schema compliance严格使用搜索结果给出的字段名与类型多一个字段、错一个类型都可能导致调用失败memory 参数必传Memory parameterRUBE_MULTI_EXECUTE_TOOL调用必须携带memory内容可为空对象{}会话复用Session reuse同一工作流内复用 session ID开启新工作流时再生成新 ID分页处理Pagination检查响应中的分页令牌pagination tokens持续拉取直至数据完整防止只取回第一页。七、操作速查表Quick Reference操作方式查找工具RUBE_SEARCH_TOOLS传入 Zyte API 相关的 use_case建立连接RUBE_MANAGE_CONNECTIONStoolkit 指定zyte_api执行调用RUBE_MULTI_EXECUTE_TOOL使用搜索发现的工具 slug批量操作RUBE_REMOTE_WORKBENCH通过run_composio_tool()编排获取完整 SchemaRUBE_GET_TOOL_SCHEMAS用于带schemaRef的工具这张表覆盖了从找工具到批量执行的完整操作面日常单次调用走RUBE_MULTI_EXECUTE_TOOL需要多工具编排的复杂流程交给RUBE_REMOTE_WORKBENCH的run_composio_tool()当工具带有schemaRef引用、需要展开完整定义时再用RUBE_GET_TOOL_SCHEMAS补齐。八、将技能安装到 Codex本技能位于仓库 composio-skills/zyte-api-automation 目录可按仓库 README.md 提供的两种方式接入 Codex方式一使用 Skill Installer推荐git clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/zyte-api-automation安装脚本会把技能放入$CODEX_HOME/skills/skill-name默认~/.codex/skills更多参数--ref、--dest、--method等可参考 skill-installer/SKILL.md。方式二手动复制将composio-skills/zyte-api-automation/整个目录复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex 以加载新的 frontmatter 元数据在新的会话中直接描述任务如帮我通过 Zyte API 抓取某网页数据Codex 会根据description自动匹配触发该技能也可以显式提及技能名zyte-api-automation。安装完成后技能运行时的最终依赖仍是 Rube MCP 与zyte_api的 ACTIVE 连接因此前文第二、三节的初始化步骤是必做的前置动作。九、纵深理解Rube 家族与源码佐证zyte-api-automation并非孤例。仓库composio-skills/下收录了数百个结构完全一致的XX-automation技能例如 brightdata-automation、webscraping-ai-automation、scrapingbee-automation 等同类抓取类技能以及 composio-automation 这样的元技能。它们共享同一套 Rube MCP 交互协议RUBE_SEARCH_TOOLS/RUBE_MANAGE_CONNECTIONS/RUBE_MULTI_EXECUTE_TOOL差异仅在于toolkits参数指向的具体业务 toolkit。这意味着学会本文的 Zyte API 流程就等于掌握了 Rube 协议下任意 toolkit 的接入方法更换业务目标时只需把zyte_api换成目标 toolkit 名并重新执行工具发现即可每次运行前强制调用RUBE_SEARCH_TOOLS正是为了吸收各 toolkit 的 Schema 动态变化这份以搜索为准的协议设计从源头规避了工具演进的兼容性问题。对于希望深入研究的读者建议依次阅读本技能全文 composio-skills/zyte-api-automation/SKILL.md、仓库技能机制说明 README.md、同族技能 composio-automation 与 composio-search-automation即可完整还原 Rube MCP 自动化体系的全貌。【免费下载链接】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），仅供参考