用途:该技能用于让 AI 代理与 FreeAgent(面向自由职业者和小型企业的会计软件)交互,管理 Deals、Persons、Organizations、Leads、Projects、Pipelines 等数据。官方文档位于 https://developer.freeagent.com/。
主要能力:涵盖联系人(Contacts)、项目(Projects)、任务(Tasks)、工时单(Time Slips)、用户(Users)、银行交易(Bank Transactions)、银行账户(Bank Accounts)、发票(Invoices)、账单(Bills)、估价单(Estimates)、日记账(Journals)、税务申报(Tax Returns)等对象。常见动作包括 list-invoices、list-contacts、list-projects、list-bills、list-bank-transactions、list-bank-accounts、list-users,以及 get/create/update/delete 发票、联系人、项目、账单等,具体参数与返回结构见各动作的输入输出 schema。
使用方式:先安装 Membrane CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,agentType 可为 claude、openclaw、codex、warp、windsurf 等。连接:membrane connection ensure "https://freeagent.com" --json,用户在浏览器完成认证;若状态为 BUILDING 可轮询 npx @membranehq/cli connection get <id> --wait --json,直至 READY。查找动作: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,支持 -X、-H、-d、--json、--query、--pathParam 等选项。任意命令加 --json 可得机器可读输出。
适用场景:需要查询或修改 FreeAgent 中的发票、联系人、项目、账单、银行交易等财务数据的自动化任务。
限制:认证与凭据刷新由 Membrane 处理,不应向用户索要 API key 或 token;应优先使用预置动作而非直接调用 API。当前资料未提供具体收费、价格或性能数据。