taiwan-stock-analysis

name taiwan-stock-analysis description 台灣上市上櫃公司三維財務分析儀表板。從 Goodinfo.tw 抓取真實財報數據（損益表、資產負債表、現金流量表），計算關鍵財務指標，生成互動式三分頁 HTML 儀表板（經營分析 / 獲利分析 / 財務健全度）並匯出為可分享的 HTML 檔案。 當使用者提到以下情境時，一定要使用這個 skill： - 「幫我分析 XXXX（股票代碼）」、「財報分析」、「三維分析」 - 「管銷研發費用分析」、「獲利能力」、「財務健全度」 - 提到台灣股票代碼（4位數字）並要求分析 - 「經營/獲利/財務分析」、「幫我看這家公司」 - 任何涉及台股財務數據視覺化的需求 台灣股票三維財務分析 Skill 概述 本 skill 從 Goodinfo.tw 抓取台灣上市/上櫃公司的真實財報數據，計算三大維度的財務指標，並生成一份互動式 HTML 儀表板及下載檔案。 三大分析維度： 📊 經營分析 ：營收成長、毛利率、費用率、管銷研費結構 💰 獲利分析 ：淨利、EPS、ROE、ROA、三層利潤率 🏦 財務健全度 ：流動比率、負債比率、現金流量、現金部位 步驟一：抓取財報數據 使用以下 Python 腳本從 Goodinfo.tw 抓取數據。 重要： Goodinfo.tw 需要特定的 CLIENT_KEY Cookie，公式如下： import requests from bs4 import BeautifulSoup import time def get_goodinfo_data ( stock_id, rpt_cat ): """ rpt_cat 可選：IS_YEAR（損益表）、BS_YEAR（資產負債表）、CF_YEAR（現金流量表） """ tz_offset = - 480 # 台灣 UTC+8 now_ms = time.time() * 1000 days_since_epoch = now_ms / 86400000 days_adjusted = days_since_epoch - tz_offset / 1440 client_key = f"2.8|38057.1435627105|46946.0324515993| {tz_offset} | {days_adjusted} | {days_adjusted} " headers = { 'User-Agent' : 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36' , 'Referer' : 'https://goodinfo.tw/' } cookies = { 'CLIENT_KEY' : client_key} url = f"https://goodinfo.tw/tw/StockFinDetail.asp?RPT_CAT= {rpt_cat} &STOCK_ID= {stock_id} &REINIT= {days_adjusted: .10 f} " r = requests.get(url, headers=headers, cookies=cookies, timeout= 15 ) r.encoding = 'utf-8' return BeautifulSoup(r.text, 'html.parser' ), days_adjusted 解析方式 每種報表的數據都在 HTML 中 最後一個（第 6 個，index=6）大型 table 裡。抓取後迭代所有 <tr> 行，解析每行的第 1 欄（項目名稱）和後續欄位（年度數值）。 ⚠️ 欄位步幅因報表而異（2026-07-11 實測修正） ：損益表/資產負債表每年佔「金額＋%」 兩欄 ，現金流量表每年 僅一欄 且一次列 8 年——用固定步幅會讓現金流量表年度錯位（2024 欄裝到 2023 數據）。解析步幅需自動偵測（ round(資料列欄數 ÷ 年度數) ），並跳過值欄為年度本身的段落標題行（如「投資活動(金額:億元)」）。完成後務必以「現金流量表期末現金 ＝ 資產負債表現金及約當現金」 逐年交叉核對 。 scripts/fetch_goodinfo.py 已內建此邏輯。 三張報表的抓取順序： IS_YEAR → 損益表（營收、毛利、費用、營業利益、淨利、EPS） BS_YEAR → 資產負債表（現金、應收帳款、存貨、流動資產、負債、股東權益） CF_YEAR → 現金流量表（營業CF、投資CF、融資CF、現金股利） 關鍵欄位對照（損益表）： 中文欄位名 用途 營業收入合計 年度營收 營業毛利（毛損） 毛利金額 推銷費用 推銷費用 管理費用 管理費用 研究發展費用 R&D費用 營業利益（損失） 營業利益 稅後淨利 稅後淨利（母公司） 每股稅後盈餘(元) EPS 關鍵欄位對照（資產負債表）： 中文欄位名 用途 現金及約當現金 現金部位 存貨 存貨 流動資產合計 流動資產 流動負債合計 流動負債 負債總額 總負債 股東權益總額 股東權益 資產總額 總資產 關鍵欄位對照（現金流量表）： 中文欄位名 用途 營業活動之淨現金流入（出） 營業CF 投資活動之淨現金流入（出） 投資CF 融資活動之淨現金流入（出） 融資CF 固定資產（增加）減少 資本支出（負值為增加） 發放現金股利 現金股利 若 推銷費用 、 稅後淨利 、 每股稅後盈餘(元) 等欄位名稱在特定公司財報中略有差異，需迭代所有欄位名稱以關鍵字模糊比對（如 '推銷' in k 、 '每股' in k and '盈餘' in k ）。 步驟二：計算衍生指標 從原始數據計算以下指標： # 費用率（各費用 / 營收） sell_ratio = sell_exp / revenue * 100 admin_ratio = admin_exp / revenue * 100 rd_ratio = rd_exp / revenue * 100 total_opex_ratio = (sell_exp + admin_exp + rd_exp) / revenue * 100 # 毛利率、營業利益率、淨利率 gross_margin = gross_profit / revenue * 100 op_margin = op_income / revenue * 100 net_margin = net_income / revenue * 100 # 流動比率、負債比率 current_ratio = current_assets / current_liabilities * 100 debt_ratio = total_liabilities / total_assets * 100 # ROE、ROA roe = net_income / equity * 100 roa = net_income / total_assets * 100 # 自由現金流（使用固定資產增減作為 capex 代理） fcf = operating_cf + capex # capex 為負值（資產增加）時 FCF = op_cf - |capex| 步驟二點五：三層驗證機制 每次抓取完財報數據後，執行以下三層驗證，結果存入 result['verification'] 。 A. 資料來源標注（Provenance） 在 result['metadata'] 中記錄完整的數據血緣： result[ 'metadata' ] = { 'fetched_at' : time.strftime( '%Y-%m-%dT%H:%M:%S+08:00' ), 'source' : 'Goodinfo.tw' , 'source_urls' : { 'income_statement' : f'https://goodinfo.tw/tw/StockFinDetail.asp?RPT_CAT=IS_YEAR&STOCK_ID= {stock_id} ' , 'balance_sheet' : f'https://goodinfo.tw/tw/StockFinDetail.asp?RPT_CAT=BS_YEAR&STOCK_ID= {stock_id} ' , 'cash_flow' : f'https://goodinfo.tw/tw/StockFinDetail.asp?RPT_CAT=CF_YEAR&STOCK_ID= {stock_id} ' , }, 'mops_url' : f'https://mops.twse.com.tw/mops/web/t05st01?step=1&co_id= {stock_id} &TYPEK=sii' , 'mops_url_otc' : f'https://mops.twse.com.tw/mops/web/t05st01?step=1&co_id= {stock_id} &TYPEK=otc' , 'years_covered' : years[: 3 ], 'currency' : 'TWD 億元' , } B. 合理性檢查（Sanity Check） 計算完衍生指標後，執行以下規則，產生 result['verification']['sanity'] 列表： def sanity_check ( metrics, years ): """ metrics 為 {year: {gross_margin, op_margin, net_margin, current_ratio, debt_ratio, roe, roa}} 的字典 回傳 warnings 列表，每項為 {'level': 'warn'|'error', 'field': str, 'msg': str} """ warnings = [] for yr in years: m = metrics.get(yr, {}) gm = m.get( 'gross_margin' ) if gm is not None : if gm > 100 : warnings.append({ 'level' : 'error' , 'field' : f' {yr} 毛利率' , 'msg' : f' {gm: .1 f} % 超過 100%，數據可能有誤' }) elif gm < - 50 : warnings.append({ 'level' : 'error' , 'field' : f' {yr} 毛利率' , 'msg' : f' {gm: .1 f} % 低於 -50%，請確認是否為特殊損失年度' }) cr = m.get( 'current_ratio' ) if cr is not None and cr < 0 : warnings.append({ 'level' : 'error' , 'field' : f' {yr} 流動比率' , 'msg' : f' {cr: .1 f} % 為負值，請檢查資產負債表數據' }) dr = m.get( 'debt_ratio' ) if dr is not None and dr > 100 : warnings.append({ 'level' : 'warn' , 'field' : f' {yr} 負債比率' , 'msg' : f' {dr: .1 f} % 超過 100%，若非金融業則為警示訊號' }) roe = m.get( 'roe' ) if roe is not None and roe > 100 : warnings.append({ 'level' : 'warn' , 'field' : f' {yr} ROE' , 'msg' : f' {roe: .1 f} % 超過 100%，可能為高槓桿，請確認股東權益是否偏低' }) # 相鄰年度淨利率波動檢查 nm_list = [(yr, metrics[yr].get( 'net_margin' )) for yr in years if yr in metrics] for i in range ( 1 , len (nm_list)): yr_prev, nm_prev = nm_list[i- 1 ] yr_curr, nm_curr = nm_list[i] if nm_prev is not None and nm_curr is not None : if abs (nm_curr - nm_prev) > 30 : warnings.append({ 'level' : 'warn' , 'field' : f' {yr_prev} → {yr_curr} 淨利率' , 'msg' : f'波動 {nm_curr - nm_prev:+ .1 f} 個百分點，建議確認是否有一次性損益' }) return warnings result[ 'verification' ] = { 'sanity' : sanity_check(metrics_by_year, years[: 3 ]), 'sanity_pass' : all (w[ 'level' ] != 'error' for w in warnings) } C. MOPS 原始申報連結（D） result['metadata']['mops_url'] （上市）和 mops_url_otc （上櫃）已在步驟 A 記錄，儀表板的驗證列中以連結按鈕呈現，讓使用者可一鍵核對原始申報。 步驟三：建立 HTML 儀表板 直接由 Claude 手寫完整 HTML ，不使用 Python 模板生成。參考 references/dashboard_template.md 的 CSS 與 Chart.js 規格。 儀表板架構 header（公司名稱 + 股票代碼 + 資料來源標注） verify-bar（抓取時間 | 合理性檢查徽章 | MOPS連結按鈕 | Goodinfo原始連結） verify-warnings（若 sanity warnings 不為空才渲染） ├── Tab 1：經營分析 │ ├── KPI Cards（5張）：含具體數字的 kpi-change 說明文字 │ ├── Insight Box（3-5條重點）：🔍 經營亮點 │ ├── Charts（2×2格）：營收+毛利率 / 費用堆疊 / 費用率折線 / 營業利益+利益率 │ └── Data Table：損益表明細（含「趨勢評估」欄） ├── Tab 2：獲利分析 │ ├── KPI Cards（5張）：含具體數字的 kpi-change 說明文字 │ ├── Insight Box：🔍 獲利亮點 │ ├── Charts（2×2格）：淨利+淨利率 / EPS / 三層利潤率 / 現金股利 │ └── Data Table：獲利能力彙總（含「趨勢評估」欄） └── Tab 3：財務健全度 ├── KPI Cards（5張）：含具體數字的 kpi-change 說明文字 ├── Insight Box：🔍 財務健全度亮點 ├── Charts（2×2格）：資產負債結構 / 現金流三表 / 流動+負債比率 / 現金趨勢 └── Data Tables（左右並排）：資產負債表摘要 / 現金流量摘要（均含「趨勢評估」欄） KPI Card 規格 KPI card 的 kpi-change 必須包含具體數字 ，不可只寫方向文字： <!-- ❌ 錯誤：沒有數字 --> < div class = "kpi-change up" > ▲ 持續成長 </ div > <!-- ✅ 正確：含具體數字 + 背景說明 --> < div class = "kpi-change up" > ▲ +18.1% YoY（2024年68,596億），AI伺服器訂單驅動 </ div > < div class = "kpi-change neutral" > ■ 2022年59.6% → 2023年54.4% → 2024年V型反彈至56.1% </ div > < div class = "kpi-change down" > ▼ 三年持續下滑 159% → 155% → 146%，首度低於150%警戒線 </ div > 顏色規則： 🟢 green （ border-left: 4px solid #38a169 ）：正向指標 🔵 blue （ border-left: 4px solid #3182ce ）：中性指標 🟠 orange （ border-left: 4px solid #dd6b20 ）：需關注 🔴 red （ border-left: 4px solid #e53e3e ）：警示 數據表格「趨勢評估」欄規格 每張數據表格必須包含第四欄「趨勢評估」 ，用簡短文字描述趨勢方向與意義： < thead > < tr > < th > 項目 </ th > < th > 2022 </ th > < th > 2023 </ th > < th > 2024 </ th > < th > 趨勢評估 </ th > </ tr > </ thead > < tbody > < tr > < td > 稅後淨利（億元） </ td > < td > 8,385 </ td > < td > 11,733 </ td > < td class = "up" > ▲ 創三年新高 </ td > </ tr > < tr > < td > EPS（元） </ td > < td > 32.34 </ td > < td > 45.25 </ td > < td class = "up" > ▲ 高速成長 +40% </ td > </ tr > < tr > < td > 毛利率 </ td > < td > 54.4% </ td > < td > 56.1% </ td > < td class = "neutral" > ■ 高檔震盪 </ td > </ tr > < tr > < td > 負債比率 </ td > < td > 57.9% </ td > < td > 61.4% </ td > < td class = "down" > ▼ 突破60%，需關注 </ td > </ tr > </ tbody > 趨勢評估文字規則： ▲ + class="up" （綠色）：改善 / 成長 / 創高 ▼ + class="down" （紅色）：惡化 / 衰退 / 低於警戒 ■ + class="neutral" （灰色）：橫盤 / 高檔震盪 / 波動但無明顯方向 文字應包含 一個關鍵事實 （數字或判斷），不超過 12 字 Chart.js 設定 CDN： https://cdn.jsdelivr.net/npm/chart.js@4.5.0/dist/chart.umd.min.js 所有圖表需設 maintainAspectRatio: false ，container 高度固定 240px 組合圖（bar + line）使用雙 Y 軸（ yAxisID: 'y' 和 yAxisID: 'y2' ） Tab 切換： onclick="switchTab('ops')" 搭配 event.target.classList.add('active') 常見 HTML 格式錯誤（務必避免） KPI card 中的 kpi-change div 結尾只能用 </div> ，不能混入 </td></tr> 所有 <canvas> 需包在 class="chart-container" 的 div 內（含固定高度 240px） 數據表格的「趨勢評估」欄 <td> 需搭配顏色 class（ up / down / neutral ） 步驟四：Insight Box 撰寫規範 每個分頁的 insight box 標題用 🔍 {分頁名}亮點 ，包含 4–5 條具體數字觀察 。 必須符合的格式要求 ❌ 不合格：「營收有所成長」（無數字、無幅度） ❌ 不合格：「毛利率略有下降」（無具體數值） ✅ 合格：「三年營收 61,622 → 68,596 → 81,031 億，CAGR +14.6%，2025年加速成長 +18.1%，AI伺服器訂單驅動」 ✅ 合格：「2023年營業CF為 -982 億（異常），係大量備料AI伺服器存貨所致；2024年存貨消化後強勁回復至 4,456 億，現金轉換能力確認」 每條觀察應包含： 起點 → 終點數字 （或三年數列） 幅度 （YoY %、CAGR、或絕對變化） 原因推斷或意義 （一句話說明為什麼） 各分頁的核心觀察方向