核心用法
stock-monitor 是一款基于 Yahoo Finance API 的股票价格实时监控工具，支持同时追踪多只股票（A股、港股、美股），并在价格波动超过设定阈值时自动触发提醒。
主要功能流程：
1. 配置股票列表：通过 JSON 配置文件定义监控标的，包括 symbol、基准价和货币符号
2. 定时运行监控脚本：支持手动执行或设置 cron 定时任务（如每5分钟检查一次）
3. 智能预警机制：
- 首次预警：涨跌超过 2% 时触发
- 续警机制：同一天内再次波动超过 1% 时追加提醒
- 自动重置：新一天基准价更新为前一天收盘价
技术实现：依赖 Yahoo Finance 免费 API 获取实时报价，状态持久化存储于本地 JSON 文件，支持 Discord 等渠道的消息推送。
显著优点
- 多市场覆盖：同时支持 A股（.SS/.SZ）、港股（.HK）和美股无后缀代码
- 阈值灵活：用户可自定义基准价和提醒敏感度
- 状态持久化：自动记录预警历史，避免重复打扰或遗漏重要波动
- 集成友好：可通过 openclaw cron 与现有自动化工作流无缝对接
潜在缺点与局限性
- 数据源依赖：Yahoo Finance API 存在延迟（通常 15-20 分钟）且偶有服务中断，不适合高频交易场景
- 免费 API 限制：未明确提及但存在请求频率限制风险，大规模监控可能触发限流
- 单点故障：无备用数据源，API 变更可能导致功能完全失效
- 地域限制：部分 A股数据在 Yahoo Finance 的覆盖完整度不如专业金融终端
适合人群
- 中长期投资者追踪持仓日常波动
- 需要价格提醒但无需毫秒级延迟的散户
- 已将 openclaw 生态用于日常自动化的技术型用户
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 数据延迟 | Yahoo Finance 非实时报价 | 不用于短线交易决策 |
| API 可用性 | 第三方服务稳定性不可控 | 设置监控脚本健康检查 |
| 配置错误 | 错误的 symbol 导致监控失效 | 首次使用前验证 symbol 有效性 |
| 安全存储 | 配置文件可能含持仓信息 | 注意文件权限设置，避免敏感信息泄露 |