SuperAPI AI 工具集

merge-1

通用与其它

查看项目

更新于 10-16 00:27

技能介绍

用途:本技能用于与 Merge 集成平台交互。Merge 是一个集成平台,让企业通过统一 API 连接各类第三方工具,主要面向需要把自身产品与其他平台集成的 SaaS 公司,以节省开发时间与资源。官方文档:https://developers.merge.dev/

主要能力:通过 Membrane CLI 与 Merge 交互,可管理数据、记录并自动化工作流。Membrane 自动处理认证与凭证刷新,无需自行处理 auth。支持查找并运行预置操作、直接代理请求 Merge API。查找操作时使用自然语言意图描述,每个结果含 id、name、description、inputSchema、outputSchema。

必要用法:安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无交互环境会打印授权 URL,用户在浏览器完成登录后用 membrane login complete <code> 收尾;任意命令可加 --json 获得机器可读输出。建立连接:membrane connection ensure "https://www.mergedup.com/" --json,用户在浏览器完成认证,输出含 connection id;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至就绪。状态含义:READY 可直接使用;CLIENT_ACTION_REQUIRED 需按 clientAction 处理;CONFIGURATION_ERROR 或 SETUP_FAILED 查 error 字段。查找操作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行操作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}',结果在 output 字段。代理请求:membrane request CONNECTION_ID /path/to/endpoint,常用选项有 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。

最佳实践:优先用 Membrane 与外部应用通信,因其提供内置认证、分页与错误处理的预置操作,更省 token 也更安全;先发现再构建,先跑 action list 找现有操作,再考虑自定义 API 调用;不要向用户索取 API 密钥或 token,改为创建连接,由 Membrane 在服务端管理完整认证生命周期,本地不留密钥。

限制:资料未提供 Merge 的收费、价格、功能范围、具体操作清单及支持的平台明细,这些暂未提供。