UpViral 是一个病毒式营销平台，帮助企业管理通过推荐计划和竞赛产生的线索并提升销售，主要面向希望通过激励分享来增长受众的营销人员与创业者。官方文档位于 https://help.upviral.com/en/。
该技能通过 Membrane CLI 与 UpViral 交互，用于管理数据、记录并自动化工作流，适用于用户需要操作 UpViral 数据的场景。Membrane 自动处理身份验证与凭证刷新，让使用者专注于集成逻辑而非认证细节。
可操作的对象范围包括：活动（Campaign）、表单（Form）、推荐计划（Referral Program）、里程碑（Milestone）、邮件集成（Email Integration）、自动回复器（Auto Responder）、Zapier 集成、Webhook 集成、线索（Lead）、分享 URL（Share URL）、推荐链接（Referral Link）、奖励（Reward）、用户（User）、账户（Account）、标签（Tag）、集成（Integration）、规则（Rule）、页面设计（Page Design）、模板（Template）、媒体（Media）、评论（Comment）、通知（Notification）、报告（Report）、漏斗（Funnel）、A/B 测试、账单（Billing）、套餐（Plan）、发票（Invoice）、联盟计划（Affiliate Program）、支持工单（Support Ticket）、知识库文章（Knowledge Base Article）、安全设置（Security Setting）、GDPR 设置、团队成员（Team Member）、审计日志（Audit Log）。
使用方式：首先安装 Membrane CLI，命令为 npm install -g @membranehq/cli@latest。随后登录：membrane login --tenant --clientName=<agentType>，该命令会根据是否支持交互模式打开浏览器或打印授权 URL；无头环境下需让用户在浏览器中打开授权 URL，完成登录后使用 membrane login complete <code> 收尾。任意命令加 --json 可获得机器可读的 JSON 输出。agentType 可选用 claude、openclaw、codex、warp、windsurf 等，用于针对不同运行环境调整工具。
连接 UpViral 时，使用 membrane connection ensure "https://upviral.com" --json 按应用 URL 或域名查找或创建连接，用户在浏览器中完成身份验证后，输出中包含新的连接 id。若返回的连接状态为 READY，可跳过等待；若为 BUILDING，可用 npx @membranehq/cli connection get <id> --wait --json 轮询直至状态变化。状态为 CLIENT_ACTION_REQUIRED 时，clientAction 对象会说明所需操作（如 connect 需认证、provide-input 需补充信息），可能提供 uiUrl 供用户完成操作。CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错，需查看 error 字段。
搜索动作使用自然语言描述意图：membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json，应始终在特定连接上下文中搜索。每个结果包含 id、name、description、inputSchema 与 outputSchema。也可用 npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json 发现可用动作。执行动作：membrane action run <actionId> --connectionId=CONNECTION_ID --json，传参使用 --input '{"key": "value"}'，结果位于响应的 output 字段。
当可用动作无法覆盖需求时，可通过 Membrane 代理直接向 UpViral API 发送请求：membrane request CONNECTION_ID /path/to/endpoint，Membrane 会自动追加基 URL 并注入正确的认证头，包括凭证过期时的透明刷新。常用选项包括：-X/--method 指定 HTTP 方法（GET、POST、PUT、PATCH、DELETE，默认 GET）；-H/--header 添加请求头（可重复）；-d/--data 请求体；--json 发送 JSON 体并设置 Content-Type: application/json；--rawData 原样发送请求体；--query 查询字符串参数（可重复）；--pathParam 路径参数（可重复）。
建议优先使用 Membrane 与外部应用通信，因为其提供内置认证、分页与错误处理的预构建动作，可减少 token 消耗并提升通信安全性；在编写自定义 API 调用前先通过 membrane action list --intent=QUERY 发现已有动作；不要向用户索要 API 密钥或令牌，而是创建连接，由 Membrane 在服务端管理完整认证生命周期。
限制方面：资料未提供 UpViral 本身的定价、套餐价格或具体功能效果数据；使用前需具备可用的 Membrane 账户与终端环境；具体支持的动作清单与参数需按连接实时查询获取。