Stock Market Pro

# Stock Market Pro

**Stock Market Pro** 是一个快速、本地优先的市场研究工具包。 获取清晰的价格与基本面数据，生成带有指标面板（RSI/MACD/BB/VWAP/ATR）的出版级图表，并运行一次性报告，输出摘要和高分辨率 PNG。 可选附加功能：快速新闻链接扫描 (DDG) + 浏览器优先的期权/资金流 (Unusual Whales)。

## 你可以做什么 - 获取 **实时报价**（价格 + 变动） - 汇总 **基本面**（市值、远期市盈率、每股收益、净资产收益率） - 打印 **ASCII 趋势**（终端友好） - 生成带有叠加层/面板的 **高分辨率 PNG 图表**： - RSI / MACD / 布林带 / VWAP / ATR - 运行 **一次性报告**，打印紧凑摘要并输出图表路径 - 通过 DuckDuckGo (ddgs) 搜索 **新闻链接** - 打开 **期权 / 资金流页面**（浏览器优先，Unusual Whales）

---

## 命令（本地）

> 本技能使用 `uv run --script` 进行依赖处理。 > 如果你没有 `uv`：请从 https://github.com/astral-sh/uv 安装

### 1) 报价 ```bash uv run --script scripts/yf.py price TSLA # shorthand uv run --script scripts/yf.py TSLA ```

### 2) 基本面 ```bash uv run --script scripts/yf.py fundamentals NVDA ```

### 3) ASCII 趋势 ```bash uv run --script scripts/yf.py history AAPL 6mo ```

### 4) 专业图表 (PNG) ```bash # candlestick (default) uv run --script scripts/yf.py pro 000660.KS 6mo

# line chart uv run --script scripts/yf.py pro 000660.KS 6mo line ```

#### 指标（可选） ```bash 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) 一次性报告 打印紧凑的文本摘要并生成图表 PNG。

```bash uv run --script scripts/yf.py report 000660.KS 6mo # output includes: CHART_PATH:/tmp/<...>.png ```

> 可选的 Web 附加功能（新闻/期权）可由代理工作流追加。

---

## Web 附加功能（可选）

### A) 新闻搜索（通过 `ddgs` 使用 DuckDuckGo） 本技能内置了一个辅助脚本 (`scripts/ddg_search.py`)。

依赖： ```bash pip3 install -U ddgs ```

运行： ```bash python3 scripts/news.py NVDA --max 8 # or python3 scripts/ddg_search.py "NVDA earnings guidance" --kind news --max 8 --out md ```

### B) 期权 / 资金流（浏览器优先） Unusual Whales 频繁阻止爬虫/无头模式访问。 因此推荐的方法是：**在浏览器中打开页面并总结可见内容**。

快速链接助手： ```bash python3 scripts/options_links.py NVDA ```

常用 URL： - `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) `yf.py` 支持： - `price` - `fundamentals` - `history` - `pro` - `chart` (别名) - `report` - `option` (尽力而为；建议回退到浏览器)

检查： ```bash python3 scripts/yf.py --help ```

## 代码示例 - 美国：`AAPL`, `NVDA`, `TSLA` - 韩国：`005930.KS`, `000660.KS` - 加密货币：`BTC-USD`, `ETH-KRW` - 外汇：`USDKRW=X`