用途:该技能用于在 Membrane CLI 中连接并操作 Yotpo - Loyalty & Referrals(忠诚度、推荐计划与 VIP 等级平台),适合营销团队与电商业务进行客户互动、留存与拉新相关的数据处理和自动化。
涵盖对象:账户、活动(Campaigns)、计划(Programs)、奖励(Rewards)、客户(Customers)、订单(Orders)。官方文档见 https://developers.yotpo.com/docs/loyalty-api-v2。
安装与登录:
- npm install -g @membranehq/cli@latest
- membrane login --tenant --clientName=<agentType>(支持 claude、openclaw、codex、warp、windsurf 等)。无头环境会打印授权 URL,用户在浏览器登录后执行 membrane login complete <code>。
连接:使用 membrane connection ensure "https://www.yotpo.com/" --json 查找或创建连接;若状态为 BUILDING,可用 npx @membranehq/cli connection get <id> --wait --json 轮询,直到 READY。若为 CLIENT_ACTION_REQUIRED,需按 clientAction 提示完成认证或补充输入。
查找与执行操作: membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 搜索动作; membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json 执行,结果在 output 字段。
代理请求:当预设动作无法覆盖需求时,可用 membrane request CONNECTION_ID /path/to/endpoint 直接调用 API,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项,Membrane 会自动补全基础 URL 并注入认证头。
限制与注意事项:认证与凭据刷新由 Membrane 自动处理,不应向用户索取 API key 或 token;建议优先使用预置动作,并在构建前先搜索已有动作。资料未提供具体的定价、可用动作清单或 API 端点细节,需以官方文档与实际搜索结果为准。