用途:该技能用于与 Merge 数据交互,管理数据、记录并自动化工作流;适用于用户需要操作 Merge 数据的场景。Merge 是集成平台,让开发者用单一 API 为产品添加数百种集成,面向希望向客户提供集成而不自行构建维护的 SaaS 公司。官方文档见 https://developers.merge.dev/。
主要能力与使用方式:本技能通过 Membrane CLI 与 Merge 交互,Membrane 自动处理认证与凭据刷新。先用 npm install -g @membranehq/cli@latest 安装 CLI,再执行 membrane login --tenant --clientName=<agentType> 登录(交互模式会打开浏览器,否则打印授权 URL;无头环境需让用户在浏览器打开,完成后用 membrane login complete <code>)。可用 membrane connection ensure "https://www.merge.dev/" --json 查找或创建连接,URL 会被规范化为域名并匹配已知应用,若状态为 BUILDING 可用 npx @membranehq/cli connection get <id> --wait --json 轮询至就绪。用 membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 搜索动作,用 membrane action run <actionId> --connectionId=CONNECTION_ID --json 运行(可加 --input '{"key": "value"}')。动作不足时可经代理直接请求 Merge API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
限制与说明:应始终在具体连接上下文中搜索动作,优先使用预置动作而非手写 API 调用;不向用户索要 API 密钥或令牌,改由连接管理凭据。若连接状态为 CLIENT_ACTION_REQUIRED 需按 clientAction 处理,CONFIGURATION_ERROR 或 SETUP_FAILED 需查看 error 字段。资料未提供具体收费、价格与适用平台信息,暂未提供。