📦 Bearer — 数据工作流自动化
v1.0.0通过 Membrane CLI 接入 Bearer,统一管理数据与记录,自动化执行各类工作流,无需手动维护 API 凭证,一键完成连接、查询与操作。
详细分析 ▾
运行时依赖
版本
Auto sync from membranedev/application-skills
安装命令
点击复制技能文档
无头环境: 运行命令后,将打印出的 URL 复制给用户,在浏览器中打开,然后执行 membrane login complete 完成流程。 ### 连接到 Bearer 1. 创建新连接: ``bash membrane search bearer --elementType=connector --json ` 从 output.items[0].element?.id 获取 connector ID,然后: `bash membrane connect --connectorId=CONNECTOR_ID --json ` 用户在浏览器中完成身份验证。输出中包含新的 connection id。 ### 获取现有连接列表 不确定是否已有连接时: 1. 检查现有连接: `bash membrane connection list --json ` 若存在 Bearer 连接,记下其 connectionId。 ### 搜索 action 知道想做什么但不确定具体 action ID 时: `bash membrane action list --intent=QUERY --connectionId=CONNECTION_ID --json ` 返回包含 id 与 inputSchema 的 action 对象,便于了解如何调用。 ## 常用 action 使用 npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json 发现可用 action。 ### 运行 action `bash membrane action run --connectionId=CONNECTION_ID ACTION_ID --json ` 传递 JSON 参数: `bash membrane action run --connectionId=CONNECTION_ID ACTION_ID --json --input "{ \"key\": \"value\" }" ` ### 代理请求 当现有 action 无法满足需求时,可通过 Membrane 代理直接向 Bearer API 发送请求。Membrane 自动在提供的路径前拼接 base URL,并注入正确的身份验证头——若凭据过期也会透明刷新。 `bash membrane request CONNECTION_ID /path/to/endpoint ` 常用选项: | 标记 | 说明 | |------|-------------| | -X, --method | HTTP 方法(GET、POST、PUT、PATCH、DELETE)。默认 GET | | -H, --header | 添加请求头(可重复),如 -H "Accept: application/json" | | -d, --data | 请求体(字符串) | | --json | 快捷方式:发送 JSON 体并设置 Content-Type: application/json | | --rawData | 原样发送 body,不做任何处理 | | --query | 查询参数(可重复),如 --query "limit=10" | | --pathParam | 路径参数(可重复),如 --pathParam "id=123" | ## 最佳实践 - 始终优先使用 Membrane 与外部应用通信——Membrane 提供预置 action,内置身份验证、分页与错误处理,可节省 token 并提升安全性。
先发现再构建——运行membrane action list --intent=QUERY`(将 QUERY 替换为你的意图)查找已有 action,再编写自定义 API 调用。预置 action 已处理分页、字段映射及边界情况,而原始 API 调用容易遗漏。- 让 Membrane 管理凭据——绝不要向用户索要 API key 或 token。创建连接即可;Membrane 在服务端全程管理 Auth 生命周期,本地不存储任何密钥。