← Back to Skills Marketplace
Clw Twse Monitor
by
gentoobreaking
· GitHub ↗
· v1.0.0
· MIT-0
38
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install clw-twse-monitor
Description
台股即時監控與推播通知（v2）。當用戶提及台股監控、股價通知、漲停跌停、董監事持股、月營收、注意股票、處置股票、ESG、大盤指數、除權除息、殖利率、持股成本、未實現損益、四大買賣點、盤中即時報價、TWSE、證交所相關需求時使用此技能。覆蓋十二大場景：(1) 重大訊息——個股每日重大訊息掃描 (2) 除權除息——除...
README (SKILL.md)
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
Usage Guidance
This result is low confidence because the artifact files could not be inspected. Re-run the review in an environment where metadata.json and artifact/ are readable before relying on this assessment.
Capability Tags
Capability Assessment
Purpose & Capability
Unable to assess purpose and capability coherence because attempts to inspect metadata.json and artifact files failed before file contents could be read.
Instruction Scope
Unable to assess runtime instruction scope from artifacts due the same workspace inspection failure.
Install Mechanism
Unable to assess installation behavior because install artifacts were not readable in this run.
Credentials
Unable to compare requested environment access against the skill purpose because artifact contents were unavailable.
Persistence & Privilege
Unable to determine whether persistence or privilege requests exist because artifact contents were unavailable.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install clw-twse-monitor - After installation, invoke the skill by name or use
/clw-twse-monitor - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
clw-twse-monitor 1.0.0 首次發佈，提供台股十二大場景即時監控與 Telegram 通知。
- 支援個股重大訊息、除權除息、殖利率/本益比變動、即時和收盤報價、漲跌停警報、四大買賣點等多場景監控
- 可自定監控股清單、報價閾值、持有成本，並用 SQLite 儲存紀錄
- 無需 API Key，純 Python3 標準庫即可運行
- 管理功能包括設定成本、查詢資料庫、檢查設定檔
- 通知分級明確、適配 iPhone / Apple Watch 推播需求
Metadata
Frequently Asked Questions
What is Clw Twse Monitor?
台股即時監控與推播通知（v2）。當用戶提及台股監控、股價通知、漲停跌停、董監事持股、月營收、注意股票、處置股票、ESG、大盤指數、除權除息、殖利率、持股成本、未實現損益、四大買賣點、盤中即時報價、TWSE、證交所相關需求時使用此技能。覆蓋十二大場景：(1) 重大訊息——個股每日重大訊息掃描 (2) 除權除息——除... It is an AI Agent Skill for Claude Code / OpenClaw, with 38 downloads so far.
How do I install Clw Twse Monitor?
Run "/install clw-twse-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Clw Twse Monitor free?
Yes, Clw Twse Monitor is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Clw Twse Monitor support?
Clw Twse Monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Clw Twse Monitor?
It is built and maintained by gentoobreaking (@openclawchen8-lgtm); the current version is v1.0.0.
More Skills