80 lines
3.5 KiB
Markdown
80 lines
3.5 KiB
Markdown
# 腳本摘要
|
||
|
||
## 架構概覽
|
||
|
||
```
|
||
scripts/
|
||
├── Browserless 腳本（需 headless browser）
|
||
│ ├── yahoo-quote-browserless.py 報價
|
||
│ ├── yahoo-institutional-browserless.py 法人買賣超
|
||
│ ├── yahoo-technical-browserless.py 技術指標
|
||
│ ├── yahoo-market-browserless.py 大盤指數
|
||
│ ├── yahoo-dividend-browserless.py 股利政策
|
||
│ └── yahoo-broker-trading-browserless.py 主力券商
|
||
│
|
||
├── Yahoo 直接 API（免 Browserless）
|
||
│ ├── yahoo-etf-holdings.py ETF 持股分析
|
||
│ ├── yahoo-ma-signal.py 均線訊號
|
||
│ └── yahoo-macd-signal.py MACD 訊號
|
||
│
|
||
└── TWSE 公開 API（免 Browserless）
|
||
├── twse-margin-trading.py 融資融券
|
||
├── twse-day-trading.py 當沖統計
|
||
└── twse-foreign-holdings.py 外資持股
|
||
```
|
||
|
||
## 各腳本輸出欄位
|
||
|
||
### yahoo-quote-browserless.py
|
||
現價、漲跌（金額＋百分比）、開盤、最高、最低、昨收、成交量（張＋股數）、均價、最佳買價／賣價、市場狀態、資料時間
|
||
|
||
### yahoo-institutional-browserless.py
|
||
日期、外資買賣超（張）、投信買賣超（張）、自營商買賣超（張）、三大法人合計
|
||
|
||
### yahoo-technical-browserless.py
|
||
近 5 日 K 線（開高低收）、RSI14、ATR14、K 值、D 值、布林上軌／中軌／下軌
|
||
|
||
### yahoo-market-browserless.py
|
||
加權指數、漲跌（點數＋百分比）、開盤、最高、最低、昨收、成交金額（億）、資料時間
|
||
|
||
### yahoo-dividend-browserless.py
|
||
現金殖利率、現金股利、股票股利、除息日、發放日、近年股利歷史（年度／現金／股票／合計）
|
||
|
||
### yahoo-broker-trading-browserless.py
|
||
日期、買超前 5 大券商（買進／賣出／差額張數）、賣超前 5 大券商
|
||
|
||
### yahoo-etf-holdings.py
|
||
前十大持股（排名／名稱／占比）、行業比重、資產分佈；支援 text／json／csv 輸出格式
|
||
|
||
### yahoo-ma-signal.py
|
||
收盤價、MA5／10／20／60、20 日乖離率、趨勢判讀（站上月線／跌破月線、中期偏多／偏弱等）
|
||
|
||
### yahoo-macd-signal.py
|
||
DIF、DEA、HIST、訊號判讀（金叉／死叉／多頭延續／空頭延續／震盪）
|
||
|
||
### twse-margin-trading.py
|
||
日期、融資買進／賣出／現償／餘額／限額、融券賣出／買進／現償／餘額／限額、券資比
|
||
|
||
### twse-day-trading.py
|
||
日期、當沖買進股數、當沖賣出股數、當沖成交金額、當沖佔比
|
||
|
||
### twse-foreign-holdings.py
|
||
日期、外資持股股數、外資持股比率、發行股數、尚可投資股數、投資上限比率
|
||
|
||
## 資料來源
|
||
|
||
| 來源 | 用途 | 備註 |
|
||
|------|------|------|
|
||
| Yahoo 奇摩股市 (tw.stock.yahoo.com) | 報價、法人、技術、股利、券商、ETF | 需透過 Browserless 渲染 JS |
|
||
| Yahoo Finance Chart API (query1.finance.yahoo.com) | 均線、MACD、技術面 K 線 | 直接 HTTP GET，回傳 JSON |
|
||
| 證交所 TWSE (www.twse.com.tw) | 融資融券、當沖、外資持股 | 公開 JSON API，免認證 |
|
||
|
||
## 共通設計模式
|
||
|
||
- **輸入**：股票代號作為第一個命令列參數，未提供時使用預設值
|
||
- **輸出**：繁體中文條列式摘要，印到 stdout
|
||
- **錯誤**：訊息印到 stderr，exit code 1
|
||
- **依賴**：僅 Python 標準函式庫（urllib、json、re、datetime 等）
|
||
- **日期回溯**：TWSE 腳本自動往前找最多 10 個工作日的資料
|
||
- **環境變數**：Browserless 腳本從 `.env` 載入，支援多路徑搜尋
|