使用 awesome-codex-skills 的 smartproxy-automation基于 Rube MCP 与 Composio 驱动 Smartproxy 代理池自动化【免费下载链接】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 中收录的composio-skills/smartproxy-automation技能文档展开讲解如何让 Codex Agent 通过 Rube MCPComposio 的 MCP 网关接入 Smartproxy 工具集完成代理 IP 的获取、管理与轮换等自动化操作。读完本文你将掌握 Rube MCP 的接入方式、工具发现与连接管理的标准流程、RUBE_MULTI_EXECUTE_TOOL的执行范式以及避免工具 Schema 漂移、连接失效等常见坑位的实战要点。一、技能定位一份开箱即用的 Codex Skill 清单项当前仓库是一份面向 Codex CLI 与 API 工作流自动化的精选技能清单其核心单元是Codex Skill——一个包含SKILL.md元数据namedescription与逐步指导的模块化指令包。Codex 通过元数据判断何时触发技能仅在触发后加载正文从而保持上下文精简参见 README.md。本文所讲的核心文档位于 composio-skills/smartproxy-automation/SKILL.md其 frontmatter 声明如下name: smartproxy-automation description: Automate Smartproxy tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube]从中可以读出三层关键信息功能边界自动化 Smartproxy 相关任务通过 Rube MCP 调用 Composio 的 Smartproxy toolkit。强制约束description中明确要求始终先搜索工具以获取当前 Schema这是整个技能最重要的运行纪律。依赖声明requires.mcp声明了该技能依赖名为rube的 MCP 服务器Codex 加载技能时会据此识别运行前置条件。在仓库中这一模式并非孤例——composio-skills/目录下存在大量同构技能如 composio-automation、composio-search-automation 以及数百个按第三方服务命名的*-automation技能它们共享同一套 Rube MCP 工作流骨架仅替换目标 toolkit 名称。因此本文讲解的流程可平移复用于其他任何 Composio 集成技能。提示本技能对应的官方 Toolkit 文档为composio.dev/toolkits/smartproxy用于查阅 Smartproxy 工具集的完整能力清单。二、前置条件三件必须确认的事在运行任何 Smartproxy 工作流之前技能要求确认三项前置条件Rube MCP 已连接RUBE_SEARCH_TOOLS可用说明 MCP 通道已打通。Smartproxy 连接为 ACTIVE通过RUBE_MANAGE_CONNECTIONS建立并确认 toolkit 为smartproxy的连接处于活跃状态。先搜索工具 Schema每次执行前必须调用RUBE_SEARCH_TOOLS获取当前工具 Schema禁止依赖记忆或硬编码。其中第 3 点是整套方法论的核心——Rube 背后的 Composio 工具 Schema 会随上游服务迭代而变化只有实时搜索才能保证参数名与类型的准确性。三、接入 Setup两步拿到 Rube MCPRube MCP 的接入成本极低无需申请任何 API Key在客户端的 MCP 服务器配置中添加端点https://rube.app/mcp保存后即生效。接入后按以下顺序完成初始化验证确认RUBE_SEARCH_TOOLS能正常响应验证 Rube MCP 可用以 toolkitsmartproxy调用RUBE_MANAGE_CONNECTIONS若连接状态不是 ACTIVE点击返回的授权链接完成 OAuth 授权流程确认连接状态为 ACTIVE 后再开始运行任何工作流。这套验证 MCP → 建立连接 → 完成授权 → 确认 ACTIVE的四步初始化是仓库中所有 Composio 系技能的统一起点也是排查工具不可用问题的第一诊断路径。四、工具发现RUBE_SEARCH_TOOLS 的正确用法执行任何工作流之前必须用RUBE_SEARCH_TOOLS发现可用工具。技能给出的基础调用形态如下RUBE_SEARCH_TOOLS queries: [{use_case: Smartproxy operations, known_fields: }] session: {generate_id: true}该调用返回四类关键信息可用工具 slug后续执行时tool_slug字段的合法取值来源输入 Schema每个工具的参数名、类型与必填项推荐执行计划针对该 use case 的编排建议已知坑位known pitfalls官方沉淀的易错点提示。两个参数值得展开说明use_case用自然语言描述你本次要完成的具体 Smartproxy 任务如 fetch a rotating residential proxy endpoint搜索越具体返回的工具越精准session首次调用使用generate_id: true让 Rube 生成会话 ID后续调用复用该 ID见第六节会话复用。五、核心工作流发现 → 连接 → 执行技能将标准操作收敛为三步构成一个可循环的闭环。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Smartproxy task}] session: {id: existing_session_id}注意这里使用了上一步生成的既有会话 ID而非重新生成——这是会话复用纪律的具体体现。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [smartproxy] session_id: your_session_id执行前再次确认连接 ACTIVE避免因授权过期或连接被移除导致执行期报错。若返回非 ACTIVE回到第三节的授权流程重新建立连接。Step 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与arguments必须严格来自 Step 1 的搜索结果字段名与类型逐一对齐memory参数必须始终携带即使为空也要传{}支持一次传入多个工具对象实现批量串联执行。整套流程的本质是先取证、再执行Schema 是运行时从搜索中取证的而不是写死在代码里的。六、已知坑位清单六条实战纪律技能文档沉淀了六条高频坑位逐条解读如下永远先搜索工具 Schema 会变化。未经RUBE_SEARCH_TOOLS就硬编码 tool slug 或参数是最大的错误来源。这也是技能 frontmatter 中description反复强调的第一纪律。检查连接执行前必须确认RUBE_MANAGE_CONNECTIONS返回 ACTIVE。连接可能因授权过期、会话失效等原因变为非活跃。Schema 合规字段名与类型必须与搜索结果完全一致多一个字段或少一个字段都可能导致调用失败。Memory 参数RUBE_MULTI_EXECUTE_TOOL调用中必须包含memory即使为空对象{}也不能省略。会话复用同一工作流内复用会话 ID以保持上下文连续性开启全新工作流时才生成新会话 ID。分页处理检查响应中是否有分页 token如有则持续拉取直到数据取完避免遗漏大批量任务结果。这六条纪律中分页最容易被忽略——批量代理操作往往返回多页结果只取第一页会导致任务覆盖不全。七、快速参考五类操作入口速查表技能末尾给出了一张浓缩的操作速查表适用于日常检索与新手快速上手OperationApproachFind toolsRUBE_SEARCH_TOOLSwith Smartproxy-specific use caseConnectRUBE_MANAGE_CONNECTIONSwith toolkitsmartproxyExecuteRUBE_MULTI_EXECUTE_TOOLwith discovered tool slugsBulk opsRUBE_REMOTE_WORKBENCHwithrun_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMASfor tools withschemaRef五个入口的分工逻辑单次调用走RUBE_MULTI_EXECUTE_TOOL批量或远程执行切到RUBE_REMOTE_WORKBENCH通过run_composio_tool()函数在远程工作台内运行深挖 Schema用RUBE_GET_TOOL_SCHEMAS尤其当搜索结果中工具带有schemaRef引用、需要拉取完整定义时。八、源码视角这套技能的仓库级佐证8.1 同构技能族印证了流程的通用性从源码结构看composio-skills/ 目录下数以百计的*-automation/SKILL.md共享完全相同的骨架同样的requires.mcp: [rube]前置声明、同样的四步初始化、同样的三步核心工作流、同样的六条坑位清单。这可以推断Rube MCP 是 Composio 面向 Agent 的统一工具网关smartproxy只是其一枚可插拔的 toolkit。你掌握了本文的流程就等于掌握了整个 composio-skills 家族的用法。8.2 技能安装Skill Installer 的落地方式仓库为技能安装提供了专用脚本 skill-installer/scripts/install-skill-from-github.py。其核心逻辑见_copy_skill、_validate_skill与_default_dest会校验技能目录必须包含SKILL.md文件将技能目录复制到$CODEX_HOME/skills/skill-nameCODEX_HOME未设置时默认~/.codex见_codex_home()校验目标目录不存在后执行复制避免覆盖。安装命令形态以本技能为例python skill-installer/scripts/install-skill-from-github.py \ --repo ComposioHQ/awesome-codex-skills \ --path composio-skills/smartproxy-automation安装完成后重启 Codex新技能即被加载。之后在会话中描述 Smartproxy 自动化任务Codex 便会依据descriptionfrontmatter 自动匹配触发该技能参见 README.md 的手动安装说明。8.3 从源码结构推断的运行前提结合 README.md 对 Composio MCP Gateway 的定位单一 MCP 端点提供 1000 集成、内置认证与访问控制可以推断Rube MCP 正是这一网关的 Agent 侧接入形态RUBE_*系列工具负责搜索、连接管理与执行而 Smartproxy 服务的真实 API 调用由 Composio 侧完成鉴权与代理转发。因此技能侧无需保存任何 Smartproxy 密钥——安全边界在 Composio 网关层收敛。九、小结与适用前提总结本技能的完整闭环接入MCP 客户端添加https://rube.app/mcp无需 API Key初始化RUBE_SEARCH_TOOLS验证可用 →RUBE_MANAGE_CONNECTIONS建立 Smartproxy 连接 → 授权 → 确认 ACTIVE运行发现工具 → 检查连接 → 按 Schema 执行始终携带memory并复用会话 ID兜底遵守先搜索、防分页、查 ACTIVE三条高频纪律。适用前提与限制需要明确本流程依赖 Rube MCP 端点可用、Composio 侧的 Smartproxy 集成在线以及用户完成第三方 OAuth 授权工具 slug 与参数 Schema 以RUBE_SEARCH_TOOLS的实时返回为准本文中的调用形态是技能文档与仓库源码确认的稳定骨架不构成对具体工具参数的承诺。本文基于仓库 composio-skills/smartproxy-automation/SKILL.md 及其同族技能与安装脚本整理编写。【免费下载链接】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），仅供参考