通过 Rube MCP 自动化 Meta Ads 投放awesome-codex-skills 中 metaads-automation 技能实战指南【免费下载链接】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/metaads-automation/SKILL.md 展开讲解如何通过 Rube MCPComposio 的 MCP 网关让 Codex 安全地调用 Meta AdsMeta 广告toolkit完成广告投放相关任务的自动化。读完本文你将掌握 MCP 服务器接入、toolkit 连接状态管理、工具发现与动态执行三个核心能力并学会一套先发现、再连接、后执行的稳健工作流模式。一、技能定位一份让 Codex 自动化 Meta Ads 的指令包在 awesome-codex-skills 仓库中每个技能都是一个独立的文件夹内部以SKILL.md为核心文件通过 YAML frontmatter 中的name与description元数据告诉 Codex何时触发、做什么事。仓库根目录的 README.md 明确指出Codex 读取元数据决定是否触发技能只在触发后才加载正文从而保持上下文精简。metaads-automation技能正是这一模式下的典型代表其 frontmatter 定义如下--- name: metaads-automation description: Automate Metaads tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---解读三个关键信息namemetaads-automation技能的唯一标识安装后对应$CODEX_HOME/skills/metaads-automation/目录description声明技能用途自动化 Meta Ads 任务并特别强调Always search tools first for current schemas——即任何任务执行前必须先搜索最新工具 schema这是整套技能最重要的使用纪律requires.mcp声明该技能强依赖名为rube的 MCP 服务器也就是说没有接入 Rube MCP该技能无法工作。二、前置条件与 Rube MCP 接入技能文档列出的前置条件有三项缺一不可Rube MCP 已连接Codex 会话中必须能调用RUBE_SEARCH_TOOLS这是后续一切操作的探照灯Metaads 连接为 ACTIVE通过RUBE_MANAGE_CONNECTIONS建立并确认 Metaads toolkit 处于 ACTIVE 状态始终先搜索任何工作流执行前都要先调用RUBE_SEARCH_TOOLS获取当前工具 schema。Rube MCP 的接入方式接入 Rube MCP 非常简单——不需要申请任何 API Key在客户端配置中把https://rube.app/mcp添加为 MCP 服务器无需 API Key添加端点即可工作。这一点与仓库中其他 Composio 系列技能完全一致例如 composio-automation/SKILL.md 和 openai-automation/SKILL.md 都使用同一个端点印证了 Rube MCP 是这套技能体系统一的接入网关。建立连接的四步流程接入 MCP 之后按以下顺序完成 Metaads toolkit 的连接初始化确认 Rube MCP 可用调用RUBE_SEARCH_TOOLS看是否正常响应调用RUBE_MANAGE_CONNECTIONS指定 toolkit 为metaads若连接状态不是 ACTIVE按照返回的认证链接完成授权设置在运行任何工作流之前再次确认连接状态显示为 ACTIVE。从源码结构看这一步的本质是 OAuth 式的账号授权RUBE_MANAGE_CONNECTIONS负责创建并管理第三方应用连接返回的 auth link 引导用户完成 Meta 账号授权之后该连接才能在后续工具调用中被复用。三、工具发现永远不要硬编码工具 slugMeta Ads 的 API 工具面toolkit会持续演化工具 slug、输入参数 schema 都可能变化。因此技能规定执行工作流之前必须先发现可用工具。标准发现调用如下RUBE_SEARCH_TOOLS queries: [{use_case: Metaads operations, known_fields: }] session: {generate_id: true}use_case描述你的具体任务场景例如Metaads operations或更精确的任务描述known_fields已知字段首次调用可留空字符串让搜索引擎给出完整建议session.generate_id: true让 Rube 自动生成新的会话 ID用于后续步骤的会话复用。一次成功的调用会返回四类信息可用工具 slugtool slugs后续RUBE_MULTI_EXECUTE_TOOL直接引用的工具标识输入 schema每个工具要求的字段名、类型、必填项推荐执行计划针对该 use case 的建议调用序列已知陷阱known pitfalls官方预先标注的常见错误与注意事项。这一点可以从仓库中同构技能得到印证以 ahrefs-automation/SKILL.md 为例其正文围绕具体工具如AHREFS_RETRIEVE_SITE_EXPLORER_METRICS展开并详细列出参数约束而这些具体工具 slug 正是通过搜索发现环节获得metaads-automation 则刻意保持搜索优先的通用骨架因为 Meta Ads 的广告系列、广告组、广告创意、受众与投放数据等操作面的工具集更大、更易变化硬编码的风险更高。四、核心工作流模式发现 → 检查 → 执行技能文档给出了一套三阶段的标准工作流任何 Meta Ads 自动化任务都应遵循此顺序。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Metaads task}] session: {id: existing_session_id}与初次发现不同这里复用已有会话 IDsession.id因为同一工作流内应保持会话连续性将use_case替换为你的具体任务例如创建新的广告系列并设置预算或拉取最近 30 天的广告投放数据。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [metaads] session_id: your_session_id在真正执行工具前用同一会话 ID 复查metaadstoolkit 的连接是否仍为 ACTIVE。连接可能因 Token 过期、账号权限变更等原因失效这一步是低成本的安全闸门。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必须来自 Step 1 的搜索结果禁止凭记忆硬编码arguments必须严格符合搜索结果返回的 schema字段名、类型、必填项逐一对应memory参数必须始终携带即使为空也要传{}——这是 Rube MCP 的协议约定。五、六大已知陷阱与规避策略技能文档沉淀了六条实战经验逐一展开如下陷阱说明与规避不搜索直接执行工具 schema 会变化。绝不可以在未调用RUBE_SEARCH_TOOLS的情况下硬编码工具 slug 或参数。规避每个新任务、每次会话都从搜索开始。忽略连接状态执行前必须通过RUBE_MANAGE_CONNECTIONS确认连接为 ACTIVE否则工具调用必然失败。规避把连接检查固定为工作流第二步。Schema 不合规必须使用搜索结果中返回的精确字段名和类型大小写、下划线都要逐字对应。规避直接从搜索结果复制字段名。遗漏 memory 参数RUBE_MULTI_EXECUTE_TOOL的调用必须包含memory参数即使没有需要传递的上下文也要传空对象{}。规避把memory: {}当作固定模板。会话 ID 滥用同一工作流内复用会话 ID 以保持上下文新工作流则生成新 IDgenerate_id: true。规避明确区分复用与新建两种场景。忽略分页返回结果可能带分页 Token必须持续读取直到数据取完否则会得到不完整的结果集。规避每次响应都检查分页 Token 并在循环中继续请求。这六条陷阱同样出现在 composio-automation/SKILL.md 等兄弟技能中可以推断它们是 Rube MCP 体系下的通用最佳实践而不仅是 Meta Ads 专属。六、快速参考表技能文档末尾提供了一张操作速查表是日常使用的核心索引操作方法查找工具RUBE_SEARCH_TOOLSuse_case 填写 Metaads 具体任务建立连接RUBE_MANAGE_CONNECTIONStoolkit 指定为metaads执行工具RUBE_MULTI_EXECUTE_TOOL使用发现到的工具 slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS适用于带schemaRef的工具批量操作与完整 schema 的深入说明速查表中的最后两项值得展开RUBE_REMOTE_WORKBENCHrun_composio_tool()当需要批量处理例如对多组广告系列数据做同一种操作时可以在远程 workbench 环境中以编程方式调用run_composio_tool()把重复逻辑封装进脚本循环避免逐条手写RUBE_MULTI_EXECUTE_TOOL调用RUBE_GET_TOOL_SCHEMAS部分工具以schemaRef形式引用外部 schema 定义搜索返回的可能是引用而非完整结构此时需要调用本工具拉取完整 schema 文档确保参数逐项合规。七、安装到 Codex 与触发方式根据仓库 README.md 的说明Codex 技能统一安装在$CODEX_HOME/skills默认~/.codex/skills每个技能一个子目录必须包含带name和descriptionfrontmatter 的SKILL.md。安装方式有两种方式一使用 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/metaads-automation安装脚本会把技能放置到$CODEX_HOME/skills/metaads-automation/然后重启 Codex以加载新元数据。方式二手动拷贝将composio-skills/metaads-automation/目录复制到$CODEX_HOME/skills/重启 Codex在会话中用自然语言描述 Meta Ads 自动化任务Codex 会根据descriptionfrontmatter 自动匹配并触发该技能也可以直接提及技能名metaads-automation。安装完成后可在~/.codex/skills/metaads-automation/SKILL.md中随时查看与维护技能内容由于该技能依赖rubeMCP还需在 Codex 客户端配置中添加https://rube.app/mcp服务器。八、典型自动化场景推演基于技能框架可以推演出以下典型 Meta Ads 自动化流程具体工具 slug 一律以RUBE_SEARCH_TOOLS的实时搜索结果为准投放数据汇总用RUBE_SEARCH_TOOLS搜索拉取 Meta Ads 广告系列投放指标发现对应工具 → 检查metaads连接 → 执行工具拉取指定时间窗口的数据 → 检查分页并合并完整结果广告系列批量创建发现创建类工具与对应参数 schema → 复用会话 → 通过RUBE_MULTI_EXECUTE_TOOL或RUBE_REMOTE_WORKBENCH批量提交预算、受众、创意等参数均以 schema 为准状态巡检与报告周期性检查连接 ACTIVE 状态拉取最新数据并生成结构化报告全程遵循发现 → 检查 → 执行三步骨架。需要强调的是Meta Ads toolkit 的具体工具面广告系列管理、广告组、创意、受众、投放洞察等及其 slug 均由 Composio 官方 schema 动态维护本文与技能文档一致不建议也无法在此列出固定工具 slug——这正是Always search tools first存在的意义。总结metaads-automation技能展示了 awesome-codex-skills 中 Composio 系列技能的统一范式以 Rube MCP 作为零配置接入网关用RUBE_SEARCH_TOOLS保持对动态 schema 的强感知用RUBE_MANAGE_CONNECTIONS守护认证状态用RUBE_MULTI_EXECUTE_TOOL完成原子执行再辅以会话复用、memory 参数、分页处理等纪律性约定。掌握这套模式你不仅可以自动化 Meta Ads 操作还能无缝迁移到仓库中 composio-skills 下数百个同构的第三方服务自动化技能如 ahrefs-automation、openai-automation形成一套可复用的 AI Agent 外部工具接入方法论。【免费下载链接】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），仅供参考