# sklinks — 資料來源庫

> 由 `sklinks` agent 維護。每筆含：端點 / 用途 / 可信度 / 存取備註 / **資料應用情境**。
> 最後更新：2026-06-03。使用前請驗證連結仍可用、注意延遲與授權。

---

## ✅ 可用（已實測 2026-06-03）

### 1. TWSE MIS 即時報價 + 五檔 API ★核心
- **端點**：`https://mis.twse.com.tw/stock/api/getStockInfo.jsp?ex_ch=tse_<代號>.tw&json=1&delay=0`
- **必帶 Header**：`Referer: https://mis.twse.com.tw/stock/index.jsp`、`User-Agent`
- **規則**：上市 `tse_`、上櫃 `otc_`；多檔用 `|` 串接 `ex_ch=tse_2330.tw|tse_2344.tw`
- **欄位**：`o`開 `h`高 `l`低 `y`昨收 `z`成交 `u`漲停 `w`跌停 `v`累計量 `a/f`五檔賣價/量 `b/g`五檔買價/量 `t`時間
- **可信度**：高（官方）｜**免費**｜即時（盤中約 5 秒延遲）｜JSON
- **資料應用情境**：
  - `sksession` → 盤中即時報價、開高走低判讀、尾盤觀察
  - `skvolumn` → 五檔買賣壓、委買委賣合計、停損停利掛單分布
  - 即時報價頁 / HTML 看板（如 winbond_2344.html）

### 2. TWSE OpenAPI — 個股日成交 STOCK_DAY_ALL ★核心
- **端點**：`https://openapi.twse.com.tw/v1/exchangeReport/STOCK_DAY_ALL`
- **內容**：全上市個股「**前一交易日**」收盤資料，無需 date 參數（給最新日）
- **欄位**：`TradeVolume`成交股數 `TradeValue`成交金額 `OpeningPrice/HighestPrice/LowestPrice/ClosingPrice` `Change`漲跌 `Transaction`成交筆數
- **可信度**：高（官方）｜免費｜日更（盤後）｜JSON ~1300 檔
- **衍生算法**：昨收=收盤−漲跌；振幅%=(高−低)/昨收；漲跌%=漲跌/昨收
- **資料應用情境**：
  - `skvolumn` → **振幅/成交值排名**（短線活躍度 proxy）、量價分布
  - `sktestimony` → 跨族群篩選（AI概念股/金融股/ETF 比較）
  - **本次用它做 AI概念股·金融股·0050 短線主導排名**

### 3. TWSE OpenAPI — 本益比/殖利率/淨值比 BWIBBU_ALL
- **端點**：`https://openapi.twse.com.tw/v1/exchangeReport/BWIBBU_ALL`
- **內容**：全個股 PE、PB、殖利率｜官方｜免費｜日更
- **資料應用情境**：`sktestimony` 估值篩選、`skprice` 估值面預期

### 4. TWSE OpenAPI — 月均價 STOCK_DAY_AVG_ALL
- **端點**：`https://openapi.twse.com.tw/v1/exchangeReport/STOCK_DAY_AVG_ALL`
- **內容**：個股收盤價 + 月平均價｜官方｜免費
- **資料應用情境**：`skvolumn` 成本均線 / 平均成本帶推估

### 5. TWSE OpenAPI — 可當沖清單 TWTB4U
- **端點**：`https://openapi.twse.com.tw/v1/exchangeReport/TWTB4U`
- **內容**：當日**得**現股當沖的標的清單（Code/Name/Suspension），**不含當沖量**
- **資料應用情境**：`skvolumn` 確認標的是否可當沖（短線交易前提）

### 6. TWSE OpenAPI 服務目錄（swagger）
- **端點**：`https://openapi.twse.com.tw/v1/swagger.json`
- **資料應用情境**：`sklinks` 探索證交所所有開放端點

### 7. Yahoo Finance Chart API（美股 / 歷史K線）
- **端點**：`https://query1.finance.yahoo.com/v8/finance/chart/<symbol>?interval=1d&range=1mo`
- **可信度**：中高｜免費｜美股即時 + 歷史
- **資料應用情境**：`skverify` 歷史價量回推、美股標的（MU/NVDA）報價

### 8. MOPS 公開資訊觀測站 — 公司基本資料 API（新版）★實測可用
- **端點**：`POST https://mops.twse.com.tw/mops/api/t05st03`
- **Header**：`Content-Type: application/json`、`Referer: https://mops.twse.com.tw/mops/`
- **Body(JSON)**：`{"companyId":"2344"}`（可加 `"year":"114","month":"06"`）
- **回傳**：公司名、產業別、上市日、董事長、發言人、股務代理等（官方最高可信）
- **注意**：新版 MOPS 多數事件端點（重訊/法說/股利）名稱不固定、易導轉至 `/mops`；
  事件類建議改用 WebSearch（見下方 SOP）。`co_id`/表單格式會回 500，**必須 JSON body**。
- **資料應用情境**：`sktestimony` 公司輪廓、`skdate` 抓發言人/股務、`skboard` 標的基本面錨

---

## ⚠️ 嘗試但目前取不到（記錄以免重複踩雷）

### A. 當日沖銷成交量值統計（含當沖比重）— 取不到
- **嘗試端點**：`https://www.twse.com.tw/rwd/zh/afterTrading/TWTB4U?date=&response=json`（302/404）
- **狀況**：`rwd` 報表路徑被導轉 / 404；OpenAPI 的 `TWTBAU1/TWTBAU2` 實為「暫停當沖名單」非比重
- **影響**：**「當沖比重」無法直接取得** → 短線主導改用「振幅+成交值」proxy
- **待辦（todo）**：找正確當沖比重端點，或改抓 TWSE 網頁版 twtb4u.html 解析

### B. 流通在外股數（算週轉率必需）— 未取得
- **狀況**：需 `t187ap03_L`（公司基本資料）或集保資料；尚未串接
- **影響**：**「週轉率 = 成交量/流通股數」無法精算** → 平均持有時間僅能定性推估
- **待辦（todo）**：串 MOPS 基本資料或集保戶股權分散表

---

## 📌 待擴充（已知但未串接）
- **公開資訊觀測站 MOPS** `https://mops.twse.com.tw` — 財報/重訊（官方最高可信）→ skprice/sktestimony/skdate
- **集保戶股權分散表**（週更）— 大戶散戶持股、持有人數 → skvolumn 籌碼推論
- **TWSE 三大法人買賣超 / 融資券** — 籌碼面 → skvolumn
- **財經媒體**：經濟日報 / 工商 / 鉅亨Anue / MoneyDJ — 新聞（核對發佈日期，交 skverify）

---

## 📋 SOP：填實個股的 skdate（事件時點）＋ skverify（情報覆盤）

> 用於任一個股的完整分析。以 `<代號>` 代入（如 2344），市場別上市=`tse`/`sii`、上櫃=`otc`。

### 步驟 1 — 公司基本面錨（skdate / sktestimony）
- 打 MOPS `t05st03`（來源 #8）取產業別、上市日、發言人 → 確認標的輪廓。

### 步驟 2 — 抓事件行事曆（skdate）
- WebSearch：`<公司名> <代號> 2026 法說會 除權息 股東會 財報 日期`
- 補**法定財報期限**（台股固定）：Q1→5/15、半年報 Q2→8/14、Q3→11/14、年報→3/31；月營收→每月 10 日前。
- 整理成時間軸：**已過催化** vs **未到事件**，每筆標絕對日期。
- 判讀：目前距上一個大催化多久 → 是「事件空窗/利多消化期」還是「臨近催化」。

### 步驟 3 — 蒐集事前情報（skverify）★核對發佈日期
- WebSearch：`<公司名> <代號> 目標價 法人 看好/看法 <近月>`；題材面：`<產業> 漲價/景氣 TrendForce`。
- 也可用 Google 搜尋頁直接掃（使用者提供的 `google.com/search?q=<公司名>` 方式）。
- **鐵則**：只採計**發佈日早於「要驗證的波動日」**的情報＝事前；之後的＝事後諸葛，排除。
- 每則標：來源 / 發佈日 / 主張（方向·目標價）/ 事前或事後。

### 步驟 4 — 比對「預期 vs 結果」（skverify 結論）
- 把事前情報的主流預期，對照實際價量結果（如開高走低、是否衝過目標價）。
- 常見模式：**情報看多且基本面對，但股價已衝過/達到目標價 → 利多 price in → 達標獲利了結（利多出盡）**。
- 結論回饋 `skprice`（校正樂觀偏誤）與 `sklinks`（更新該來源可信度）。

### 步驟 5 — 寫回決策表
- 更新該個股頁的 skdate / skverify 兩列、偏空/偏多卡與淨結論。

> 範例：華邦電 2344（2026-06-03）。事前 5/29 目標價調升至 183、6/1 升價潮看多；
> 今日開 188＞183 已達標 → 開高走低爆量＝利多出盡。詳見 `winbond_2344.html`。

---

## 成本紅線
以上皆為**免費 / 官方**來源。任何付費 API（如即時 Level2、付費籌碼）一律先標「付費」、須先取得授權，預設只進 todo，優先用免費 + Claude Pro Max 方案。