Yahoo Finance CLI 是一个由 Yahoo Finance 数据驱动的金融数据终端，所有命令通过 yf 脚本执行。
一、用途 该工具用于在命令行中获取金融数据，覆盖股票与债券价格、信用分析、宏观仪表盘、外汇汇率、ETF 资金流向、基本面数据和新闻。适合个人投资者、分析师或开发者快速查询金融市场信息。
二、安装与初始化 脚本位于 {baseDir}/scripts/yf。它使用 uv run --script 与内联 PEP 723 元数据，依赖项在首次运行时自动安装。首次使用前需赋予可执行权限： chmod +x {baseDir}/scripts/yf
三、主要命令
- yf price TICKER：快速获取价格、涨跌和成交量，例如 yf price YPF。
- yf quote TICKER：详细报价，包括 52 周数据、市盈率（PE）、收益率，例如 yf quote AAPL。
- yf compare T1,T2,T3：并排比较表格，例如 yf compare YPF,PAM,GGAL。
- yf credit TICKER：信用分析，包括杠杆率、覆盖率和债务到期情况，例如 yf credit YPF。
- yf macro：晨间宏观仪表盘，涵盖美国国债（UST）、美元指数（DXY）、VIX、石油、黄金、比特币（BTC）、阿根廷比索（ARS）。
- yf fx [BASE]：拉美外汇汇率（ARS、BRL、CLP、MXN、COP），例如 yf fx USD。
- yf flows ETF：ETF 主要持仓和基金数据，例如 yf flows EMB。
- yf history TICKER [PERIOD]：价格历史，周期可选 1d/5d/1mo/3mo/6mo/1y/ytd/max，例如 yf history YPF 3mo。
- yf fundamentals TICKER：完整财务报表（利润表、资产负债表、现金流量表），例如 yf fundamentals YPF。
- yf news TICKER：近期新闻标题，例如 yf news YPF。
- yf search QUERY：查找股票代码，例如 yf search "argentina bond"。
所有命令均支持 --json 参数，以输出机器可读的结果。
四、命令选择指引
- 晨间检查：yf macro，一次性获取美国国债收益率、美元指数、VIX、大宗商品、BTC、ARS。
- 快速查看：yf price TICKER，快速获取价格、涨跌和成交量。
- 股票深度分析：依次使用 yf quote、yf fundamentals、yf history。
- 信用分析：yf credit TICKER，获取杠杆率、利息覆盖率和债务明细。
- 新兴市场/拉美外汇：yf fx，获取主要拉美货币对美元汇率。
- ETF 研究：yf flows ETF，获取主要持仓、管理资产规模（AUM）和费率。
- 比较：yf compare，用于相对价值并排比较。
五、错误处理 脚本对错误代码、缺失数据和速率限制提供清晰的错误信息。如果 Yahoo Finance 触发速率限制，等待片刻后重试即可。
六、输出格式 默认输出使用 Rich 表格，便于在终端中清晰展示。在任何命令后添加 --json 可获得结构化 JSON 输出，适合管道传输或进一步处理。
七、限制 该工具依赖 Yahoo Finance 数据源，因此可能受其速率限制影响。资料未提供收费、价格、支持平台或效果方面的具体信息。