mcpField
Y
yahoo-finance

yahoo-finance

github.com/kirkluokun其他6640 次安装32 周前更新
代码仓库

关于 yahoo-finance

yahoo-finance 是一款通过 yfinance 获取股票和市场数据的 Python 命令行工具,提供报价、基本面、财报、期权、历史价格、比较和代码搜索命令。

主要功能

  1. 01查询股价与详细报价
  2. 02查看基本面、财报和公司资料
  3. 03查看股息与分析师评级
  4. 04查询期权链和价格历史
  5. 05搜索代码并比较证券

适用场景

  1. 01查看股票代码的当前价格
  2. 02了解公司基本面与财报
  3. 03比较多种证券
  4. 04查询历史价格或期权

安装

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

$npx skills add https://github.com/kirkluokun/awesome-a-stock-openclawskills --skill yahoo-finance

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

附带文件_meta.jsonUntitled

详细介绍

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