雅虎财经命令行界面

一个使用yfinance从雅虎财经获取全面股票数据的Python命令行界面工具。

系统要求

• 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 的缓存中。后续运行则是即时的。

命令

价格（快速查询）

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

报价（详细信息）

yf quote MSFT

基本面

yf fundamentals NVDA

显示：市盈率、每股收益、市值、利润率、股本回报率/资产回报率、分析师目标价。

财报

yf earnings TSLA

显示：下次财报日期、每股收益预估、包含意外情况的财报历史。

公司简介

yf profile GOOGL

显示：行业板块、员工人数、网站、地址、业务描述。

股息

yf dividends KO

显示：股息率/股息收益率、除息日、派息率、近期股息历史。

分析师评级

yf 评级 AAPL

显示：买入/持有/卖出分布、平均评级、近期上调/下调。

期权链

yf 期权 SPY

显示：接近平值的认购和认沽期权，包含行权价、买价/卖价、成交量、未平仓合约、隐含波动率。

历史数据

yf 历史 GOOGL 1mo     # 1个月历史数据
yf 历史 TSLA 1y       # 1年
yf 历史 BTC-USD 5d    # 5天

时间范围：1天、5天、1个月、3个月、6个月、1年、2年、5年、10年、年初至今、全部

对比

yf 对比 AAPL,MSFT,GOOGL
yf 对比 RELIANCE.NS,TCS.NS,INFY.NS

并排对比，包含价格、涨跌幅、52周价格区间、市值。

搜索

yf 搜索 "reliance industries"
yf 搜索 "bitcoin"
yf 搜索 "s&p 500 etf"

代码格式

• 美股：AAPL, MSFT, GOOGL, TSLA
• 印度国家证券交易所：RELIANCE.NS, TCS.NS, INFY.NS
• 印度孟买证券交易所：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。

速率限制 / 连接错误

雅虎财经可能会对过多的请求进行速率限制。请等待几分钟后重试。

某个代码没有数据

• 请验证该代码是否存在：yf search "公司名称"
• 某些数据（如期权、股息）并非对所有证券都可用

技术说明

• 使用 PEP 723 内联脚本元数据来管理 uv 依赖
• Rich 库提供带颜色和格式的表格
• 首次运行会将依赖安装到 uv 缓存（约5秒）
• 后续运行是即时的（环境已缓存）
• 通过回退机制优雅处理 NaN/None 值