Pirate Weather 是一个天气 API,提供超本地(hyperlocal)天气数据,被需要为应用或服务获取准确、可靠天气信息的开发者与企业使用。
【用途】 该技能用于与 Pirate Weather 数据交互,管理数据、记录并自动化工作流,适合用户需要访问 Pirate Weather 天气数据的场景。
【主要能力】
- 天气(Weather):预报(Forecast)——针对特定地点和时间的天气预报。
- 可通过 Membrane 的预置动作与 Pirate Weather 交互,动作带有内置认证、分页和错误处理。
- 当预置动作无法覆盖用例时,可通过 Membrane 代理直接向 Pirate Weather API 发送请求,由 Membrane 自动追加基础 URL 并注入正确的认证头(含透明凭证刷新)。
【使用方式】
- 安装 CLI:npm install -g @membranehq/cli@latest
- 认证:membrane login --tenant --clientName=<agentType>;该命令会打开浏览器认证,或在控制台打印授权 URL。无界面环境中会打印授权 URL,用户完成后以 membrane login complete <code> 结束。任意命令加 --json 可输出机器可读 JSON。Agent Types 包括 claude、openclaw、codex、warp、windsurf 等。
- 连接 Pirate Weather:使用 membrane connection ensure "https://pirateweather.net/" --json,用户在浏览器完成认证,输出包含新的 connection id。若状态为 READY 可直接进入下一步;若为 BUILDING,则用 npx @membranehq/cli connection get <id> --wait --json 轮询直至状态改变。状态为 CLIENT_ACTION_REQUIRED 时,按 clientAction 描述完成所需操作("connect" 需认证,"provide-input" 需补充信息),完成后再次轮询。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;传 JSON 参数用 --input '{"key": "value"}',结果在响应的 output 字段。
- 代理请求:membrane request CONNECTION_ID /path/to/endpoint。常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。
【限制】
- 该技能依赖 Membrane CLI 与 Membrane 的连接机制,需先完成登录与连接认证。
- 资料未提供独立于 Membrane 的认证方式或 API 密钥获取流程说明。
- 资料未提供收费、价格、平台支持范围及准确率等具体指标。
- 官方文档地址为 https://pirateweather.net/en/latest/api/。