SuperAPI AI 工具集

wave-financial

数据与分析

查看项目

更新于 10-16 09:59

技能介绍

用途:该技能用于让 AI 代理通过 Membrane CLI 与 Wave Financial(面向小微企业主和自由职业者的会计与记账软件,涵盖发票、费用、工资与银行等工具)进行交互,管理数据、记录并自动化工作流。官方开发文档:https://developers.waveapps.com/

涉及的数据对象包括 Business、Bank Account、Invoice、Bill、Transaction、Report。技能通过 Membrane CLI 与 Wave Financial 通信,Membrane 自动处理身份验证与凭证刷新。

安装:npm install -g @membranehq/cli@latest

认证:可使用 membrane login --tenant --clientName=<agentType>;无界面环境会打印授权 URL,用户完成后用 membrane login complete <code> 结束。任意命令加 --json 可输出机器可读 JSON。agentType 可选 claude、openclaw、codex、warp、windsurf 等。

连接:membrane connection ensure "https://www.waveapps.com/wave-app" --json,用户在浏览器完成认证后获得 connection id。若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询,直至 READY;CLIENT_ACTION_REQUIRED 时按 clientAction 说明处理(如 connect、provide-input)。

查找动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。常用动作包括 list-invoices、list-customers、list-products、list-accounts、list-vendors、list-businesses、get-invoice、get-business、get-current-user、create-invoice、create-customer、create-product、create-account、update-customer、update-product、delete-invoice、delete-customer、approve-invoice、send-invoice、list-currencies。

运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}',结果在响应 output 字段。

代理请求:当内置动作不覆盖需求时,可用 membrane request CONNECTION_ID /path/to/endpoint 直接访问 Wave Financial API,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。

限制与注意:资料未提供具体收费、价格、速率限制及全部错误码说明,需以官方文档为准;不要向用户索要 API 密钥或令牌,应通过创建连接由 Membrane 服务端管理完整认证生命周期。