让 Codex 自动跑亚马逊业务:Rube MCP + Composio 实战指南
【免费下载链接】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 仓库里有个现成的 Amazon 自动化 skill,接上 Rube MCP 之后,Codex Agent 就能直接执行亚马逊商品查询、订单拉取这些业务操作。从接入 Composio Amazon 工具集、发现工具 schema,到发起真实 API 调用,整条 Codex 自动化链路都在下面拆给你看。
痛点:手动查亚马逊订单有多烦
你在亚马逊上有在售商品,每天要进卖家后台翻一遍新订单,售后还得导出退货数据手工整理。这些操作重复、枯燥,但又必须天天有人干。自然的想法就是让 Agent 来干——可 Codex 默认只能「说」,它能帮你写查询脚本,却摸不到亚马逊的 API。这个 skill 补的正是这最后一块拼图。
跑通效果:Codex Agent 能干什么
Codex 接入 Amazon 工具集之后,你跟它说话就行:「帮我查亚马逊上无线键盘的在售商品,整理成表」,它自己调商品搜索接口把结果带回来;「把昨天的订单拉下来,统计一下状态分布」,它取完列表按状态汇总后直接给你结论。重点不是它生成更漂亮的建议文本,而是真的发起了 API 调用、拿回真实数据——这跟普通聊天机器人是两回事。
三步接入 Rube MCP
接入过程只有三个关键动作。
先加端点。Rube MCP 是一个统一网关(MCP 是 Agent 调用外部工具的标准协议),在客户端的 MCP 配置里添一个端点就行:
https://rube.app/mcp不需要任何 API Key,加上之后RUBE_*系列工具全部可用。
再建连接。调用RUBE_MANAGE_CONNECTIONS,toolkit 传amazon。如果返回的状态不是 ACTIVE,就按响应里给的授权链接在浏览器完成 OAuth,连接会持久化,后续会话直接复用。
最后确认一次:状态显示 ACTIVE,才能去跑任何亚马逊订单自动化工作流。这一步是执行前的最后防线。
Rube MCP 与 Composio 的分工讲清楚
机制理顺了,后面看什么都不晕。分工很干净:Rube MCP 是网关,统一暴露RUBE_*系列工具;Composio 的 Amazon toolkit 封装了亚马逊真实的业务 API。Agent 不用关心 OAuth 细节,连接建好后只管调度工具。
触发逻辑藏在 SKILL.md 的 frontmatter 里:name是 skill 的唯一标识,安装后就是~/.codex/skills下的目录名;description是触发依据,当你的请求命中「Amazon 自动化」这类描述时,Codex 才决定加载正文;requires.mcp则声明必须先接好名为 rube 的 MCP。Codex 只读前两个字段决定是否触发、触发后才读完整正文,上下文因此保持很精简。
Rube MCP 工具调用流程:一次完整的商品搜索
以「搜索某类商品」为例,整条链路是三次连续调用。
第一段是RUBE_SEARCH_TOOLS,use_case 填「search Amazon products」之类的描述,同时把session.generate_id设为 true,为这个工作流生成会话 ID。返回里带四样东西:可用工具 slug 列表、每个工具的输入 schema、推荐执行计划、已知坑点。你要的商品搜索工具 slug 就取自这里,参数也照返回的 schema 原样填。
第二段是RUBE_MANAGE_CONNECTIONS,toolkits 传["amazon"],session_id 用第一段拿到的,确认连接还是 ACTIVE。几秒钟的保险,避免执行到一半才发现连接失效。
第三段才是真正执行,RUBE_MULTI_EXECUTE_TOOL:
RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: "来自第一段搜索结果", arguments: { keywords: "wireless keyboard", limit: 10 } }] memory: {} session_id: "第一段生成的会话ID"这里容易踩坑:memory必须每次都带,空的就传{}。我最初就是漏了它,整个调用直接被拒,排查了半天才定位到。同一工作流要调多个工具时,在tools数组里一次排进去即可;如果搜索结果里的工具带schemaRef,用RUBE_GET_TOOL_SCHEMAS拉完整 schema,防止截断信息让你填错参数。
三个真实踩坑场景
一次 schema 漂移。有次调用一直正常的参数,某天突然报错。翻搜索结果才发现上游改了参数名,schema 已经是新版。教训就一条:schema 会演进,slug 和参数名凭记忆硬编码是这类自动化失败的大头,执行前先用RUBE_SEARCH_TOOLS对一遍。
一次没复查连接。有回直接跑订单拉取工作流,结果一堆无效调用,原因是连接状态变了而我没有复查。代价不在报错本身,而在你发现之前白烧的调用量。执行前先确认 ACTIVE,这个习惯值得保留。
一次会话与分页。同一工作流里复用会话 ID 保持上下文连续,开新工作流才生成新会话;拉订单列表时,响应里带分页 token 就要接着拉,直到数据完整——中途停下会静默丢数据,而且不会报任何错。
Codex skill 安装验证与延伸阅读
仓库里有 800 多个 composio-skills,composio-automation 和这个 skill 完全同构,换个 toolkit 就能套到别的应用上;不想走 MCP 的话,connect 给了 CLI 路径,两条路子可以对照着看能力边界。
想把 skill 装进本地 Codex,clone 仓库后跑安装脚本:
git clone https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py \ --repo ComposioHQ/awesome-codex-skills --path composio-skills/amazon-automation目标目录已存在时脚本会中止以防覆盖。装完重启 Codex 让它加载新 skill,再ls ~/.codex/skills看一眼安装结果,验证闭环就齐了。
守住「先查 schema、再查连接、参数严格照抄」这个节奏,你就能在 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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考