Stock Market Pro 是一个快速、本地优先的市场研究工具包，核心数据来源为 Yahoo Finance（yfinance）。它侧重于命令行使用，可获取干净的价格与基本面数据、生成可直接使用的图表，并通过一次性报告同时输出文字摘要与高分辨率 PNG 图片。此外提供可选的网络附加功能：新闻链接搜索与期权/资金流页面查看。
用途
- 市场行情与基本面研究：获取实时报价（价格与涨跌幅）、汇总基本面指标（市值、Forward PE、EPS、ROE）。
- 趋势与图表呈现：在终端打印 ASCII 趋势；生成高分辨率 PNG 图表，支持叠加与指标面板。
- 一次性报告：输出紧凑文本摘要并生成图表文件路径。
- 可选网络附加：通过 DuckDuckGo（ddgs）搜索新闻链接；以浏览器优先方式打开 Unusual Whales 的期权/资金流页面。
主要能力
- 实时报价与基本面摘要。
- ASCII 趋势（终端友好）。
- 高分辨率 PNG 图表：默认蜡烛图，可切换折线图；可叠加 RSI、MACD、布林带、VWAP、ATR 指标面板。
- 一次性报告：打印紧凑摘要并输出 CHART_PATH 图表路径。
- 新闻搜索：通过 ddgs 助手脚本按关键词搜索新闻并按 Markdown 等格式输出。
- 期权/资金流链接助手：生成常用 Unusual Whales 页面链接；由于该站点常阻止抓取/无头访问，建议在浏览器中打开并自行总结可见内容。
使用方式 依赖处理使用 uv run --script；如未安装 uv，可从 https://github.com/astral-sh/uv 安装。 1）报价：uv run --script scripts/yf.py price TSLA，或简写 uv run --script scripts/yf.py TSLA 2）基本面：uv run --script scripts/yf.py fundamentals NVDA 3）ASCII 趋势：uv run --script scripts/yf.py history AAPL 6mo 4）专业图表（PNG）：uv run --script scripts/yf.py pro 000660.KS 6mo（默认蜡烛图）；折线图 uv run --script scripts/yf.py pro 000660.KS 6mo line 指标（可选）：uv run --script scripts/yf.py pro TSLA 6mo --rsi --macd --bb；uv run --script scripts/yf.py pro TSLA 6mo --vwap --atr。其中 --rsi 为 RSI(14)，--macd 为 MACD(12,26,9)，--bb 为布林带(20,2)，--vwap 为所选区间累计 VWAP，--atr 为 ATR(14)。 5）一次性报告：uv run --script scripts/yf.py report 000660.KS 6mo，输出包含 CHART_PATH:/tmp/<...>.png。 可选网络附加： A）新闻搜索：先安装依赖 pip3 install -U ddgs；运行 python3 scripts/news.py NVDA --max 8，或 python3 scripts/ddg_search.py "NVDA earnings guidance" --kind news --max 8 --out md。 B）期权/资金流（浏览器优先）：运行 python3 scripts/options_links.py NVDA 获取链接；常用页面包括 https://unusualwhales.com/stock/{TICKER}/overview、https://unusualwhales.com/live-options-flow?ticker_symbol={TICKER}、https://unusualwhales.com/stock/{TICKER}/options-flow-history。 子命令：yf.py 支持 price、fundamentals、history、pro、chart（别名）、report、option（尽力而为，推荐浏览器回退）；可用 python3 scripts/yf.py --help 查看。 股票代码示例：美股 AAPL、NVDA、TSLA；韩股 005930.KS、000660.KS；加密货币 BTC-USD、ETH-KRW；外汇 USDKRW=X。
适用场景
- 在终端中快速查看行情与基本面。
- 生成带技术指标面板的图表用于研究或分享。
- 以脚本方式批量或自动化执行市场研究流程。
- 快速汇总新闻线索并定位期权/资金流页面。
限制
- 数据质量与可用性依赖 Yahoo Finance（yfinance）及其返回结果。
- 期权/资金流以浏览器优先，Unusual Whales 常阻止抓取与无头访问，脚本仅提供链接与尽力而为的选项子命令。
- 新闻搜索依赖 ddgs 及其来源。
- 关于是否收费、价格、具体平台适配与效果表现，资料暂未提供。