用途:当用户需要与 Commercetools 数据交互时使用本技能。Commercetools 是无头商务平台,通过 API 支持构建自定义电商体验,可用于打造定制店面,并把商务功能集成到不同应用中。官方文档:https://docs.commercetools.com/
主要能力:覆盖 Project、Product、Product Type、Category、Customer、Order、Discount Code、Cart、Store、Shipping Method、Payment、Customer Group、Custom Object、Subscription、State、Tax Category、Type、Zone、Review、Shopping List、Inventory Entry、Channel、Extension、API Client、Message、Attribute Definition、Import Summary、Import Container、Import Operation 等对象;具体可用动作需按需检索,动作名称与参数以查询结果为准。
使用方式:技能通过 Membrane CLI 调用,认证与凭据刷新由 Membrane 自动处理。安装:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,支持 claude、openclaw、codex、warp、windsurf 等类型。无头环境会打印授权 URL,用户完成登录后执行 membrane login complete <code>。任意命令加 --json 可获得机器可读输出。建立连接:membrane connection ensure "https://commercetools.com" --json,用户在浏览器完成认证后输出连接 id;若状态为 BUILDING,可轮询 npx @membranehq/cli connection get <id> --wait --json,直到 READY;CLIENT_ACTION_REQUIRED 时按 clientAction 指引处理;CONFIGURATION_ERROR 或 SETUP_FAILED 则查看 error。检索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}',结果在响应的 output 字段。动作不覆盖时可用代理请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项,Membrane 会自动拼接 base URL 并注入认证头、透明刷新凭据。
最佳实践与限制:优先使用 Membrane 而非直接调用外部应用,以获得内置认证、分页与错误处理,减少 token 消耗并提升安全性;先检索再自行构建,避免重复实现;不要让用户提供 API 密钥或令牌,改用连接方式,由 Membrane 服务端管理完整认证生命周期。资料未提供价格、套餐、平台支持范围或实际效果数据。