总安装量 29
评分人数 43
核心用法
Yahoo Finance CLI 是一款基于 Python 的命令行工具，通过 yfinance 库封装 Yahoo Finance 的公开数据接口。用户可通过简洁的命令语法快速获取多维度金融数据：基础用法包括 yf AAPL 快速查价、、yf quote MSFT 获取详细报价、、yf fundamentals NVDA 查看估值指标（PE、EPS、ROE 等）、yf earnings TSLA 追踪财报日程与历史惊喜、、yf options SPY 分析期权链数据、、yf dividends KO 查询股息信息、、yf ratings AAPL 获取分析师评级分布，以及 yf compare 进行多股横向对比。工具支持全球多市场标的，包括美股、印度 NSE/BSE、加密货币、外汇及 ETF，时间周期覆盖 1 天至历史最大范围。
显著优点
零成本接入：无需 API 密钥或付费订阅，直接调用 Yahoo Finance 的公开数据接口，大幅降低个人投资者和小型团队的数据获取门槛。极速部署：采用 Astral 开发的 uv 包管理器与 PEP 723 内联脚本元数据技术，首次运行自动安装依赖并缓存，后续启动近乎瞬时。专业级输出：集成 rich 库实现彩色表格化展示，数据可读性远超原始 JSON 或 CSV 格式。多市场覆盖：原生支持美股、印度股市、加密货币、外汇及 ETF 的符号体系，满足全球化资产配置需求。模块化设计：命令结构清晰，支持价格、基本面、期权、股息等垂直场景的快速切换。
潜在缺点与局限性
数据源依赖性：完全依赖 Yahoo Finance 的免费接口，存在服务稳定性风险；Yahoo 可能随时调整接口策略或加强反爬机制。频率限制：未明确说明但存在隐含的访问频率上限，高频调用可能触发 IP 临时封禁。数据时效性：免费接口存在 15-20 分钟延迟，不适用于高频交易或实时套利场景。功能边界：不支持交易执行、组合回测、技术指标计算等进阶功能，定位为纯数据查询工具。脚本可见性：主执行文件 yf 未在仓库中直接展示，用户需自行审查实际代码逻辑。
适合的目标群体
个人投资者：需要快速查询持仓标的行情、财报日程、股息记录的日常投资者。金融分析师：进行初步标的筛选、同业对比、估值速查的研究人员。开发者与量化爱好者：作为数据获取层集成至自动化工作流，或用于策略原型验证。教育工作者：金融市场教学场景中演示实时数据获取与基本面分析。小型资管团队：预算有限但需要覆盖多市场基础数据的初创团队。
使用风险
网络与合规风险：工具需持续访问外部 Yahoo Finance 服务器，企业内网环境可能需要配置代理白名单；需遵守 Yahoo 的服务条款，避免商业级高频抓取。数据准确性风险：免费金融数据可能存在拆分/分红调整误差，关键决策建议交叉验证官方交易所数据。依赖维护风险：yfinance 库需跟随 Yahoo 接口变更持续更新，长期稳定性取决于社区维护力度。性能瓶颈：大规模批量查询（如全市场扫描）可能触发限流，建议增加请求间隔或采用本地缓存策略。