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 開啟錯誤
• 白話版使用純文字標記：[+] 正面、[!] 留意、[-] 負面
• 所有內容皆為繁體中文（台灣），日期使用西元格式，金額使用千分位

授權

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