Yahoo Finance

核心功能

Yahoo Finance CLI 是一款基于 Python yfinance 库构建的命令行股票数据工具，提供一站式金融市场数据查询能力。核心功能覆盖：

• 实时行情：快速查询股票价格、涨跌幅、成交量
• 深度报价：完整盘口数据与详细报价信息
• 基本面分析：PE比率、EPS、市值、利润率、ROE/ROA、分析师目标价
• 财报追踪：下次财报日期、EPS预估、历史财报与超预期表现
• 期权链：近价看涨/看跌期权，含执行价、买卖价差、成交量、持仓量、隐含波动率
• 股息信息：股息率、除息日、派息比率、历史分红记录
• 分析师评级：买入/持有/卖出分布、平均评级、近期调级记录
• 公司画像：行业分类、员工规模、业务描述
• 历史行情：支持1天至最大周期的价格历史
• 多股对比：并排对比多只股票的关键指标
• 智能搜索：支持模糊搜索股票名称

显著优点

1. 零门槛使用：无需注册或API密钥，开箱即用
2. 全球市场覆盖：支持美股、印度股市(NSE/BSE)、加密货币、外汇、ETF
3. 极速体验：基于 uv 包管理器，依赖自动缓存，后续运行瞬时响应
4. 格式友好：Rich 库提供彩色表格输出，终端可读性强
5. 灵活部署：单文件 CLI，可符号链接至 PATH 全局调用

潜在局限

• 数据来源依赖：Yahoo Finance 网页结构变更可能导致 yfinance 库临时失效
• 速率限制：高频查询可能触发Yahoo限制，需等待恢复
• 非实时数据：部分数据存在15-20分钟延迟，不适合高频交易决策
• 数据完整性：期权、股息等数据对部分证券不可用
• 无持久化存储：纯查询工具，无本地数据库或历史数据管理功能

适用人群

• 个人投资者进行日常持仓监控与基本面筛选
• 开发者快速验证股票数据或集成至自动化工作流
• 金融分析师需要命令行高效批量查询
• 学习者研究股票市场数据结构与指标计算

风险提示

• T3来源：本项目为个人开发者/社区项目，建议关注更新动态
• 外部依赖：运行时依赖 yfinance 库向 Yahoo Finance 服务器发起请求，查询行为可能被记录
• 安装脚本：文档包含 curl | sh 官方安装方式，用户可根据安全策略选择 pip/brew 替代方案
• 投资决策：工具数据仅供参考，不构成投资建议

核心功能与用法

Yahoo Finance CLI 是一款围绕 yfinance Python 库构建的命令行工具，通过简单的 yf <命令> <代码> 语法即可调取 Yahoo Finance 的海量金融数据。主要指令覆盖：

• 快速报价 (yf AAPL 或 yf price AAPL)：实时股价与涨跌
• 详细行情 (yf quote MSFT)：盘口数据、成交量、52 周区间
• 基本面分析 (yf fundamentals NVDA)：PE、EPS、市值、利润率、ROE/ROA、分析师目标价
• 财报日历 (yf earnings TSLA)：下次财报日期、EPS 预估与历史惊喜值
• 公司档案 (yf profile GOOGL)：行业、员工数、总部地址、业务描述
• 股息追踪 (yf dividends KO)：股息率、除息日、派息比率与近期历史
• 期权链 (yf options SPY)：平价附近看涨/看跌期权的行权价、买卖价差、成交量、持仓量、隐含波动率
• 历史 K 线 (yf history <代码> <周期>)：支持 1d 至 max 多档周期
• 横向对比 (yf compare AAPL,MSFT,GOOGL)：多标的价格、涨跌幅、市值并排比较
• 模糊搜索 (yf search "bitcoin")：解决股票代码记忆难题

符号体系兼容美股 (AAPL)、印度 NSE/BSE (RELIANCE.NS)、加密货币 (BTC-USD)、外汇 (EURUSD=X) 及主流 ETF。

显著优点

1. 零 API 密钥：依托 Yahoo Finance 公开数据，开箱即用，无付费墙或注册流程。
2. 极速依赖管理：采用 uv + PEP 723 内联元数据，首次运行自动安装依赖，后续秒启。
3. 终端原生体验：Rich 库渲染的彩色表格，在 CLI 中实现媲美 GUI 的可读性。
4. 多资产类别：股票、ETF、期权、外汇、加密货币一站式查询，适合全球化投资组合。
5. 轻量无守护：纯脚本工具，无后台服务，随用随走，资源占用极低。

潜在局限与风险

• 数据源限制：Yahoo Finance 为非官方实时数据，延迟约 15 分钟（美股），且存在不定期接口变动导致数据中断的历史案例。
• 速率限制：高频调用易触发 IP 限流，需人工冷却等待，不适合程序化高频交易。
• 期权数据不全：部分小盘股或远期合约可能无期权链数据。
• 地区合规：印度、欧盟等地区用户需注意 Yahoo Finance 数据服务的当地监管限制。
• 安装依赖 curl|sh：文档推荐 curl | sh 安装 uv，虽 astral.sh 为可信域名（Ruff/uv 官方），但仍存在供应链劫持的理论风险。

适合人群

• 个人投资者与量化爱好者：快速验证投资假设、监控持仓。
• 财务分析师：批量抓取基本面数据生成内部报告。
• 开发者/数据科学家：作为 yfinance 的 CLI 封装，快速原型验证。
• 终端重度用户：拒绝臃肿金融终端，偏好键盘驱动的效率工具。

常规风险提示

• 市场数据非投资建议：工具仅提供数据聚合，不含任何投资逻辑或风控机制。
• T3 来源审慎原则：维护者 ajanraj 为个人开发者，建议关注项目更新频率，长期无更新时评估替代方案。
• 网络层安全：工具本身无加密凭证处理，但调用 Yahoo Finance API 时数据通过 TLS 传输，符合常规安全基准。