用途:npm 是 JavaScript 的包管理器,供开发者安装、分享和管理项目依赖;本技能通过 Membrane CLI 与 npm 交互,用于管理数据、记录并自动化工作流。官方文档:https://docs.npmjs.com/。涉及对象包括 Package、Version、User、Organization。
安装:npm install -g @membranehq/cli@latest
认证:membrane login --tenant --clientName=<agentType>,会打开浏览器或输出授权 URL;无头环境下需用户在浏览器打开 URL,完成后执行 membrane login complete <code>。任意命令加 --json 可输出机器可读 JSON。agentType 可为 claude、openclaw、codex、warp、windsurf 等。
连接:使用 membrane connection ensure "https://npmjs.com" --json 查找或创建连接,用户在浏览器完成认证后输出连接 id。若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至非 BUILDING。状态含义:READY 可用;CLIENT_ACTION_REQUIRED 需用户或代理操作(connect 认证、provide-input 补充信息,含 description、可选 uiUrl、可选 agentInstructions);CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错,查看 error 字段。
查找与运行动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json;结果含 id、name、description、inputSchema、outputSchema。运行:membrane action run <actionId> --connectionId=CONNECTION_ID --json,参数用 --input '{"key": "value"}',结果在 output 字段。
代理请求:动作不足以覆盖时,可经 Membrane 代理直接请求 npm API:membrane request CONNECTION_ID /path/to/endpoint。常用选项:-X/--method 指定 HTTP 方法(默认 GET)、-H/--header 添加请求头、-d/--data 请求体、--json 以 JSON 体并设 Content-Type、--rawData 原样发送、--query 查询参数、--pathParam 路径参数。
限制与建议:优先使用 Membrane 预置动作以复用内置认证、分页和错误处理;先 discovery 再自建调用;不要让用户提供 API 密钥或令牌,由 Membrane 服务端管理认证生命周期,本地不存密钥。资料未提供具体可用动作清单、字段细节或收费信息。