Published on

在純靜態部落格打造私人台股看板:Firebase + Cloudflare Worker 串接紀錄

Authors

平常家人要看持股比例和資產配置時,常常得切換好幾個不同的券商 App,而且各家 App 的統計功能都不太完整,很難一次看清整體配置、均線位置或目標進度。

既然自己已經有一個 Next.js 靜態部落格(部署在 Firebase Hosting),乾脆直接在上面開一個隱藏頁面(不進導覽列、加上 noindex、從 sitemap 排除),做成自己跟家人專用的台股持股與追蹤看板。

整套架構全程維持免費額度就能跑,這篇文章主要記錄背後的技術選型,以及串接各家第三方 API 時遇到的眉角。

整體架構

因為部落格本身是純靜態輸出,沒有 Node.js 後端可用,所以把責任拆給兩個免費的 Serverless 服務:

瀏覽器(Next.js 純靜態頁,全 client-side)
  ├──▶ Firebase Auth(Google 登入)
  ├──▶ Firestore(持股、目標設定、操作紀錄;rules 白名單控管)
  └──▶ Cloudflare Worker(自訂網域代理 API + KV 快取)
         ├── /quote ──▶ TWSE MIS(上市/上櫃即時快照)
         ├── /ma    ──▶ TWSE / TPEx 日線(失敗自動 fallback Yahoo Finance)
         └── /div   ──▶ Yahoo Finance(今年除息事件加總)

權限與資料儲存:Firebase Auth + Firestore

既然是掛在公開網域上的私人頁面,第一個問題就是權限控制。做法是**「登入不擋、資料層擋」**:

  1. Google 登入:前端直接用 Firebase v10 modular SDK 的 signInWithPopup 處理登入。
  2. 白名單寫在 firestore.rules:不是在前端 if/else 判斷 email,而是直接在 Firestore Security Rules 檢查 request.auth.token.email_verified 與白名單清單。非白名單的帳號就算登入了,讀寫任何資料都會被資料庫直接拒絕,前端再依權限錯誤顯示無權限畫面。
  3. 單文件模型 + Audit Trail:每位使用者的持股、追蹤清單與資產配置目標都存在 users/{uid} 單一文件裡,減少讀寫次數;另外建了一個 users/{uid}/logs 子集合記錄每次異動,在 rules 上只開放 read 與 create,做成不可修改刪除的操作紀錄。

中間有個小插曲:這個 Firebase 專案比較早建立,打開 Firestore 才發現是 2020 年遺留的 Datastore mode(新版 Firebase SDK 不支援),確認裡面沒有資料後只好整顆刪掉重建成 Native mode (asia-east1) 才順利接上。

第三方行情串接:Cloudflare Worker + KV

台股報價跟日線資料沒有辦法在瀏覽器直接打,最主要的原因是台股官方 API 幾乎都沒有開 CORS,加上直接從前端打也很容易被限流或暴露查詢邏輯,因此用 Cloudflare Worker 寫了一個輕量中繼層,僅對自己的網域開放 CORS 白名單。

因為原本網域的 DNS 就在 Cloudflare 上,Worker 可以直接綁定子網域(而且不會動到 apex 網域指向 Firebase Hosting 的設定)。實際串接了三個端點:

1. /quote:TWSE MIS 即時快照

串接證交所的 mis.twse.com.tw API,這個端點的好處是上市(tse)跟上櫃(otc)可以混在一起一次批量查詢。實作上順手處理了幾個細節:

  • 市場別快取:一開始不知道某檔股票是上市還是上櫃時,同時組 tse_{code}.tw 和 otc_{code}.tw 去查;查到有昨收價的那一邊後,就把市場別寫進 Workers KV(mkt:{symbol}),下次就能直接精準查詢,減少一半的 channel 數量。
  • 大小寫敏感:像 00679B 這類債券或主動式 ETF,MIS API 對字尾英文字母大小寫是敏感的,送出前必須確保代號轉成大寫。
  • 盤後與無成交退回:盤後或當下沒有新成交時,即時成交價欄位 z 會回傳 '-',這時候要依序退回最近成交價(pz)、開盤價(oz)或昨收(y),畫面上才不會突然變成空白。

2. /ma:MA20(月線)/MA60(季線)現算與反爬備援

台股習慣看月線跟季線,但官方沒有直接給計算好的均線 API,所以策略是 on-demand 抓近 4 個月的日線收盤價自己算(60 個交易日大約 3 個月,多抓 1 個月當連假緩衝)。

這裡踩到一個很經典的坑:櫃買中心(TPEx)會封鎖資料中心 IP。從 Cloudflare Worker 出口去打 TPEx 的 tradingStock 端點時,偶爾會被 302 導向 /errors 錯誤頁。

解法有三個:

  1. 打 TPEx 時 fetch 加上 redirect: 'manual',一遇到轉址就直接判定官方源失敗。
  2. 抓多個月份時每次請求中間加一點延遲(sleep(300)),避免過於密集。
  3. 自動 Fallback Yahoo Finance:只要 TWSE 或 TPEx 任一失敗,就自動改打 query1.finance.yahoo.com 的 Chart API(依市場別加上 .TW 或 .TWO)抓日線回來算;而且如果上游失敗就直接報錯,寧可不快取也不寫入殘缺的均線資料。

算完之後將結果存進 Workers KV,TTL 設為「距離下一個台北時間 18:00 的秒數」(收盤檔通常傍晚前更新完畢),這樣同一天內不管重開幾次頁面,都直接吃 KV 快取,不用重打官方伺服器。

3. /div:今年累積配息

後來為了算現金流進度,又補了一個 /div 端點。直接向 Yahoo Finance 請求 range=1y&interval=1d&events=div,把回傳的除息事件依台北時間(UTC+8)過濾出今年的 ex-date 加總,同樣用 KV 快取到下一個 18:00。

前端細節:不引入圖表套件與平行載入

前端全部走 client-side 渲染,後來也陸續把版面從手機優先卡片改成了比較適合分析的桌機表格與分類視覺化。

UI 上的取捨是不額外安裝 Chart.js 或 Recharts 這類圖表套件。不管是資產分布的圓餅圖(Donut Chart)還是橫向目標比較條,全部只用 CSS conic-gradient 搭配 Tailwind Flexbox 做出來,bundle size 幾乎沒有多餘負擔,維護起來也很單純。

在載入效能上,行情快照是一次批量向 /quote 查詢,而各檔的 /ma 與 /div 則透過平行請求搭配 Cache-Control: private, max-age=3600,加上 Worker 端有 KV 快取撐著,開頁幾秒內就能把整張表的損益、均線與配息狀態刷出來。

心得後記

這個頁面從最初只是想「看現價+算毛損益」,後來一路配合投資分類習慣演化出不同目標佔比與橫向比較條,中間大概改了二十幾個小階段。

最大的體會是:私人工具不需要過度設計。不用為了這個頁面去維護一台 VPS 或升級付費資料庫,用 Firebase Spark + Cloudflare Worker 免費額度 就能穩穩跑起來;把原本麻煩的 CORS、反爬跟快取邏輯收進短短三百多行的 Worker 裡,前端就能專心處理版面跟自己的資料模型,維護起來非常輕鬆。

參考資料