用途:通过 Membrane CLI 调用 Codat 的统一业务数据 API,访问小微企业客户的会计、银行和商业数据,用于贷款、保险和金融科技等场景。
主要能力:可管理公司与连接,在公司下创建/更新/删除公司及连接,并触发数据同步。可查询的 Codat 资源包括公司、连接、账户(科目表)、账单(应付)、发票、客户、供应商、银行账户、支付、日记账分录;还可获取资产负债表与利润表(损益表)等财务报表。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。使用 membrane login --tenant --clientName=<agentType> 登录(无头环境会打印授权 URL,完成后执行 membrane login complete <code>)。用 membrane connection ensure "https://www.codat.io/" --json 建立连接,待状态为 READY;若为 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"}'。动作未覆盖时,可用 membrane request CONNECTION_ID /path/to/endpoint 直接代理访问 Codat API,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。所有命令可加 --json 输出机器可读结果。
适用场景:需要统一读取小微企业会计、银行与商业数据的集成逻辑,尤其是需要认证代管、分页与凭证刷新的场景。
限制:Membrane 负责认证与凭证刷新,不应向用户索要 API key 或 token。应优先使用预建动作而非自建 API 调用。官方文档见 https://docs.codat.io/。其余细节暂未提供。