核心用法
stock-monitor-hkus 是一款面向港股、美股及加密货币的轻量级实时监控技能,基于 Python 的 yfinance 库获取 Yahoo Finance 公开数据。用户通过编辑 config.py 自定义股票池,运行 monitor.py 即可获取实时价格、5日涨跌幅、成交量及 MA5/MA10 均线数据。系统内置四种信号判断逻辑(持有/观望/上涨/下跌),支持 cron 定时任务(每5分钟)或 OpenClaw 原生 cron 实现自动化监控,输出结果保存至 JSON 状态文件便于持久化追踪。
显著优点
1. 零成本数据源:依赖 Yahoo Finance 免费 API,无需申请 API Key 或支付数据订阅费用
2. 极简部署:单文件 Python 脚本架构,仅依赖 yfinance 单个包,5 分钟完成环境搭建
3. 跨市场覆盖:原生支持港股(.HK后缀)、美股(纯代码)、加密货币(-USD后缀)三类资产
4. 技术指标内置:自动计算 MA5/MA10 并生成交叉信号,降低技术分析门槛
5. 自动化友好:标准 cron 与 OpenClaw cron 双模式兼容,适合服务器长期驻留
潜在局限
1. 数据延迟与可靠性:Yahoo Finance 免费接口存在 15-30 分钟延迟,且偶有服务中断或反爬限制,不适合高频交易或实时套利场景
2. 功能边界清晰:仅覆盖价格与基础均线,缺乏成交量加权、MACD、RSI、布林带等进阶指标
3. 无交易执行能力:纯监控预警,不支持券商 API 直连下单,信号到执行存在人工延迟
4. 本地化限制:港股代码需手动添加 .HK 后缀,对 A 股、期货、期权等市场无支持
5. 依赖管理风险:--break-system-packages 安装方式暗示系统级 Python 环境,存在依赖冲突隐患
适合人群
- 中长期持仓的个人投资者,需要定时掌握持仓波动而非秒级盯盘
- 技术入门者希望理解均线策略的自动化实现
- 多市场配置用户(港股+美股+加密)寻求统一监控面板
常规风险
- 市场风险:技术指标信号存在滞后性,均线交叉策略在震荡行情中可能产生频繁假信号
- 数据风险:Yahoo Finance 服务条款变更或 IP 封禁可能导致监控中断,建议搭配备用数据源
- 操作风险:cron 任务若配置不当(如路径错误)可能产生静默失败,需定期检查日志