用途：这是一个 Node.js 命令行工具（CLI），用于从 Yahoo Finance 获取股票数据，底层使用 yahoo-finance2 库。适合在终端或脚本中快速查询金融信息。
主要能力：工具以 yf 命令提供多个模块。quote 模块获取实时价格、涨跌和基础数据；quoteSummary 模块获取详细子模块，如 assetProfile（公司信息、行业）、financialData（目标价、利润率、现金）、defaultKeyStatistics（企业价值、流通股、股本）、calendarEvents（财报日期）、earnings（历史与趋势）、recommendationTrend（分析师评级）、upgradeDowngradeHistory；insights 模块获取技术与基本面洞察（估值、前景）；search 模块搜索符号；historical 模块获取历史 OHLCV 数据（已弃用，建议改用 chart）；chart 模块获取历史数据；trendingSymbols 模块查看热门股票。
使用方式：命令格式为 yf <module> <symbol> [queryOptions]。输出为纯 JSON，可管道传给 jq 过滤。示例：yf quote AAPL；yf quote AAPL | jq '.regularMarketPrice'；yf quoteSummary AAPL '{"modules":["assetProfile", "financialData", "defaultKeyStatistics"]}'；yf insights AAPL；yf search "Apple"；yf chart AAPL '{"period1":"2024-01-01","period2":"2024-12-31","interval":"1d"}' | jq '.quotes[0:5]'；yf trendingSymbols US。
安装要求：需要 Node.js、全局安装或可作为 yf 使用的 yahoo-finance2、以及 jq。安装命令：brew install jq；npm install yahoo-finance2；sudo ln -s /opt/homebrew/bin/yahoo-finance /usr/local/bin/yf。
适用场景：适合需要以脚本方式获取股票报价、财报日期、分析师评级、公司概况、历史行情或热门股票列表的用户，尤其便于与 jq 结合做数据提取和自动化处理。
限制与注意事项：historical 模块已弃用，推荐使用 chart。工具自动处理 cookie（存储于 ~/.yf2-cookies.json），若遇到认证或解析错误，可删除该文件后重试：rm -f ~/.yf2-cookies.json。在 macOS 的 zsh 中，JSON 选项参数建议使用单引号包裹，内部使用双引号。若只需紧凑数值，可使用简短 jq 过滤，如 yf quote AAPL | jq -r '.regularMarketPrice'。