
用 Codex Skills 自动化 Gumroad 店铺基于 Composio 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本篇技术指南以开源仓库 awesome-codex-skills 中收录的 Gumroad 自动化技能 为骨架系统讲解如何通过 Codex CLI/API 以自然语言驱动 Gumroad 店铺的日常运营列出产品、按条件追踪销售、校验许可证、订阅实时 Webhook。读完本文你将掌握该技能的全部工具用法、参数语义、已知陷阱以及如何将其接入你自己的 Codex 环境完成端到端配置。技能定位一个面向电商场景的 Codex Skill该技能在仓库中被归类为category: e-commerce其 frontmatter 声明如下name: Gumroad Automation description: Automate Gumroad product management, sales tracking, license verification, and webhook subscriptions using natural language through the Composio MCP integration. category: e-commerce requires: mcp: - rube从元数据可以读出三层关键信息触发方式Codex 依据description判断何时加载该技能。当你在会话中表达管理我的 Gumroad 产品查看某笔销售验证某个许可证等意图时Codex 会自动匹配此技能底层通道requires.mcp声明该技能依赖名为rube的 MCP 服务器——所有 Gumroad 工具调用都经由这一 MCP 端点完成能力边界技能聚焦四类操作——产品列表、销售查询、许可证校验、Webhook 订阅不涉及商品创建与编辑等其他后台功能。仓库 README 对 Codex Skills 的定义可以佐证这一机制技能是模块化指令包SKILL.md中的元数据决定何时触发正文只在触发后才被加载以保持上下文精简。也就是说本文介绍的技能是告诉 Codex 怎么做而真正的工具执行能力来自 Composio MCP 集成。环境准备安装技能并接通 Rube MCP第一步安装技能到 Codex该技能位于仓库 composio-skills/gumroad-automation 目录。推荐使用仓库自带的 skill-installer 一键安装git clone https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills.git cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py \ --repo GitHub_Trending/aw/awesome-codex-skills \ --path composio-skills/gumroad-automation安装器会将技能放入$CODEX_HOME/skills/skill-name默认~/.codex/skills。也可以手动操作把composio-skills/gumroad-automation目录整体复制到~/.codex/skills/下然后重启 Codex 使其加载新元数据。安装完成后可用ls ~/.codex/skills与head ~/.codex/skills/gumroad-automation/SKILL.md验证。第二步接入 Rube MCP 服务器技能依赖的rubeMCP 端点是https://rube.app/mcp在 Codex 的客户端配置中把它添加为一个 MCP server 即可无需预先申请 API Key。仓库中同属 Composio 系列的 composio-automation 技能 对这套连接流程给出了更细的验证步骤可交叉参考添加 MCP 端点后确认RUBE_SEARCH_TOOLS工具可响应用于发现当前可用的工具 slug 与输入 schema通过RUBE_MANAGE_CONNECTIONS检查连接状态若连接不是 ACTIVE则跟随返回的授权链接完成认证确认状态为 ACTIVE 后再执行任何工作流。第三步连接 Gumroad 账户在授权环节选择 Gumroad 的API key 认证该技能采用 API key 而非 OAuth。完成连接后即可在会话中直接下达自然语言指令。核心工作流详解技能封装了 5 个工具调用覆盖 Gumroad 后台最常用的只读管理与订阅操作。下面逐个展开参数语义与用法。1. 列出全部产品GUMROAD_LIST_PRODUCTS用途拉取当前认证账户下的全部产品获取product_id供后续操作使用——它是许可证校验、销售过滤等几乎所有下游操作的入参来源。示例提示词List all my Gumroad products参数无需任何参数返回认证账户的全量产品列表。建议首次接入时先执行本操作确认账户连通性并建立产品 ID 索引。2. 带过滤条件追踪销售GUMROAD_GET_SALES用途按时间范围、客户邮箱、产品维度检索成功销售记录。示例提示词Show me all Gumroad sales from January 2025 for product prod_ABC123关键参数全部可选未传即不过滤参数类型说明示例afterISO8601 字符串只返回该时间点之后的销售2025-01-01T00:00:00ZbeforeISO8601 字符串只返回该时间点之前的销售2025-02-01T00:00:00Zemail字符串按客户邮箱精确过滤buyerexample.comproduct_id字符串按产品 ID 过滤prod_ABC123page整数分页页码最小为 12注意after/before必须使用ISO8601 完整格式含时区Z后缀不能传2025-01-01这种纯日期字符串否则过滤器不会按预期生效。分页从page1开始需要遍历完整销售记录时必须递增page持续拉取直到返回页中没有更多数据。3. 校验许可证密钥GUMROAD_VERIFY_LICENSE用途验证某个许可证密钥是否对指定产品有效同时可查看/递增该许可证的使用次数或确认会员权益membership entitlement是否有效。示例提示词Verify license key ABCD-EFGH-IJKL-MNOP for product prod_ABC123关键参数全部必填参数类型说明product_id字符串要校验的产品 ID。2023 年 1 月 9 日及之后创建的产品必须传此参数更早的产品可不传但仍建议显式提供license_key字符串许可证密钥字符串例如ABCD-EFGH-IJKL-MNOPincrement_uses_count布尔值是否在本次校验时递增该许可证的使用计数默认trueincrement_uses_count是典型的副作用开关如果你只是做例行校验例如用户请求验证激活应让 Codex 将其设为false避免每次查询都消耗/污染使用次数计数如果确实是一次新的激活校验保持默认true则符合 Gumroad 的激活语义。4. 订阅实时 Webhook 事件GUMROAD_SUBSCRIBE_TO_RESOURCE用途将你的端点 URL 订阅到指定 Gumroad 资源事件实现实时事件通知——例如每当产生一笔新销售就向你的服务器推送 HTTP POST。示例提示词Subscribe my webhook https://example.com/hook to Gumroad sale events关键参数全部必填参数类型说明resource_name枚举字符串事件类型共 8 种sale、refund、dispute、dispute_won、cancellation、subscription_updated、subscription_ended、subscription_restartedpost_urlURL 字符串接收 HTTP POST 通知的端点地址例如https://example.com/hook8 种事件类型覆盖了从一次性销售sale/refund、争议处理dispute/dispute_won、取消cancellation到订阅生命周期subscription_updated/subscription_ended/subscription_restarted的完整业务链路。订阅后务必确保你的post_url能正确处理并尽快应答 Gumroad 的 POST 请求。5. 列出已有 Webhook 订阅GUMROAD_GET_RESOURCE_SUBSCRIPTIONS用途按资源类型列出当前生效的 webhook 订阅用于在新增订阅前检查去重。示例提示词Show all my active Gumroad webhook subscriptions for sale events关键参数必填参数类型说明resource_name枚举字符串与订阅工具相同的 8 种事件类型之一例如sale、refund操作速查表以下表格完整继承自技能文档作为日常调用的快速索引操作工具 Slug必填参数列出产品GUMROAD_LIST_PRODUCTS无获取销售GUMROAD_GET_SALES无过滤参数全部可选校验许可证GUMROAD_VERIFY_LICENSEproduct_id、license_key订阅事件GUMROAD_SUBSCRIBE_TO_RESOURCEresource_name、post_url列出 Webhook 订阅GUMROAD_GET_RESOURCE_SUBSCRIPTIONSresource_name已知陷阱与规避方法技能文档明确标注了 4 类高频踩坑点按严重程度排序如下许可证校验必须传product_id2023 年 1 月 9 日之后创建的产品GUMROAD_VERIFY_LICENSE必须携带product_id否则校验会失败。对旧产品虽可省略但官方建议始终显式传入以保证行为一致销售结果分页GUMROAD_GET_SALES默认返回分页结果。判断是否还有后续页时应递增page参数继续拉取直到某页数据为空Webhook 订阅去重同一个资源类型重复订阅会产生重复推送。正确流程是先用GUMROAD_GET_RESOURCE_SUBSCRIPTIONS查询现有订阅确认不存在后再调用GUMROAD_SUBSCRIBE_TO_RESOURCE日期必须使用 ISO8601after/before过滤器仅接受如2025-01-01T00:00:00Z的完整格式传纯日期字符串不会得到预期过滤效果。在 Codex 中的端到端工作流编排结合 connect 技能 与 connect-apps 技能 所展示的 Composio 工作模式Gumroad 自动化技能可以嵌入更长的多步骤流水线。典型编排示意如下场景 A每日销售简报GUMROAD_GET_SALES传入after昨日零点拉取当日销售Codex 汇总订单号、金额、客户邮箱输出结构化简报。场景 B许可证激活校验面向用户自助激活用户提供license_key与product_idGUMROAD_VERIFY_LICENSE校验有效性并设置increment_uses_count为true一次真实激活校验失败或次数异常时Codex 依据返回信息提示用户联系客服。场景 CWebhook 体系初始化GUMROAD_GET_RESOURCE_SUBSCRIPTIONS枚举现有订阅分别查询sale、refund、subscription_updated等类型对缺失的事件类型逐个调用GUMROAD_SUBSCRIBE_TO_RESOURCE补齐最终再查询一遍全部订阅形成配置清单。与仓库生态的关系该技能属于仓库 composio-skills 系列——一个通过 Composio MCP 通道批量接入第三方 SaaS 工具的技能集合。它的运行时依赖与其他同类技能完全一致requires.mcp: [rube]因此安装方式统一均可通过 skill-installer 或手动复制到~/.codex/skills/完成部署连接链路统一均通过https://rube.app/mcp端点 账户级 API key/OAuth 认证接入composio-automation 中RUBE_SEARCH_TOOLS/RUBE_MANAGE_CONNECTIONS的连接检查流程同样适用于本技能使用范式统一自然语言描述任务 → Codex 依据技能 description 自动触发 → 选择合适的工具 slug 并填充参数执行。如果你需要更细粒度的工具 schema 校验或想探索 Gumroad 之外的更多工具邮件、CRM、支付等可以参阅 connect 技能 中的composio execute --get-schema、--dry-run等调试手段——这套方法论对 Gumroad 系列工具同样成立。结语Gumroad Automation 技能把高频但琐碎的店铺运营操作封装成了 5 个可通过自然语言触发的工具调用配合 Rube MCP 的无密钥接入方式一个会话内即可完成从查产品到验许可证再到订阅实时通知的完整闭环。使用时的三条纪律值得牢记许可证校验永远带上product_id、日期过滤永远用 ISO8601、订阅 Webhook 前永远先查重——记住这三点你就能把该技能稳定地跑在生产环境中。【免费下载链接】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),仅供参考