Yahoo Finance CLI

一个基于 Python 的命令行工具，使用 yfinance 从 Yahoo Finance 获取全面的股票数据。

系统要求

• Python 3.11+
• uv（用于内联脚本依赖管理）

安装 uv

该脚本依赖 uv —— 一款极快的 Python 包管理器。请先检查是否已安装：

uv --version

若未安装，请任选以下方式之一进行安装：

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

macOS（Homebrew）

brew install uv

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

pip（任意平台）

pip install uv

安装完成后，请重启终端，或执行以下命令使配置生效：

source ~/.bashrc  # 或在 macOS 上执行 ~/.zshrc

安装

yf 脚本采用 PEP 723 内联脚本元数据格式，首次运行时将自动安装所需依赖。

# 添加可执行权限
chmod +x /path/to/skills/yahoo-finance/yf

# （可选）创建软链接至 PATH，实现全局调用
ln -sf /path/to/skills/yahoo-finance/yf /usr/local/bin/yf

首次运行将自动安装依赖（yfinance、rich）至 uv 缓存目录；后续运行则瞬时完成。

命令列表

Price（快速查询当前价格）

yf AAPL              # price 命令的简写形式
yf price AAPL

Quote（详细行情）

yf quote MSFT

Fundamentals（基本面数据）

yf fundamentals NVDA

显示内容：市盈率（PE）、每股收益（EPS）、市值、利润率、净资产收益率（ROE）/总资产收益率（ROA）、分析师目标价等。

Earnings（财报信息）

yf earnings TSLA

显示内容：下一次财报发布日期、EPS 预期值、历史财报数据及盈利偏差（surprise）。

Company Profile（公司概况）

yf profile GOOGL

显示内容：所属行业板块（Sector）、细分行业（Industry）、员工人数、公司官网、注册地址、主营业务描述等。

Dividends（分红信息）

yf dividends KO

显示内容：股息率/股息收益率（Dividend Rate/Yield）、除息日（Ex-Date）、派息比率（Payout Ratio）、近期分红历史记录。

Analyst Ratings（分析师评级）

yf ratings AAPL

显示内容：买入/持有/卖出评级分布、平均评级（Mean Rating）、近期评级上调/下调动态。

Options Chain（期权链）

yf options SPY

显示内容：近平价（At-the-Money）认购（Call）与认沽（Put）期权，含行权价（Strike）、买卖盘报价（Bid/Ask）、成交量（Volume）、未平仓合约数（OI）、隐含波动率（IV）等。

History（历史行情）

yf history GOOGL 1mo     # 过去 1 个月
yf history TSLA 1y       # 过去 1 年
yf history BTC-USD 5d    # 最近 5 天

支持的时间范围参数：1d、5d、1mo、3mo、6mo、1y、2y、5y、10y、ytd、max

Compare（多标的对比）

yf compare AAPL,MSFT,GOOGL
yf compare RELIANCE.NS,TCS.NS,INFY.NS

并排对比多个标的的价格、涨跌幅、52 周区间（52W Range）、市值等关键指标。

Search（搜索）

yf search "reliance industries"
yf search "bitcoin"
yf search "s&p 500 etf"

代码符号（Symbol）格式说明

• 美国股票：AAPL、MSFT、GOOGL、TSLA
• 印度国家证券交易所（NSE）：RELIANCE.NS、TCS.NS、INFY.NS
• 印度孟买证券交易所（BSE）：RELIANCE.BO、TCS.BO
• 加密货币：BTC-USD、ETH-USD
• 外汇：EURUSD=X、GBPUSD=X
• ETF：SPY、QQQ、VOO

使用示例

# 快速查询价格
yf AAPL

# 获取估值指标
yf fundamentals NVDA

# 查询特斯拉下次财报日期及历史数据
yf earnings TSLA

# 查询 SPY 期权链
yf options SPY

# 对比科技巨头
yf compare AAPL,MSFT,GOOGL,META,AMZN

# 查找印度上市公司
yf search "infosys"

# 查询可口可乐分红信息
yf dividends KO

# 查询苹果公司分析师评级
yf ratings AAPL

故障排查

“command not found: uv”

请按上方说明安装 uv。

频率限制 / 连接错误

Yahoo Finance 可能对高频请求实施限流。请等待几分钟后重试。

某 Symbol 返回 “No data”

• 请先确认代码是否有效：yf search "company name"
• 部分数据（如期权、分红）并非所有证券均提供

技术说明

• 使用 PEP 723 内联脚本元数据声明 uv 依赖项
• 借助 rich 库渲染带颜色、格式化的表格输出
• 首次运行需安装依赖至 uv 缓存（约耗时 5 秒）
• 后续运行直接复用缓存环境，响应即时
• 对 NaN / None 值具备健壮处理能力，并提供合理默认回退逻辑