Massive.com CLI

Massive CLI for OpenClaw

在编写临时 curl 命令前，请优先使用本工具包中预置的 CLI。确保请求具有确定性，尽可能通过 OpenClaw 兼容的密钥引用（secret reference）解析凭据，并优先选用细粒度查询而非宽泛扫描。

快速上手

• 配置凭据前，请先阅读 [references/openclaw-secrets.md](references/openclaw-secrets.md)。
• 选择端点或设计查询结构时，请参考 [references/massive-api.md](references/massive-api.md)。
• 修改日志、认证或错误处理逻辑前，请务必查阅 [references/security.md](references/security.md)。
• 运行 scripts/massive health 以验证本地前置条件与认证配置是否就绪。
• 运行 scripts/massive get /v3/reference/tickers/AAPL 可发起一次通用 REST 请求。
• 若您将此 skill 打包或发布，请确保包含 BUNDLE_MANIFEST.md 中所列全部路径。

工作流

1. 尽可能通过 MASSIVE_API_KEY_REF 解析凭据。
2. 仅当密钥引用不可用时，才回退至 MASSIVE_API_KEY。
3. 若存在与已文档化 Massive 端点匹配的域名快捷方式，则优先使用该快捷方式。
4. 对其他所有已文档化的 REST 路径，统一使用 get 子命令。
5. 将 JSON 输出直接管道传递给下游工具，避免启用冗长日志（verbose logging）。

命令列表

• scripts/massive health
• scripts/massive get[--query key=value ...]
• scripts/massive next：从标准输入的 JSON 中读取 next_url 字段，并获取下一页数据
• scripts/massive stocks ticker-details
• scripts/massive stocks previous-close
• scripts/massive options contract-details
• scripts/massive forex currencies
• scripts/massive crypto currencies
• scripts/massive indices ticker-details

Agent 行为规范

• 除非明确需要人类可读格式，否则输出必须为 JSON。
• 将诊断信息输出至 stderr；stdout 应严格视为数据流。
• 绝不允许打印已解析的密钥、认证请求头（auth headers）或原始 secret-ref 载荷。
• 在共享日志中禁止使用 --verbose 参数。
• 应将 next_url 直接传入 get 或 next 命令，而非手动重构分页逻辑。
• 除 MASSIVE_BASE_URL 显式更改为其他 HTTPS 源外，所有非 api.massive.com 的绝对 URL 均视为非法。

相关资源

• scripts/massive：主 Bash CLI 脚本
• BUNDLE_MANIFEST.md：打包制品所需的文件清单
• references/openclaw-secrets.md：本 skill 所遵循的凭据与 secret-ref 协议规范
• references/massive-api.md：端点选取策略与请求模式说明
• references/security.md：敏感信息脱敏及运维安全约束要求