1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | yahoo-finance2 | — |
| 作者/维护者 | Gadi Cohen（个人开发者，GitHub 账号 2010 年创建，另有 211 名关注者），与 Pilwon Huh 共同署名版权 | GitHub API |
| 来源链接 | https://github.com/gadicc/yahoo-finance2 | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars | 767 | GitHub API |
| Forks | 105 | GitHub API |
| 最新版本 | v4（当前主版本，通过 npm 持续发布） | 官方 README |
| 安装方式 | npx skills add gadicc/yahoo-finance2（Agent Skill）或 npm install yahoo-finance2（库本体） |
官方 README |
2. 功能介绍与亮点
yahoo-finance2 是一个非官方的 Yahoo Finance 数据客户端，前身项目可追溯至 2013 年，由开源社区持续维护至今。核心能力覆盖十余个数据模块：quote（实时报价）、chart/historical（历史行情）、quoteSummary（含资产概况、财务报表、机构持股、评级等数十个子模块）、fundamentalsTimeSeries（财务时间序列）、screener（预设选股器，如当日涨跌幅榜）、options（期权链）、search、trendingSymbols 等。
主要亮点：
- TypeScript 编写，返回结果自动做 JSON Schema 校验并转换为类型安全对象（如日期字段自动转成
Date） - 同时提供 CLI 命令行工具与只读 MCP Server，可直接接入 Codex、Claude、Cursor、VS Code 等支持 MCP 的客户端
- 支持 Node、Deno、Bun、Cloudflare Workers 多种运行时
- 文档体系完整：README、独立 docs 目录、JSR 平台的完整 API 文档、CLI/MCP 专项文档、版本升级指南一应俱全
- npm 包月下载量 645,332 次（2026-06-21 至 2026-07-20 统计区间），是被广泛使用的成熟基础库
3. 适用场景
所属分类：数据分析与可视化
适合需要在 agent 工作流中获取股票、基金等金融数据的开发者与分析者：例如构建选股/回测脚本、投资组合监控面板、财务报表自动化分析，或让 agent 在开发含行情数据展示功能的应用时直接调用真实数据源做测试。
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库内
.claude/skills直接链接到skills/yahoo-finance2/SKILL.md，遵循标准 Agent Skill 格式 - Codex：需适配——仓库另有通用的
.agents/skills目录组织 skill 文件，README 提及 MCP Server 可接入 Codex，但 SKILL.md 在 Codex 中的直接消费方式未见专门文档说明 - OpenClaw：未验证——未见相关材料
- Hermes Agent：未验证——未见相关材料
5. 推荐理由
无需申请 API key、无需付费即可获取覆盖行情、财报、期权、机构持仓在内的完整金融数据集，CLI、库、MCP、Agent Skill 四种接入方式一体化，十余年社区维护与月均 60 万+ 的 npm 下载量验证了它的可靠性。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 仓库 767 stars，同时 npm 月下载量达 64.5 万次；GitHub issue 区有多条来自不同用户（如 AbhigyanBafna、pazer001、CristianSpatari、eddie-atkinson 等）的独立高互动讨论帖，反映真实的多来源活跃使用 |
| 可用性 | 9 | 一条命令即可安装（npx skills add gadicc/yahoo-finance2），文档体系完整（README+docs+JSR API 文档+CLI/MCP 专项说明），近一周内仍有代码提交，完全免费无付费依赖，且支持多运行时 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：
- shell 命令执行范围：CLI 为标准 Node 脚本，运行范围限于自身查询逻辑，未见执行任意 shell 命令或访问无关系统资源
- 联网外发：会联网请求 Yahoo Finance 数据接口，这正是其功能本身，用途透明；SKILL.md/README 中未发现其他隐藏的数据外发行为
- API key/凭据：不需要用户提供任何 API key 或凭据，无凭据存储环节
- 可疑指令：完整阅读 SKILL.md 与 README 全文，未发现面向 agent 的可疑指令或 prompt injection 迹象
- 作者信誉：作者 Gadi Cohen 为长期活跃的个人开发者（GitHub 账号 2010 年注册，150+ 公开仓库），未见刷星或 SEO 操纵措辞
- License：MIT，明确
- 最近维护：近一周内有代码提交，issue 区有持续的维护者回应记录
7. 跟同类 Skills 相比的优势
| Skill/服务 | 定位 | 与本 skill 的差异 |
|---|---|---|
| Alpha Vantage MCP Server（Alpha Vantage 官方，188 stars） | 官方股票/外汇/加密货币数据 API 的 MCP 封装 | 需要注册申请 API key，免费额度有限（官方文档标注为每日 25 次请求）；yahoo-finance2 无需 key、无每日请求数硬上限，但属非官方接口，稳定性依赖 Yahoo 未公开维护的页面结构 |
| Alpaca MCP Server（Alpaca 官方） | 面向实盘/模拟交易执行的经纪商 MCP 接口，行情数据是配套能力 | 定位偏交易执行，需开通 Alpaca 经纪账户并配置交易 API key，权限范围更大；yahoo-finance2 是纯只读数据查询，不涉及账户与下单能力，权限面更小更安全 |
8. 用户评价
GitHub 用户 eddie-atkinson 在 issue #719 中反馈该库在 Cloudflare Workers 环境下因依赖 ajv 校验库而报错，并与维护者 gadicc 详细讨论了移除该依赖的技术方案；随后由 eddie-atkinson 提交的修复 PR #772 被合并，使库得以在 Cloudflare Workers 等边缘运行时环境正常工作，体现出该项目有真实的第三方开发者参与协作维护。
9. 其他补充
项目同时维护 v3 与 v4 两版文档供不同版本用户查阅，并提供基于 CodeSandbox 的在线 Demo（Next.js 环境，含 RSC 与 Hook 两种用法示例），便于快速上手评估。
10. 安装使用方式
- Agent Skill 方式：
npx skills add gadicc/yahoo-finance2 - npm 库方式：
npm install yahoo-finance2，随后import YahooFinance from "yahoo-finance2"使用 - CLI 方式：
npx yahoo-finance2 quote AAPL、npx yahoo-finance2 search AMZN等，无需预先安装 - MCP 方式：
npx -y -p yahoo-finance2 yahoo-finance-mcp，适用于支持 MCP 的 agent 客户端 - 安装后无需重启，agent 在涉及股票/基金行情、财报、期权等金融数据查询任务时可直接调用
11. 注意事项
- 本项目为非官方接口，不代表 Yahoo 官方承诺数据可用性或格式稳定性；GitHub issue 历史显示 Yahoo 曾多次调整验证机制（如 cookie/crumb 校验）导致库短暂失效，维护者通常会较快跟进修复
- 请求频率过高可能触发 Yahoo 侧限流（issue 中有用户反馈遇到 429 Too Many Requests），高频场景建议自行控制并发与请求间隔
- 仅设计用于服务端/边缘运行时环境，浏览器端直接调用会遇到 CORS 限制
- 股票退市后 Yahoo 会连带清除其历史数据，此前可查询的数据可能变为不可获取