核心用法
Yahoo Finance CLI 是一个 Node.js 命令行工具,封装了 yahoo-finance2 库,用于获取 Yahoo Finance 的金融数据。通过 yf <module> <symbol> [queryOptions] 的简洁语法,支持多种数据模块:
| 模块 | 用途 |
|------|------|
| `quote` | 实时股价、涨跌幅 |
| `quoteSummary` | 财报数据、公司资料、分析师评级、 earnings 日历等 |
| `insights` | 技术面与基本面估值洞察 |
| `search` | 股票代码搜索 |
| `chart` | 历史 OHLCV 数据 |
| `trendingSymbols` | 热门股票 |
所有输出为 JSON 格式,推荐配合 jq 进行过滤提取,如 yf quote AAPL | jq '.regularMarketPrice'。
显著优点
1. 数据全面:覆盖报价、基本面、技术面、分析师观点、历史数据等维度
2. 实时性强:直接对接 Yahoo Finance API,延迟低
3. Unix 友好:纯 JSON 输出,管道化设计,适合脚本自动化
4. 免费开源:基于 yahoo-finance2(MIT 许可),无 API Key 门槛
潜在缺点与局限
- 非官方 API:依赖 Yahoo Finance 的非公开接口,存在随时变更或限制的风险
- Cookie 依赖:需要维护
~/.yf2-cookies.json,偶发需手动清理 - 无 SLA:数据准确性、完整性无保障,不适合作为交易核心依据
- 频率限制:未明确披露,但高频调用可能触发风控
- 地域限制:部分市场数据覆盖不全
适合人群
- 个人投资者进行快速行情查询和基础研究
- 开发者构建自动化财报监控、估值筛选脚本
- 量化研究者获取免费历史数据样本
- CLI 重度用户整合到日常终端工作流
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据可靠性 | 非官方数据源,可能存在延迟或错误 |
| 服务稳定性 | 接口变更可能导致工具突然失效 |
| 合规性 | 商业用途需确认 Yahoo Finance ToS 许可 |
| 隐私 | Cookie 文件可能包含追踪标识 |
建议:仅用于辅助决策,关键交易请交叉验证官方数据源。