用途:该技能用于通过 Membrane CLI 与 Handwrytten 服务交互。Handwrytten 是一项自动发送手写便签的服务,企业常用于营销、客户答谢和规模化个性化沟通。官方文档:https://www.handwrytten.com/api-handwrytten-developer
主要能力:可管理 Cards、Card Batches、Contacts、Campaigns、Orders、Account、Billing、Payment Methods、Users 等资源。常用动作包括 get-order(获取订单详情含状态与证明)、send-letter(向最多 10 位收件人发送手写信件)、list-stationery(列出可用信纸/卡片选项)、list-handwritings(列出可用手写风格)。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会打印授权 URL,完成后执行 membrane login complete <code>。连接:membrane connection ensure "https://www.handwrytten.com/" --json;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。也可通过代理直接请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--query、--pathParam 等选项。
限制:认证与凭据刷新由 Membrane 自动处理,不应向用户索取 API 密钥或令牌;具体动作参数与返回结构以实际查询结果为准,资料未提供完整字段清单。