用途:该技能用于与 Mapbox 地图和位置平台交互,可管理地图、样式、账户和 Token 等数据,适合在 Web 或移动应用中集成位置服务的开发者使用。官方文档见 https://docs.mapbox.com/。
主要能力:通过 Membrane CLI 与 Mapbox 通信,Membrane 自动处理认证与凭证刷新;支持按自然语言意图搜索可用动作,然后运行动作,或直接经代理发送请求到底层 Mapbox API。
安装与认证:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>。无界面环境会打印授权 URL,用户完成登录后用 membrane login complete <code> 收尾,任何命令可加 --json 获得机器可读输出。agent 类型包括 claude、openclaw、codex、warp、windsurf 等。
连接 Mapbox:使用 membrane connection ensure "https://www.mapbox.com/" --json 查找或创建连接,用户需在浏览器完成认证。若返回 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询直到 READY;出现 CLIENT_ACTION_REQUIRED 时按 clientAction 处理(连接或补充输入);CONFIGURATION_ERROR 或 SETUP_FAILED 时查看 error。
搜索与运行动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 搜索,结果含 id、name、description 及输入输出 schema。运行:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参加 --input '{"key": "value"}',结果在 output 字段。
代理请求:动作不覆盖时用 membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项,Membrane 自动拼接基础 URL 并注入认证头。
限制与注意:涉及凭据时不要向用户索要 API 密钥或 Token,应通过创建连接由 Membrane 服务端管理;应优先搜索已有动作再做自定义调用。资料未提供收费、价格、具体动作列表及适用范围等细节,暂未提供。