Stock Monitor

核心功能

本技能提供跨市场的股票价格实时监控，覆盖 A 股、港股、美股三大市场。通过解析 Yahoo Finance API 数据，用户可配置多只股票及其基准价格，系统按设定周期自动轮询检测。

显著优点
1. 跨市场覆盖：统一支持 A 股（.SS）、港股（.HK）、美股（无后缀）的代码体系，降低多账户切换成本
2. 智能预警机制：区分「首次预警」（±2%）与「续警」（±1%），避免单一方向波动导致的频繁骚扰，同时确保重大波动不被遗漏
3. 状态持久化：自动保存 stocks_alert.json 记录预警历史，跨会话保持连续性
4. 开源可控：本地 Python 脚本运行，无需提交持仓数据至第三方平台，隐私边界清晰

潜在局限与风险

• 数据源依赖：Yahoo Finance 对 A 股数据覆盖偶有延迟或缺失，极端行情下 API 可能限流
• 无交易联动：仅提供价格提醒，不支持自动下单或盈亏计算，需人工决策
• 阈值静态化：2%/1% 的阈值在代码中写死，非高级用户无法动态调整
• 时区敏感：美股交易时段与定时任务时区需手动对齐，否则可能错过开盘波动

适合人群

• 持仓 5-20 只、需要被动监控而非主动盯盘的中小投资者
• 跨市场配置（如同时持有茅台+腾讯+拼多多）的全球化投资者
• 对数据隐私敏感、拒绝券商 App 推送的用户

常规风险
Yahoo Finance 为非官方交易所数据渠道，存在 15 分钟延迟可能；技能本身无资金操作权限，风险等级可控，但需用户理解「提醒≠建议」的边界。

核心用法

stock-monitor 是一款轻量级股票实时监控 Skill，专为个人投资者设计，支持同时监控多只股票的实时价格波动。用户通过 JSON 配置文件指定股票列表（支持 A 股、港股、美股），设定基准价和涨跌阈值后，脚本定时轮询 Yahoo Finance API 获取最新价格，当波动超过阈值时触发提醒。

主要功能：

• 多市场支持：A 股（.SS 后缀）、港股（.HK 后缀）、美股（直接代码）
• 智能预警机制：首次涨跌超 2% 触发预警，同一交易日内再波动超 1% 续警，每日自动重置基准价
• 灵活部署：支持本地手动运行，或通过 openclaw cron 设置定时任务（如每 5 分钟检查）
• 状态持久化：自动在本地保存监控状态，避免重复提醒
• 可选富途数据源：高级用户可配置富途 OpenD 本地服务，获取更精准的港股/美股实时行情

显著优点

| 优势 | 说明 |

|------|------|

| **零隐私风险** | 无 PII 收集，数据完全本地存储，无遥测或追踪机制 |

| **依赖极轻** | 主要使用 Python 标准库，核心功能无第三方依赖 |

| **配置简单** | 单个 JSON 文件完成所有设置，无需复杂授权流程 |

| **来源可信** | GitHub 公开项目，作者有开源贡献记录，社区验证超过 370 天 |

| **安全合规** | 通过 GDPR/CCPA 合规检查，无危险函数使用 |

潜在缺点与局限性

• 外部依赖风险：核心功能依赖 Yahoo Finance API，该服务曾有限流或变更历史，存在功能失效可能
• 精度有限：Yahoo Finance 对 A 股/港股数据有一定延迟，不适合高频交易场景
• 无历史分析：仅支持实时监控和简单阈值提醒，无 K 线分析、技术指标或回测功能
• 提醒渠道依赖平台：需通过 OpenClaw 的 message 机制发送提醒，不支持独立推送渠道（如短信、App 推送）
• 富途功能门槛：港股实时精准行情需要额外安装 futu 库并配置本地 OpenD 服务，对非技术用户有一定门槛

适合人群

• 持仓盯盘型投资者：持有 3-10 只中长线股票，需要日常波动提醒但无需实时盯盘
• 多市场配置用户：同时持有 A 股、港股、美股，希望统一监控工具
• 隐私敏感用户：不愿将持仓信息上传至第三方股票 App 或云服务
• 自动化爱好者：希望通过 cron 实现无人值守监控，整合到现有工作流

常规风险

| 风险类型 | 等级 | 说明 |

|----------|------|------|

| 网络安全 | 低 | 仅访问 Yahoo Finance HTTPS API，无敏感信息传输；可选富途仅连接本地服务 |

| 服务可用性 | 中 | Yahoo Finance API 限流或变更可能导致监控中断，建议设置备用检查机制 |

| 数据准确性 | 低 | 免费数据源存在延迟，不适合依赖实时价格的短线交易决策 |

| 配置错误 | 低 | 股票代码格式错误（如 A 股未加 .SS）会导致数据获取失败，需仔细核对文档示例 |

---

使用建议：建议搭配 5-15 分钟间隔的定时任务，避免过频调用触发 API 限制；重要交易决策前请交叉验证价格数据源。