用途：在服务端 JavaScript/TypeScript 应用中接入 Yahoo Finance 市场数据，或使用其 CLI、MCP 服务器；也用于参与该仓库的 Deno 源码、测试、schema 与 npm 构建开发。这是非官方客户端，不应描述为受支持的 Yahoo API，也不保证数据可用性、时效性或结构。
主要能力：v3 类 API，如 new YahooFinance() 后调用 quote、chart、historical、quoteSummary、fundamentalsTimeSeries、options、screener、search、trendingSymbols、recommendationsBySymbol、insights 等模块。quote 支持单符号或数组，可用 fields 限制载荷；quoteCombine 可合并多次单符号请求；chart 支持 period1、period2、interval 及分红拆股事件；quoteSummary 按需请求模块；筛选器替代已移除的涨跌榜模块。
使用方式：仅限服务端、无服务器、边缘、Deno、Bun 或 Node 环境，不要放入浏览器客户端包。调用应包裹 try/catch，网络错误、API 错误、退市符号、缺失数据和校验失败均属正常情况。默认会校验并转换数据，失败时优先修正类型接口并重新生成 schema，而非关闭校验；仅在调用方自行检查时用 validateResult: false。可用构造函数或单次调用队列选项限制并发。CLI 示例：npx yahoo-finance2 quote AAPL；MCP：npx -y -p yahoo-finance2 yahoo-finance-mcp。
仓库贡献：Deno 优先，npm 输出为生成物，应编辑 src/ 而非 npm/。修改 @yf-schema 导出接口后运行 deno task schema；测试用 deno task test，聚焦测试可指定文件，涉及 Yahoo HTTP 的测试应调用 setupCache()。构建检查包括 deno fmt、deno lint、deno task test、deno task build:npm。提交信息使用带 scope 的 Conventional Commits。安装技能：npx skills add gadicc/yahoo-finance2。
限制：非官方、数据不保证；浏览器端不可直接调用；部分 quote-summary 财务报表模块自 2024 年末起数据稀少，应改用 fundamentalsTimeSeries。具体收费、价格、平台支持等资料暂未提供。