# stocks-report

台股個股完整分析報告產生器，自動整合即時行情、法人籌碼、技術指標與本地持股紀錄，輸出排版完整的 Markdown 與 PDF。

## 功能特色

- **雙版本輸出**：專業版（給有經驗的投資人）＋白話解讀版（給入門者）
- **四檔輸出**：每次產出 `.md` + `.pdf` 各兩份
- **自動整合持股**：若本地有 `<代號>-TW.md` 紀錄，自動計算平均成本、含息報酬
- **ETF／個股判別**：`00` 開頭自動走 ETF 流程（持股分析），否則走個股流程（月營收、本益比）

## 報告涵蓋範圍

| 區段 | 內容 |
|------|------|
| 大盤同步 | 加權指數、漲跌、成交金額 |
| 報價 | 現價、開高低收、成交量、均價、最佳五檔 |
| 三大法人 | 外資／投信／自營商買賣超 |
| 主力券商 | 買超／賣超前 5 大券商明細 |
| 融資融券 | 融資融券餘額、券資比 |
| 當沖統計 | 當沖成交量與佔比 |
| 外資持股 | 持有股數與持股比例 |
| 技術面 | RSI14、ATR14、KD、布林通道、近 5 日 K 線 |
| 股利殖利率 | 歷年配息、殖利率、除息日 |
| ETF 持股 | 前十大持股、行業比重、資產分佈（僅 ETF） |
| 月營收 | 當月營收、MoM、YoY、累計（僅個股） |
| 本益比 | PE ratio、股價淨值比（僅個股） |
| 白話判斷 | 綜合技術面＋籌碼面＋配息面的多空結論 |
| 個人持股 | 成本、損益、配息資格（若有本地紀錄） |

## 依賴

- **stocks-query skill**（`../stocks-query/`）：所有資料擷取腳本皆在此
- **Python 套件**：`markdown`、`weasyprint`（PDF 轉換）
- **CJK 字型**：系統需安裝 PingFang TC、Heiti TC 或 Noto Sans CJK TC

## 輸出路徑

```
stocks/
├── <代號>-report-YYYYMMDD.md            專業版 Markdown
├── <代號>-report-YYYYMMDD.pdf           專業版 PDF
├── <代號>-report-YYYYMMDD-beginner.md   白話解讀版 Markdown
└── <代號>-report-YYYYMMDD-beginner.pdf  白話解讀版 PDF
```

## 透過 Claude Code 使用

本工具已註冊為 Claude Code skill。在對話中使用 `/stocks-report` 加上股票代號即可觸發：

```
/stocks-report 2330
/stocks-report 00922
```

## 注意事項

- 報告內容禁止使用 emoji，以避免 weasyprint 嵌入 Apple Color Emoji 字型導致 PDF 開啟錯誤
- 白話版使用純文字標記：`[+]` 正面、`[!]` 留意、`[-]` 負面
- 所有內容皆為繁體中文（台灣），日期使用西元格式，金額使用千分位

## 授權

內部工具，僅供個人使用。