Awesome Codex Skills 实战通过 Composio MCP 用自然语言自动化 Instantly 冷邮件外展【免费下载链接】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 仓库中的 Instantly Automation 技能 展开。该技能让 Codex 通过 Composio MCP 集成以自然语言驱动 Instantly 冷邮件外展平台覆盖营销活动campaign的创建与修改、发送账户sending accounts管理、潜在客户列表lead lists批量导入以及活动数据分析。读完本文你将掌握该技能的安装配置流程、全部 6 个核心工作流的工具用法与关键参数理解其底层的 Rube MCP 工具发现机制并规避时区、调度载荷、序列完整性等已知坑点可直接在 Codex 会话中落地一套完整的冷邮件外展自动化。技能概览它在仓库中的定位与触发方式Instantly Automation 是composio-skills/目录下以 SKILL.md 形式组织的众多技能之一。其文件头部 frontmatter 定义了技能元数据参见 SKILL.md--- name: Instantly Automation description: Automate Instantly cold email outreach -- manage campaigns, sending accounts, lead lists, bulk lead imports, and campaign analytics -- using natural language through the Composio MCP integration. category: email-outreach requires: mcp: - rube ---按仓库 README.md 中Using Skills in Codex一节的说明Codex 技能的触发机制基于description元数据描述越精确Codex 越能在用户提出自然语言任务时自动选中该技能。本技能属于email-outreach邮件外展类别声明依赖rube这个 MCP 服务器——它正是 Composio 提供的统一 MCP 端点后续所有 Instantly 工具调用都经由它转发。技能安装在$CODEX_HOME/skills/默认~/.codex/skills/可以使用 skill-installer 的脚本 install-skill-from-github.py 一键安装也可以手动把instantly-automation文件夹复制到 skills 目录后重启 Codex。安装或更新后必须重启 Codex它才会重新加载技能元数据。环境搭建接入 Rube MCP 并连接 Instantly本技能的前置条件只有一个核心让 Codex 客户端能访问 Composio 的 MCP 服务器。Setup 分为三步添加 MCP 服务器在客户端配置中加入 Composio MCP 端点https://rube.app/mcp连接 Instantly 账户按提示完成授权认证方式为 InstantlyAPI key。开始下达自然语言指令此后即可用日常语言管理外展营销活动。从仓库中同目录的 composio-automation 技能 可以看到 Rube MCP 的完整运行模式连接后应先用RUBE_SEARCH_TOOLS验证可用性再通过RUBE_MANAGE_CONNECTIONS确认连接状态为ACTIVE最后才用RUBE_MULTI_EXECUTE_TOOL执行具体工具。Instantly 技能正是建立在这套机制之上的——它把工具调用抽象成自然语言而底层仍然是先发现工具、再校验连接、后执行调用的 Rube 流程。核心工作流详解技能文档定义了 6 个核心工作流覆盖了 Instantly 外展管理的主干操作。1. 列出发送账户List Sending Accounts检索工作区中已配置的所有邮箱账户支持按状态和提供商过滤。工具INSTANTLY_LIST_ACCOUNTS示例指令Show all active sending accounts in my Instantly workspace关键参数参数说明status按状态过滤1Active 活跃、2Paused 暂停、-1Connection Error 连接错误、-2Soft Bounce Error 软退信错误、-3Sending Error 发送错误provider_code按提供商过滤1Custom IMAP/SMTP 自建、2Google、3Microsoft、4AWSsearch按邮箱子串或域名搜索limit最大返回条数1–100starting_after分页游标取自上一条响应tag_ids逗号分隔的标签 UUID 列表该工具是其他写操作的前置依赖创建营销活动时email_list必须引用已配置的发送账户地址而账户地址正是通过本工具发现的。2. 创建营销活动Create a Campaign启动一个新的外展活动支持调度、邮件序列、A/B 测试变体与发送配置。工具INSTANTLY_CREATE_CAMPAIGN示例指令Create an Instantly campaign called Q1 Outreach that sends Monday-Friday 9am-5pm Central time with a 3-step email sequence关键参数name必填—— 活动名称campaign_schedule必填—— 调度配置schedules必填—— 调度对象数组每个对象包含name—— 调度名称timing——{from: 09:00, to: 17:00}HH:mm 格式days—— 将星期索引字符串0周日到6周六映射为布尔值的对象timezone—— 支持的时区值包括America/Chicago、America/Detroit、America/Boise、America/Anchorage等start_date/end_date—— ISO 8601 格式日期email_list—— 发送账户邮箱地址数组必须是预先配置好的账户用INSTANTLY_LIST_ACCOUNTS发现有效地址sequences—— 数组仅第一个元素生效包含steps—— 步骤对象数组每步包含type—— 必须是emaildelay—— 距下一封邮件的天数整数最小 0variants——{subject, body}对象数组用于 A/B 测试daily_limit—— 每日发送上限email_gap—— 两封邮件之间的间隔分钟数stop_on_reply—— 潜在客户回复时停止活动布尔值stop_on_auto_reply—— 自动回复时停止布尔值open_tracking/link_tracking—— 开启打开/链接跟踪布尔值时区注意事项易错点已验证可用America/Chicago中部、America/Detroit东部、America/Boise山地自动映射America/New_York会被映射到America/DetroitAmerica/Denver会被映射到America/Boise不受支持America/Los_Angeles、US/Pacific—— 需改用America/Anchorage或America/Dawson作为替代值得注意sequences数组仅第一个元素生效这一行为——它意味着如果需要多步邮件序列必须全部写在sequences[0].steps中而不是拆分成多个 sequence 对象。3. 更新活动设置Update Campaign Settings修改既有活动的调度、发送上限、序列或跟踪设置。工具INSTANTLY_UPDATE_CAMPAIGN示例指令Update my Instantly campaign to increase the daily limit to 100 and enable open tracking关键参数id必填—— 活动 UUID以下参数任意组合name、campaign_schedule、email_list、sequences、daily_limit、email_gap、stop_on_reply、open_tracking、link_tracking等将任一参数设为null即可取消该设置该工具通常配合第 5 节INSTANTLY_GET_CAMPAIGN使用先读取活动当前完整配置再针对性地做增量修改。4. 管理潜在客户列表与批量导入Lead Lists and Bulk Import为活动创建专门的潜在客户列表并批量导入目标客户。工具INSTANTLY_CREATE_LEAD_LIST、INSTANTLY_ADD_LEADS_BULK示例指令Create a lead list called Q1 Prospects and add 50 leads to my Instantly campaign创建客户列表的关键参数列表名称与配置。批量导入潜在客户的关键参数导入目标活动campaign或列表listID潜在客户对象数组包含邮箱email与元数据metadata重复数据处理选项duplicate handling潜在客户验证设置lead verification批量导入是把获客与触达衔接起来的关键环节先用客户列表沉淀目标人群再在活动中引用这些列表进行发送。5. 查看活动详情Review Campaign Details获取活动完整配置用于核对设置、检查序列或为后续更新做准备。工具INSTANTLY_GET_CAMPAIGN示例指令Show me the full details of my Instantly campaign关键参数id必填—— 活动 UUID。一个重要的防御性提示响应中的字段名可能与创建时的载荷字段名不一致例如timing.from_与timing.from解析返回数据时应做容错处理详见下文已知陷阱。6. 列出所有活动List All Campaigns枚举工作区中的所有活动支持可选过滤与分页。工具INSTANTLY_LIST_CAMPAIGNS示例指令List all my Instantly campaigns关键参数可选的过滤与分页参数。底层原理Rube MCP 与先发现、后执行范式本技能表面上是一组自然语言工作流其底层执行链路值得展开说明。从 composio-automation 技能 可以看到所有 Instantly 工具INSTANTLY_*前缀的 slug都经由 Rube MCP 端点分发标准执行范式为发现工具调用RUBE_SEARCH_TOOLS携带use_case查询获取当前可用的工具 slug、输入 schema 与推荐执行计划。技能文档强调工具 schema 会变化绝不硬编码 slug 或参数。校验连接调用RUBE_MANAGE_CONNECTIONS确认对应 toolkit 的连接状态为ACTIVE否则按返回的授权链接完成设置。执行调用通过RUBE_MULTI_EXECUTE_TOOL按 schema 传参执行调用时始终携带memory参数即使为空{}并在同一工作流内复用session_id新工作流再生成新 ID同时关注响应中的分页令牌直到取完所有数据。这套机制意味着Instantly 技能文档中列出的工具 slug 与参数是当前可用的最佳实践快照而实际运行时 Codex 会先经过 Rube 的工具发现拿到最新的 schema。这与 README.md 中Skills tell your agent how to work; an MCP Gateway gives it secure access to the tools it needs的理念一致——技能负责方法论MCP 网关负责连接与鉴权。已知陷阱与规避策略技能文档沉淀了 7 条实战中反复出现的坑对任何要稳定运行该技能的开发者都值得逐条对照时区支持有限Instantly API 只接受受限的时区字符串集合太平洋时区America/Los_Angeles不受支持。改用America/AnchorageUTC-9/UTC-8或America/Dawson全年 UTC-7作为替代。无效调度载荷导致 400 错误campaign_schedule结构不完整缺少days、from、to或schedules会触发 HTTP 400。反复出现 400 说明是载荷问题而非瞬时故障——不要盲目重试先修载荷。序列必须完整每个序列步骤都需要合法的typeemail、delay以及至少一个同时包含subject和body的变体。不完整的变体会阻塞活动创建。只有第一个序列元素生效API 仅处理sequences[0]多余的 sequence 会被忽略。多步序列应全部放入第一个元素的steps中。email_list 必须引用已存在账户email_list字段要求的是工作区中预先配置好的发送账户邮箱地址而不是任意收件人地址。始终先用INSTANTLY_LIST_ACCOUNTS发现合法发送地址。创建活动时的 401 scope 错误活动创建可能报Invalid scope. Required: campaigns:create。这是 API key 权限不足需先在 Instantly 后台更新 key 权限后再重试写操作。读回字段名可能不同INSTANTLY_GET_CAMPAIGN响应中的字段名可能与创建载荷不同如timing.from_与timing.from。解析时应做防御性处理。快速参考表下表汇总了全部动作、工具 slug 与必填参数便于在 Codex 会话中快速查阅动作工具 Slug必填参数列出发送账户INSTANTLY_LIST_ACCOUNTS无可选过滤条件创建活动INSTANTLY_CREATE_CAMPAIGNname、campaign_schedule更新活动INSTANTLY_UPDATE_CAMPAIGNid查看活动详情INSTANTLY_GET_CAMPAIGNid列出活动INSTANTLY_LIST_CAMPAIGNS无可选过滤条件创建客户列表INSTANTLY_CREATE_LEAD_LIST列表名称批量导入潜在客户INSTANTLY_ADD_LEADS_BULK活动/列表 ID、潜在客户数据完整落地示例从零跑通一轮外展将上文内容串成一条可执行的完整链路结合 Instantly Automation 技能 的编排方式发现账户List all my sending accounts→ 得到可用发送地址。建活动Create an Instantly campaign called Q1 Outreach that sends Monday-Friday 9am-5pm Central time with a 3-step email sequence→ 指定调度、序列含 A/B 变体与发送账户。备客户Create a lead list called Q1 Prospects and add 50 leads to my Instantly campaign→ 建立列表并批量导入。校验配置Show me the full details of my Instantly campaign→ 核对读回字段注意timing.from_类差异。按需调整Update my Instantly campaign to increase the daily limit to 100 and enable open tracking→ 增量修改发送上限与跟踪开关。期间若遇 400优先检查campaign_schedule完整性若遇 401 的campaigns:createscope 错误回到 Instantly 后台补权限时区参数优先使用文档验证过的America/Chicago、America/Detroit、America/Boise。掌握这套流程后即可用一句自然语言完成过去需要在 Instantly 后台多点操作的外展管理任务。【免费下载链接】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），仅供参考