SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场cloudcart

cloudcart

办公与效率

查看项目

更新于 10-16 02:12

技能介绍

用途

CloudCart 是一个电商平台，允许企业创建和管理在线商店，提供商品管理、订单处理、营销和客户关系管理工具，主要被希望在线销售产品的中小型企业使用。本技能用于与 CloudCart 数据交互，管理数据、记录并自动化工作流。

官方文档：https://help.cloudcart.com/en/

主要能力

该技能通过 Membrane CLI 与 CloudCart 交互，Membrane 自动处理身份验证和凭证刷新。可操作的对象包括：商品（Product）、变体（Variant）、订单（Order）、客户（Customer）、分类（Category）、供应商/品牌（Vendor）。

常用操作（action）包括：

  • 列表类：List Products、List Orders、List Customers、List Categories、List Vendors，均返回分页列表。
  • 获取单个：Get Product、Get Order、Get Customer、Get Category、Get Vendor，按 ID 检索单条记录。
  • 创建：Create Product、Create Order、Create Customer、Create Category、Create Vendor。
  • 更新：Update Product、Update Order、Update Customer、Update Category、Update Vendor。

每个操作结果包含 id、name、description、inputSchema（接受的参数）和 outputSchema（返回内容）。

使用方式

  1. 安装 CLI：

npm install -g @membranehq/cli@latest

  1. 身份验证：

membrane login --tenant --clientName=<agentType>

该命令会打开浏览器进行验证，或在控制台打印授权 URL（取决于是否支持交互模式）。无头环境下会打印授权 URL，请用户用浏览器打开，完成登录后看到验证码，再执行：

membrane login complete <code>

任意命令加 --json 可获得机器可读的 JSON 输出。agentType 可选 claude、openclaw、codex、warp、windsurf 等，用于针对不同运行环境调整工具。

  1. 连接 CloudCart：

membrane connection ensure "https://cloudcart.com/" --json

用户在浏览器中完成身份验证，输出包含新的 connection id。若返回的连接状态为 READY，可直接跳到下一步。若状态为 BUILDING，则轮询等待：

npx @membranehq/cli connection get <id> --wait --json

--wait 会长时间轮询（最长 --timeout 秒，默认 30），直到状态改变。状态含义：READY 表示连接已就绪；CLIENT_ACTION_REQUIRED 表示用户或代理需要执行操作，clientAction.type 为 "connect"（需验证）或 "provide-input"（需补充信息），clientAction.description 为说明，clientAction.uiUrl（可选）为可完成操作的预构建 UI，clientAction.agentInstructions（可选）为代理操作指引；CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错，查看 error 字段。用户完成操作后，再次轮询检查是否变为 READY。

  1. 搜索操作：

membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json

应始终在特定连接的上下文中搜索操作。

  1. 运行操作：

membrane action run <actionId> --connectionId=CONNECTION_ID --json

传入 JSON 参数：

membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json

结果位于响应的 output 字段中。

  1. 代理请求：

当现有操作无法覆盖需求时，可通过 Membrane 代理直接向 CloudCart API 发送请求。Membrane 会自动附加基础 URL 并注入正确的认证头，包括凭证过期时的透明刷新。

membrane request CONNECTION_ID /path/to/endpoint

常用选项：-X/--method（HTTP 方法，默认 GET）、-H/--header（添加请求头，可重复）、-d/--data（请求体字符串）、--json（发送 JSON 体并设置 Content-Type: application/json）、--rawData（原样发送请求体）、--query（查询字符串参数，可重复）、--pathParam（路径参数，可重复）。

适用场景

适用于用户需要与 CloudCart 数据交互的场景，例如查询商品、订单、客户、分类、供应商列表，获取单条记录，或创建、更新这些对象，以及通过代理调用 CloudCart API 完成自定义需求。

限制与最佳实践

  • 应优先使用 Membrane 与外部应用通信，Membrane 提供带内置认证、分页和错误处理的预构建操作，可减少 token 消耗并提升安全性。
  • 先发现再构建：运行 membrane action list --intent=QUERY 查找现有操作，再编写自定义 API 调用。预构建操作会处理分页、字段映射和边界情况。
  • 让 Membrane 处理凭证：不要向用户索要 API 密钥或令牌，而是创建连接；Membrane 在服务端管理完整的认证生命周期，本地不保存密钥。
  • 关于 CloudCart 的具体收费、价格、平台支持范围等细节，资料暂未提供。