SuperAPI AI 工具集

magnolia

办公与效率

查看项目

更新于 10-16 00:27

技能介绍

Magnolia 是一款内容管理系统(CMS),用于构建和管理网站及数字体验,常被企业用于跨多个渠道创建和交付个性化内容。官方文档:https://documentation.magnolia-cms.com/。涉及对象包括 Document、Page、Template、Component、Theme、User、Asset、Configuration、Task、Search 等。

本技能通过 Membrane CLI 与 Magnolia 交互,Membrane 自动处理认证与凭据刷新,让使用者专注于集成逻辑而非认证管道。

安装 CLI:npm install -g @membranehq/cli@latest

认证:membrane login --tenant --clientName=<agentType>。会打开浏览器认证或打印授权 URL;无头环境下会打印授权 URL,让用户在浏览器打开,完成后用 membrane login complete <code> 收尾。任意命令加 --json 可获得机器可读的 JSON 输出。Agent 类型包括 claude、openclaw、codex、warp、windsurf 等,用于按 harness 调整工具。

连接 Magnolia:membrane connection ensure "https://magnolia-cms.com" --json,用户在浏览器完成认证,输出包含新的连接 id。若连接为 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,结果包含 id、name、description、inputSchema、outputSchema。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}' --json,结果在 output 字段。

当现有动作不覆盖用例时,可通过 Membrane 代理直接请求 Magnolia API:membrane request CONNECTION_ID /path/to/endpoint,常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。Membrane 会自动附加基础 URL 并注入认证头,凭据过期时透明刷新。

建议:优先使用 Membrane 与外部应用通信;先发现再看能否复用已有动作;始终让 Membrane 处理凭据,不要向用户索取 API 密钥或令牌,而是创建连接。