| 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
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:.10f}"
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 = net_income / equity * 100
roa = net_income / total_assets * 100
fcf = operating_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:.1f}% 超過 100%，數據可能有誤'})
elif gm < -50:
warnings.append({'level': 'error', 'field': f'{yr} 毛利率',
'msg': f'{gm:.1f}% 低於 -50%，請確認是否為特殊損失年度'})
cr = m.get('current_ratio')
if cr is not None and cr < 0:
warnings.append({'level': 'error', 'field': f'{yr} 流動比率',
'msg': f'{cr:.1f}% 為負值，請檢查資產負債表數據'})
dr = m.get()
dr dr > :
warnings.append({: , : ,
: })
roe = m.get()
roe roe > :
warnings.append({: , : ,
: })
nm_list = [(yr, metrics[yr].get()) yr years yr metrics]
i (, (nm_list)):
yr_prev, nm_prev = nm_list[i-]
yr_curr, nm_curr = nm_list[i]
nm_prev nm_curr :
(nm_curr - nm_prev) > :
warnings.append({: ,
: ,
: })
warnings
result[] = {
: sanity_check(metrics_by_year, years[:]),
: (w[] != w 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 =>▲ 高速成長 +40%
毛利率54.4%56.1%■ 高檔震盪
負債比率57.9%61.4%▼ 突破60%，需關注
趨勢評估文字規則：
▲ + 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、或絕對變化）
- 原因推斷或意義（一句話說明為什麼）
各分頁的核心觀察方向
📊 經營分析亮點：
- 三年營收趨勢與 CAGR，點名最新年的關鍵驅動因素
- 毛利率是否有結構性改善（品項組合 vs 成本控制）
- 費用率是否隨營收成長而下降（規模效益），研發投入是否維持
- 營業利益率的三年趨勢與費用攤薄效益
💰 獲利分析亮點：
- EPS 三年數列 + 最新年 YoY，是否創新高
- 淨利成長是否超過營收成長（利潤率擴張）
- ROE 趨勢，說明改善或惡化原因（淨利 vs 股東權益變化）
- 現金股利三年趨勢，換算配息率或成長幅度
🏦 財務健全度亮點：
- 流動比率三年趨勢，是否高於 150%（健康）或 200%（優異）
- 負債比率三年趨勢，是否接近或超過 60%（需關注）
- 現金部位變化，說明增減原因（配息、資本支出、CF 情況）
- 營業 CF 與淨利比較（> 1 為佳），自由現金流是否充裕
步驟五：輸出
- 儲存 HTML 檔案至工作目錄，檔名格式：
{公司縮寫}_{股票代碼}_analysis.html
- 提供下載連結
- 用 2–3 句話摘要三大維度的核心發現（含具體數字）
- 附上驗證狀態：
- 若有合理性警示（
sanity_pass == False）→ 明確提醒用戶檢查具體欄位
- 一律附上 MOPS 連結，讓用戶可自行核對原始申報
注意事項
- Goodinfo.tw 抓取時若
CLIENT_KEY 失效，重新計算 days_adjusted（使用當前時間戳）
- 若某年度數據缺失（顯示為
- 或空白），在圖表中以 null 處理，不要填入 0
- 金額單位統一為億元（Goodinfo.tw 預設顯示）
- 分析期間預設為最近三年，但可依用戶需求調整
- 此 skill 僅適用於台灣上市/上櫃公司（4位數股票代碼）
- 欄位名稱因公司不同略有差異，抓取時需以關鍵字模糊比對而非完全匹配
