mcpField
Y
yahoo-finance

yahoo-finance

github.com/gracefullight其他494.7k 次安装1 天前更新
代码仓库

关于 yahoo-finance

这是一个通过 yfinance 获取 Yahoo Finance 市场数据的 Python 命令行技能，适合投资者和市场研究人员，可查询报价、基本面、历史数据并比较证券。

主要功能

  1. 01查询价格和详细报价
  2. 02查看基本面、财报和公司简介
  3. 03获取股息、评级和期权数据
  4. 04查询历史数据并比较标的
  5. 05按公司或资产名称搜索

适用场景

  1. 01查看股票代码的当前价格和报价
  2. 02检查财务指标与财报数据
  3. 03比较多只股票或 ETF
  4. 04查找公司或资产对应的代码

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/gracefullight/stock-checker --skill yahoo-finance

安装后在 Claude Code 中输入/yahoo-finance确认已加载。

附带文件_meta.json

详细介绍

Yahoo Finance 命令行工具

使用 yfinance 从 Yahoo Finance 获取全面股票数据的 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  # or ~/.zshrc on macOS

安装

yf 脚本使用 PEP 723 内联脚本元数据——依赖项会在首次运行时自动安装。

# Make executable
chmod +x /path/to/skills/yahoo-finance/yf

# Optionally symlink to PATH for global access
ln -sf /path/to/skills/yahoo-finance/yf /usr/local/bin/yf

首次运行时会将依赖项（yfinance、rich）安装到 uv 的缓存中。之后运行会立即完成。

命令

价格（快速查看）
yf AAPL              # shorthand for price
yf price AAPL
报价（详细信息）
yf quote MSFT
基本面
yf fundamentals NVDA

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

财报
yf earnings TSLA

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

公司简介
yf profile GOOGL

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

股息
yf dividends KO

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

分析师评级
yf ratings AAPL

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

期权链
yf options SPY

显示：平值附近的看涨期权和看跌期权，包括行权价、买价/卖价、成交量、未平仓合约量、隐含波动率。

历史数据
yf history GOOGL 1mo     # 1 month history
yf history TSLA 1y       # 1 year
yf history BTC-USD 5d    # 5 days

范围：1d、5d、1mo、3mo、6mo、1y、2y、5y、10y、ytd、max

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

并排比较价格、涨跌幅、52 周区间、市值。

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

符号格式

  • 美国股票： 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

示例

# Quick price check
yf AAPL

# Get valuation metrics
yf fundamentals NVDA

# Next earnings date + history
yf earnings TSLA

# Options chain for SPY
yf options SPY

# Compare tech giants
yf compare AAPL,MSFT,GOOGL,META,AMZN

# Find Indian stocks
yf search "infosys"

# Dividend info for Coca-Cola
yf dividends KO

# Analyst ratings for Apple
yf ratings AAPL

故障排除

“command not found: uv”

使用上面的说明安装 uv。

请求频率限制 / 连接错误

Yahoo Finance 可能会限制过于频繁的请求。等待几分钟后重试。

符号“无数据”
  • 确认符号存在：yf search "company name"
  • 部分数据（期权、股息）并非适用于所有证券

技术说明

  • 使用 PEP 723 内联脚本元数据管理 uv 依赖项
  • Rich 库提供带颜色和格式的表格
  • 首次运行时会将依赖项安装到 uv 缓存中（约 5 秒）
  • 后续运行会立即完成（使用缓存环境）
  • 通过备用值妥善处理 NaN/None 值

评论

支持 Markdown