用途:该技能用于让 AI 智能体与 FacturaDirecta 数据交互。FacturaDirecta 是面向西班牙中小企业与自由职业者的 SaaS 应用,用于开票与会计,简化发票创建与发送、费用跟踪和税务管理。官方文档:https://www.facturadirecta.com/api/
主要能力:覆盖 Invoice(发票)、Invoice Line(发票行)、Client(客户)、Product(产品)、Tax(税)、Payment Method(支付方式)、Series(系列)、Template(模板)等对象。常用动作包括 List/Get/Create/Update 发票、客户、产品、估算(presupuestos)、费用(gastos)、交货单(albaranes),支持过滤与分页;也可通过代理直接请求 FacturaDirecta API。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>(agentType 如 claude、openclaw、codex、warp、windsurf 等)。无界面环境会打印授权 URL,用户登录后拿到 code,执行 membrane login complete <code>。建立连接:membrane connection ensure "https://www.facturadirecta.com/" --json;若状态为 BUILDING,则用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY;若为 CLIENT_ACTION_REQUIRED,按 clientAction 提示让用户在浏览器完成认证,再轮询。查找动作: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/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。任意命令可加 --json 获取机器可读输出。
适用场景:需要由 AI 代理批量查询或创建发票、客户、产品、估算、费用、交货单,并统一处理认证与分页时。
限制:Membrane 负责认证与凭证刷新,不应向用户索取 API 密钥或令牌;找不到现成动作时才使用代理请求。资料未提供具体定价、配额、错误码清单或字段级 schema 细节。