微信扫一扫clw-twse-monitor — 台股即時監控與推播通知
透過臺灣證券交易所 OpenAPI 監控個股行情、董監事持股、月營收、公司治理等，主動推播至 Telegram（含 iPhone / Apple Watch）
前置依賴
無。純 Python 3 標準庫（urllib.request + json + sqlite3），免 API Key。
核心腳本
$SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py
設定檔
~/.twse_monitor_config.json
含：watchlist（關注清單）、thresholds（各股閾值）、Telegram Bot 設定。
資料庫
~/.twse_monitor.db
SQLite，含 stocks（持有成本+行情）和 seen_items（去重快取）兩張表。
十大監控模組
監控模式（可任意組合，一次指定多個）
python3 $SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py --check-messages
python3 $SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py --check-messages --check-market
python3 $SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py --daily
| 參數 | 說明 | 觸發條件 |
|------|------|----------|
| --check-messages | 個股重大訊息 | 有新訊息才推 |
| --check-dividend | 除權除息預告 | 有新預告才推 |
| --check-valuation | 殖利率/本益比/淨值比 | 有變動才推 |
| --check-price | 個股日成交行情 | 每日首次推 |
| --check-threshold | 股價閾值（漲跌停/價格/百分比） | 觸發才推 |
| --check-realtime | 盤中即時報價 + 閾值 | 每 10 分鐘（盤中） |
| --check-bfp | 四大買賣點（BFP） | 有買/賣訊號 |
| --check-alert | 注意/處置/變更交易/暫停交易 | 關注股入列才推 |
| --check-insider | 董監事持股轉讓+持股明細 | 有新申報才推 |
| --check-revenue | 月營收+EPS+財測差異 | 有新資料才推 |
| --check-governance | 裁罰/違規/經營權異動/ESG | 有新事件才推 |
| --check-market | 大盤指數+台灣50+加權歷史 | 每次都推 |
--daily：一次跑以上全部（不含 realtime、price、threshold、bfp，另有獨立 cron）。
管理模式
# 設定持有成本
python3 $SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py --cost 2330 2150
# 查詢 DB（格式化表格）
python3 $SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py --show-db
python3 $SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py --show-db --table stocks
# 查詢設定檔（美觀分段）
python3 $SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py --show-config
Debug 模式
python3 $SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py --debug --check-threshold
# Log 寫入 /tmp/twse_monitor.log，含所有判斷過程
閾值設定
以 2330 台積電為例，完整欄位：
| 欄位 | 預設值 | 說明 |
|------|--------|------|
| max_price | close + 10 | 漲破此價位 → 🟡 警告 |
| min_price | close - 10 | 跌破此價位 → 🟡 警告 |
| max_pct_up | 5 | 單日漲幅 > 5% → 🔵 參考 |
| max_pct_down | 5 | 單日跌幅 > 5% → 🔵 參考 |
| circuit_up | true | 漲停通知（±10%） |
| circuit_down | true | 跌停通知 |
| circuit_pct | 10 | 漲跌停幅度 |
支援三種格式：
- 絕對數值：
2400 - 相對差額：
"+10"/"-10"（close ± 10） - 百分比：
"+5%"/"-5%"/"90%"（close × 1.05 / 0.95 / 0.90）
通知分級
| 等級 | 觸發條件 | iPhone / Apple Watch | |------|----------|----------------------| | 🔴 緊急 | 漲停/跌停/裁罰/經營權+變更交易 | 響鈴 + 抬手 | | 🟡 警告 | 價格閾值/違反申報/經營權異動 | 響鈴 | | 🟠 警告 | 變更交易 | 響鈴 | | 🔵 參考 | 百分比警告/ESG 揭露 | 一般推播 | | ⚠️ | 注意股票 | 一般推播 |
Cron Job 配置
7 個 Job 的完整配置（OpenClaw + crontab 雙格式）見 references/twse-monitor-cron.md。
參考文件
| 文件 | 說明 |
|------|------|
| references/twse-monitor-usage.md | 完整使用手冊（10 模組用法+範例） |
| references/twse-monitor-cron.md | Cron Job 配置指南（雙格式） |
| references/twse-api-reference.md | TWSE OpenAPI 143 endpoints 完整清單 |
常見操作速查
# 每日總檢查
python3 $SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py --daily
# 盤中即時報價（每 10 分鐘）
python3 $SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py --check-realtime
# 收盤行情 + 閾值 + BFP（14:00）
python3 $SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py --check-price --check-threshold --check-bfp
# 設定持有成本
python3 $SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py -cost 2330 2150
# 查看所有 DB 資料
python3 $SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py --show-db
# 查看設定檔
python3 $SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py --show-config
# Debug 模式
python3 $SKILL_DIR/clw-twse-monitor/scripts/twse_monitor_v2.py --debug --check-threshold