用途:这是一个 Medusa Commerce 集成技能。Medusa Commerce 是开源的无头电商平台,开发者与商家用它构建可定制的在线商店、市场和电商应用。当用户希望与其 Medusa Commerce 数据交互时(管理数据、记录并自动化工作流),可使用本技能。官方文档:https://docs.medusajs.com/
可管理的数据对象包括:Customer、Customer Group、Product、Product Category、Product Collection、Product Type、Product Option、Product Variant、Order、Shipping Option、Discount、Price List、Gift Card、Region、Currency、Store、Sales Channel、Fulfillment Provider、Payment Provider、Tax Provider、Return Reason、Shipping Profile、User。
使用方式:本技能通过 Membrane CLI 与 Medusa Commerce 交互,Membrane 自动处理认证与凭证刷新。先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,agentType 可用 claude、openclaw、codex、warp、windsurf 等。无界面环境会打印授权 URL,用户完成登录后执行 membrane login complete <code>。任意命令加 --json 可获得机器可读输出。
建立连接:membrane connection ensure "https://www.medusajs.com/" --json,用户在浏览器完成认证,输出包含新连接 id。若连接处于 BUILDING 状态,用 npx @membranehq/cli connection get <id> --wait --json 轮询直至就绪。状态含义:READY 可直接使用;CLIENT_ACTION_REQUIRED 需用户或代理处理(type 为 connect 表示需认证,provide-input 表示需补信息);CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错,查看 error 字段。
查找与运行动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 搜索动作,结果含 id、name、description、inputSchema、outputSchema。运行:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参可加 --input '{"key": "value"}',结果在响应的 output 字段。
代理请求:当现有动作不覆盖需求时,可通过 Membrane 代理直接访问 Medusa Commerce API:membrane request CONNECTION_ID /path/to/endpoint,Membrane 自动拼接基础 URL 并注入认证头、必要时透明刷新凭证。常用选项:-X/--method、-H/--header(可重复)、-d/--data、--json(发送 JSON 体并设 Content-Type)、--rawData、--query(可重复)、--pathParam(可重复)。
限制与最佳实践:优先使用 Membrane 与外部应用通信(预置动作带认证、分页与错误处理);先搜索再自建;不要让用户提供 API 密钥或令牌,而应创建连接。资料未提供具体收费、价格与可用动作清单等细节。