用途：为智能体提供 Yahoo Finance 市场数据的确定性命令行访问，可在本地复合使用（组合、自选列表、历史缓存），适合从被限流主机上完成会话。仅暴露只读命令，用于检查、导出、同步与分析，不用于创建、更新、删除、发布、下单或任何改变远程状态的操作。
主要能力：
- 本地复合状态：portfolio perf 跟踪持仓的 YTD/1Y/全时段收益，含成本基础、股息与现价；portfolio dividends 给出年度股息收入、逐项拆分与成本收益率；digest 一条命令输出隔夜新闻、最大涨跌、今日财报与除息日；insiders-net-buying 筛选近期内部人净买入。
- 智能体原生计算：options-chain 按 ATM/OTM/ITM 与到期天数过滤期权链；screen-local 对本地同步数据运行自定义 P/E、P/B、收益率、利润率与增长筛选；compare 比较含股息的多标的总回报；options-covered-calls 扫描持仓中的备兑看涨候选；watchlist correlate 计算自选列表内成对皮尔逊相关。
- 可达性缓解：auth login --chrome 在 IP 被限流（429）时导入 Chrome 会话 cookie。
必要用法：
- 安装 CLI：npx -y @mvanhorn/printing-press-library install yahoo-finance --cli-only；验证：yahoo-finance-pp-cli --version。若 npx 失败，可用 go install github.com/mvanhorn/printing-press-library/library/commerce/yahoo-finance/cmd/yahoo-finance-pp-cli@latest（需 Go 1.26.6 或更新）。若命令找不到，需将安装目录加入 $PATH，验证成功前不要继续调用。
- 运行 doctor 验证环境配置。
- 任意命令加 --agent，展开为 --json --compact --no-input --no-color --yes；输出 JSON 到 stdout，错误到 stderr；用 --select 保留字段子集，用 --dry-run 预览请求。
- 支持 --deliver 输出到 stdout、file:<path> 或 webhook:<url>；可用 profile save/show/list/delete 保存命名配置，显式参数优先于 profile。
- MCP 服务安装：go install github.com/mvanhorn/printing-press-library/library/commerce/yahoo-finance/cmd/yahoo-finance-pp-mcp@latest，并注册 claude mcp add yahoo-finance-pp-mcp -- yahoo-finance-pp-mcp。
认证：Yahoo Finance 无 API key，需要 crumb+cookie 握手；CLI 首次调用自动获取并持久化 cookie。若 IP 受限，运行 auth login --chrome。
限制：只读，不支持任何修改操作；某些数据依赖本地同步；限流时返回退出码 7。资料未提供收费、价格与效果等更多信息。