Yahoo Finance CLI

📈 实时股价财报·终端金融数据利器

基于 yahoo-finance2 的 Node.js CLI,提供实时股价、财报数据、分析师评级等金融市场数据查询能力

收藏
23.6k
安装
7.1k
版本
1.0.0
CLS 安全性认证2026-05-06
点击查看完整报告 >

使用说明

核心用法

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 文件可能包含追踪标识 |

建议:仅用于辅助决策,关键交易请交叉验证官方数据源。

安全解读

核心功能

yahoo-finance 是一款基于 Node.js 的专业金融数据查询工具,通过封装知名的 yahoo-finance2 开源库,为用户提供 Yahoo Finance 的全面数据访问能力。支持实时股价查询、公司基本面分析、财报日历、分析师评级、历史行情、趋势发现等核心模块,覆盖从散户投资者到专业分析师的多元需求。

显著优点

1. 数据来源权威: 直接对接 Yahoo Finance,全球金融市场覆盖,数据实时性强
2. 模块化设计: quote/quoteSummary/insights/search/chart/trending 六大模块,功能边界清晰

3. JSON 管道友好: 原生输出结构化 JSON,与 jq 无缝配合,便于脚本自动化

4. 零代码依赖: Skill 本身纯文档型,无可执行代码,安全审计负担极低

5. Cookie 自动管理: 依赖库自动处理会话,降低使用门槛

潜在局限

  • Yahoo 服务依赖: 受限于 Yahoo Finance API 稳定性与访问策略,存在间歇性限制风险
  • 非官方 API: 依赖逆向工程接口,无 SLA 保障,重大变更可能导致功能中断
  • 延迟与精度: 免费数据存在 15-20 分钟延迟,不适合高频交易场景
  • 地域限制: 部分市场数据(如 A 股完整数据)覆盖不全

适合人群

  • 个人投资者进行日常行情监控与基本面研究
  • 分析师批量获取财报数据与历史价格
  • 开发者构建自动化投资监控脚本
  • 金融教育者演示市场数据查询流程

常规风险

1. 安装提权: 文档建议 sudo 创建符号链接,属标准 Node.js 全局安装实践,风险可控
2. 网络外连: 自动访问 query*.finance.yahoo.com,需确保网络环境可信

3. Cookie 持久化: 会话数据存储于 ~/.yf2-cookies.json,多用户环境需注意隔离

Yahoo Finance CLI 内容

手动下载zip · 2.1 kB
SKILL.mdtext/markdown
请选择文件