Yahoo Finance CLI 是一个用 Python 编写的命令行工具，借助 yfinance 库从 Yahoo Finance 抓取全面的股票数据。使用前需要 Python 3.11+ 以及 uv（用于内联脚本依赖）。uv 是高速 Python 包管理器，可通过 macOS/Linux 的安装脚本、Homebrew、Windows PowerShell 或 pip 安装；安装后需重启终端或重新加载 shell 配置。
yf 脚本使用 PEP 723 内联脚本元数据，依赖会在首次运行时自动安装。安装时先赋予可执行权限，也可以创建符号链接以便全局调用，首次运行会安装 yfinance 和 rich 到 uv 缓存，之后运行即时完成。
命令方面：yf AAPL 或 yf price AAPL 可快速查看价格；yf quote MSFT 获取详细报价；yf fundamentals NVDA 查看市盈率、每股收益、市值、利润率、ROE/ROA、分析师目标价等基本面指标；yf earnings TSLA 显示下次财报日期、每股收益预估、历史财报及超预期情况；yf profile GOOGL 展示板块、行业、员工数、网站、地址和业务描述；yf dividends KO 显示股息率、收益率、除息日、派息率及近期股息历史；yf ratings AAPL 给出买入/持有/卖出分布、平均评级及近期评级调整；yf options SPY 展示接近平值的看涨和看跌期权，包含行权价、买卖价、成交量、未平仓量和隐含波动率。
历史数据使用 yf history GOOGL 1mo，支持 1d、5d、1mo、3mo、6mo、1y、2y、5y、10y、ytd、max 等区间。yf compare AAPL,MSFT,GOOGL 可进行多标的并排比较，展示价格、涨跌、52周区间和市值。yf search "reliance industries" 用于查找代码。符号格式涵盖美股、印度 NSE/BSE、加密货币、外汇和 ETF。
常见问题包括 uv 未安装、请求限流或连接错误（建议等待几分钟重试）、符号无数据（可用 search 验证）以及部分证券缺少期权或股息数据。技术层面，该工具利用 PEP 723 元数据管理依赖，用 rich 库输出彩色表格，首次运行安装依赖约需 5 秒，后续使用缓存即时响应，并对 NaN/None 值做了容错处理。