前言¶
做 A 股盯盤時,常見做法是開交易軟件盯屏,或用腳本定時拉行情再自己比對閾值。前者佔注意力,後者要把查詢、日誌和告警拆成多套小工具。若你已經在 Cursor、Claude Code 等環境裏用 Skill 擴展 Agent 能力,可以把「查價、巡檢、記日誌、改監控列表」收斂到一條對話或一條定時任務裏。下面介紹 SkillHub 上的 股票交易監測系統(座標 @user_62138798/stock-price-monitor,v1.0.0),它面向 A 股實時行情與價格/漲跌幅預警,官方說明稱使用過程中不消耗 token,適合低成本長期掛着檢查。
這是什麼¶
股票交易監測系統(Stock Monitor)是社區來源(community)的 Agent Skill,分類爲 data-analysis,發佈者爲 user_62138798。Skill 通過新浪財經接口(文檔寫明爲 hq.sinajs.cn)獲取 A 股行情,在本地腳本中完成查詢、預警判斷和日級價格日誌。標籤 requires_api_key=false,無需額外申請 API Key。
當用戶提到「股票」「監控」「股價」「預警」「查股價」「看行情」等意圖時,Agent 可按 Skill 說明選用對應指令。
核心功能¶
依據官方簡介與 Skill 文檔,能力可歸納爲四類:
-
實時查詢(
query/查詢)
返回配置中所有監控標的的實時價格與漲跌幅。 -
預警檢查(
check/檢查)
執行一輪行情檢查;價格觸高/觸低或漲跌幅觸及閾值時返回告警文案,否則可返回「指標正常」類提示(具體文案以腳本返回爲準)。 -
日誌(
log/日誌,log_history/歷史日誌)
log查看當日價格日誌(開盤/收盤/最高/最低及預警記錄);log_history查看最近 7 天摘要。日誌文件爲scripts/stock_daily_log.json,在check/query時自動更新。 -
配置管理
通過scripts/stock_config.json維護監控標的、價格上下限、漲跌幅閾值,以及檢查間隔、是否每日僅提醒一次等選項。
文檔還說明:盤前或休市時價格爲 0 或昨收無效會跳過;同日同條件告警可配置爲只提醒一次(only_once 推薦 true)。
安裝與啓用¶
安裝 SkillHub CLI(若尚未安裝)¶
先確認本機是否已有 CLI:
command -v skillhub && skillhub --version
未安裝時,可按 SkillHub 官方安裝文檔執行完整安裝(示例爲推薦方式):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安裝本 Skill¶
SkillHub 頁面給出的安裝提示爲:參照 SkillHub 安裝說明,安裝 @user_62138798/stock-price-monitor。
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄,否則默認裝到 ./skills/ 可能不會被識別。常見路徑示例:
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/
示例命令(將目錄換成你當前環境對應路徑):
skillhub install @user_62138798/stock-price-monitor --dir ~/.cursor/skills/
安裝完成後,按你所用客戶端的要求刷新或重啓 Agent,以便加載新 Skill。
配置文件¶
編輯 Skill 目錄下 scripts/stock_config.json。文檔中的字段含義如下:
{
"stocks": [
{
"code": "688599",
"name": "天合光能",
"price_high": 17,
"price_low": 15,
"rise_pct": 99,
"fall_pct": -99
}
],
"check_interval": 30,
"only_once": true
}
code:股票代碼(6 開頭上證,非 6 開頭深證)name:名稱(便於日誌與輸出閱讀)price_high/price_low:價格預警上下限rise_pct/fall_pct:漲跌幅預警閾值(文檔示例用 ±99 表示可視爲禁用漲跌幅預警)check_interval:檢查間隔相關配置(與定時任務配合時使用)only_once:是否同一自然日對同條件告警只提醒一次
典型用法¶
在對話裏讓 Agent 執行¶
直接向 Agent 說明意圖即可,例如「用股票交易監測系統查一下當前監控列表行情」或「執行 check 看有沒有預警」。Skill 將 run() 映射到以下指令(中英文均可):
| 指令 | 說明 |
|---|---|
check / 檢查 |
一輪檢查,有預警則返回告警 |
query / 查詢 |
所有監控標的實時價與漲跌幅 |
log / 日誌 |
當日價格與預警日誌 |
log_history / 歷史日誌 |
近 7 日日誌摘要 |
命令行直接調用¶
進入 Skill 的 scripts 目錄後執行:
cd <skill-dir>/scripts/
python3 stock_monitor_skill.py check
python3 stock_monitor_skill.py query
python3 stock_monitor_skill.py log
python3 stock_monitor_skill.py log_history
定時巡檢(OpenClaw / Clawdbot 示例)¶
文檔給出了用 Cron 週期性觸發 check 的示例(間隔與 payload 可按需調整):
openclaw-cn cron add \
--name "股票交易監控系統" \
--every 120000 \
--payload '{"kind":"systemEvent","text":"【股票交易監控系統 檢查】運行 stock_monitor_skill 的 check 函數,觸發真實告警才彙報,否則保持沉默。"}' \
--session-target main
建議檢查頻率爲交易時段內每 1–5 分鐘一次;非交易時段腳本會按文檔邏輯跳過無效行情。
適用場景與注意¶
適合誰
- 已在 Agent 工作流裏處理資訊或自動化任務,希望把少量自選股的價格/漲跌幅閾值檢查嵌進對話或定時任務。
- 需要本地日級開盤、收盤、最高、最低與預警時間留檔,而不是隻在聊天裏臨時問一次價。
限制與注意
- 行情依賴新浪財經公開接口,字段爲文檔所述的精簡格式(現價、漲跌額、漲跌幅、成交量、成交額等),不適合作爲唯一交易決策依據。
- 僅覆蓋 Skill 文檔描述的 A 股代碼規則與行情邏輯;港股、美股等不在本文覈實範圍內。
- 定時任務、Cron 集成示例針對 Clawdbot/OpenClaw 生態;其他客戶端需自行把「週期性執行
check」映射到各自的調度方式。 - SkillHub 頁面標註版本 v1.0.0;商店統計(截至頁面展示)評分 100000、下載 5293 次,安裝數爲 0(以 SkillHub 列表爲準)。
結尾¶
股票交易監測系統把 A 股查價、閾值預警、日日誌和配置維護收進一個 Skill:Agent 側用 query / check / log 等指令即可驅動,本地用 stock_config.json 管標的與閾值,並可配合定時任務做靜默巡檢。官方入口:
- API 座標頁:https://api.skillhub.cn/user_62138798/stock-price-monitor
- SkillHub 展示頁:https://www.skillhub.cn/skills/user_62138798/stock-price-monitor