把 Gloomberb 变成你的数据管道：CLI 自动化与 JSON / CSV 输出实战

把 Gloomberb 变成你的数据管道：CLI 自动化与 JSON / CSV 输出实战

【免费下载链接】gloomberbFinance terminal, in your terminal.项目地址: https://gitcode.com/gh_mirrors/gl/gloomberb

Gloomberb 是一款开源金融终端（finance terminal），它不仅能让你在终端里看行情、做研究，更能通过gloomberbCLI 把报价、财报、新闻、宏观数据一键导出为JSON / CSV / NDJSON，轻松接入你自己的数据管道、脚本和定时任务 🚀

为什么它值得成为你的数据管道起点

大多数人把终端应用当成"只看"的工具，但 Gloomberb 的 CLI 设计从第一天就兼顾了人眼和机器两种读者：

• 默认人类可读：表格自动适配终端宽度，单条结果打印成对齐的"标签-值"行；
• 结构化输出可切换：任何命令追加--json、--csv或--ndjson即可切换格式，无需改变参数；
• 输出稳定可预期：JSON 走统一的信封结构，CSV 保留原始数值，错误也是机器可读的。

相关实现见 result.ts（输出序列化逻辑）与 docs/usage.md 的 CLI 章节。

先装好 CLI（30 秒）

macOS / Linux：

curl -fsSL gloom.sh/install | bash

或使用 Bun（macOS、Linux、Windows x64）：

bun install -g gloomberb

安装完成运行gloomberb help即可看到全部命令分组，具体位置与更新方式参见 installation.md。

三种结构化输出格式：--json / --csv / --ndjson

JSON：带"信封"的结构化输出

--json输出的不是裸数据，而是一个统一信封（见 result.ts）：

{ "ok": true, "data": [ ... ], "metadata": { "symbol": "AAPL", "range": "1Y" } }

• data是命令返回的完整模型（JSON 模式总是选"最丰富"的可用模型）；
• metadata带上符号、区间等上下文，方便下游程序核对数据出处；
• 有表格列的命令还会附带columns元数据，列名与展示逻辑一目了然。

失败时同样可机读：

{ "ok": false, "error": { "code": "...", "message": "...", "retryable": true } }

retryable字段直接告诉脚本"要不要重试"，这对无人值守的定时抓取非常实用 💡

CSV：为表格软件而生的格式

• 表头使用命令的展示列名，数据保留原始数值（不会把 3.14% 预先变成 "3.14%"）；
• 报告类命令（fn）的嵌套部分会编码为 JSON 单元格，不丢失层级；
• 终端内的表格同样可用Ctrl+Shift+E导出 CSV，与 CLI 输出同源。

NDJSON：给流式管道的"逐行 JSON"

大结果集时，--ndjson每行输出一个对象，可以边生成边消费，内存占用极低，是搭建增量数据管道的理想选择。

实战：把行情数据接进你的管道

一键拉取报价并解析

gloomberb quote AAPL MSFT NVDA --json | jq '.data[] | {symbol, price, changePercent}'

quote支持逗号分隔多个代码，返回最新价、涨跌幅、所属交易时段、数据源与更新时间（列定义见 market.ts）。

把研究数据落成每日 CSV

# 每天收盘后抓取财务数据，归档为 CSV gloomberb financials AAPL --csv > data/aapl_financials_$(date +%F).csv

控制输出规模与刷新

常用全局参数在 options.ts 中统一定义，任意命令都可用：

一个典型的无人值守片段：

gloomberb movers --csv --quiet --no-color | csvtool > /dev/null && echo "daily movers OK"

常用取数命令速查

完整命令表与参数示例请查阅官方 CLI 参考：usage.md。

写在最后：从"看数据"到"用数据"

Gloomberb 的 CLI 把金融终端变成了可编排的数据源：--json给你最完整的模型，--csv给你可直接入表的原始值，--ndjson给你逐行流的效率；配合--limit、--refresh、--yes等全局参数，写一个 crontab 或 CI 任务就能搭起自己的金融数据管道。下次想看某个面板背后还能导出什么，直接运行gloomberb help <command>，每个命令都自带用法与示例 📊

【免费下载链接】gloomberbFinance terminal, in your terminal.项目地址: https://gitcode.com/gh_mirrors/gl/gloomberb