Stock Sentinel MCP server

股哨兵 Stock Sentinel

美股投资进攻/防守信号判断与示警工具：四维数据驱动信号 + 公开 Track Record + 开放 API/MCP。

产品定位

股哨兵不做选股建议，只回答"现在是进攻时机还是防守时机"：

• 长线选股遵循奥地利经济学派（供需决定价格），交由用户自行按"优质国家/龙头产业/龙头企业"原则选定标的。
• 短线时机遵循政治经济学（政策扰乱市场价格），把 AI 供需与货币/财政/行政政策松紧转化为四档信号：🟢进攻 Attack / 🟡观望 Watch / 🟠减仓观望 Reduce / 🔴全面防守 Defense。
• 进攻 = 买在无人问津处；防守 = 卖在人声鼎沸时。
• 进攻信号采用非对称 AND 逻辑（详见下文），防守信号采用 OR 逻辑（宁可错杀）。

覆盖范围仅限美股（不含房产）。

信号计算

四维信号全部自动数据驱动（管理员可手动覆盖），每日美东 21:00 cron 合成最终信号（盘后财报、电话会报道、当日收盘价均已就绪，避开 FRED 凌晨维护窗口；北京时间次日 9:00/10:00）。

离散事件型指标在公布当天即生效（不必等 21:00）：①FOMC 决议——Fed 官网美东 14:00 发布后系统直接读声明文本并重算货币维与档位；②BLS/BEA 惯例的 08:30 月度发布（失业率/萨姆/PCE/联邦月度支出/半导体产出）——系统在美东 08:35、10:05、14:05 检测参考期是否前移，前移即重算受影响维度。连续行情型指标（WTI 油价、信用利差、收益率曲线、日频 EPU）按设计保持 21:00 采样：它们时刻在变，盘中实时化会让历史序列的采样点从固定时点漂移成"最后一次访问的时刻"，破坏可比性与回测口径（详见 backend/utils/event-refresh.js 文件头）。两类即时刷新都只就地更新既有快照、绝不新增采样点，且只允许升档方向。

全局叠加（防守分级）：

• 进攻（非对称） = AI供需宽松（主动引擎发动）+ 货币/财政/行政均不收紧（中性即可，任一收紧即否决）+ 无锁 + 美债收益率曲线（10y−3m）未处倒挂确认期（近63个交易日中倒挂 ≥51 天否决进攻档准入，2026-08-04 窗口口径）+ 信用利差（BAA10Y）90日走阔 <+60bp（2026-07-30 采纳）+ 实际利率（政策利率−12M截尾PCE）<1.5%（2026-08-04 采纳）——三个否决器均只否决进攻、不触发防守，不在信用恐慌/深度限制性利率下开最激进档位。另有趋势地板（2026-08-04）：市场跌破 10 月 SMA 时最终档位至少为减仓观望。
• 仅单维收紧 = 减仓观望：停止加仓、提高警觉，不必减存量仓位（回测实证：单维收紧月份市场月均收益不低于其他月份）。
• 双维以上收紧或锁激活 = 全面防守。例外：纯"货币+财政"双维共振（无行政维、无锁）只到减仓观望。
• 锁机制：萨姆锁（SAHMREALTIME ≥0.5）与应对式调整锁（利率单次 ≥50bp）强制全面防守；解锁 = 利率降至 ≤0.25%（零利率区间无条件解锁），或锁龄满60天且触发条件已消失时出现 <50bp 小幅调整。
• 趋势再入场：市场处上升趋势（最新收盘 ≥ 10个月末收盘SMA）时，决策树与萨姆锁驱动的全面防守降级为减仓观望（应对式调整锁不受趋势否决）。
• 降档迟滞：升档（更防守方向）即时生效；降档（更宽松方向）需持续满30天确认期。

可信度工程：数据管道四层韧性（114号，2026-07-25）——①每日更新定在美东 21:00（盘后财报/电话会报道/当日收盘价就绪，避开 FRED 凌晨维护窗口，上午发布的失业率/萨姆/PCE 当晚入判定）；②FRED 瞬时故障（超时/429/5xx）自动退避重试；③参考指标组级 stale-keep——故障日整组沿用上一快照（值+数据参考期一起，参考期如实显示旧日期，不伪造新鲜度）；④新鲜度看门狗——指标参考期超预算（月度100天/日频10天）自动运维告警，防 stale-keep 静默掩盖序列停更；⑤快照补更新（118号，2026-07-31）——快照过点未生成（定时任务被错过/中途失败）时，小时级看门狗与前端访问都会自动触发后台补跑（30分钟冷却+互斥防打爆，绝不提前跑——美东21:45前期望的是昨日快照，不生成数据不完整的早产快照），前端显示补更新横幅并在新快照落库后自动刷新。信号级：单维度数据源故障时沿用上一次有效判定（stale-keep，前端标灰"数据延迟"），不降级为中性，避免故障日误发"解除防守"警报。行情多层回退（moomoo OpenD→Yahoo→Tiingo→TwelveData），EDGAR 数据带新鲜度校验与错季对齐。指引检测双护栏（115号，2026-07-30）——web 检索只采信财报发布后的报道（财报前预览稿/分析师预期不是管理层指引）；会计政策变更致指引名义数字变化但实际投资计划不变时按实际计划判（不误触发下修事件）。

示警：档位变化 / 任一维度转收紧 / 泡沫预警 / 锁触发与解除时，通过 Resend 邮件提醒订阅用户；进/出全面防守另发 S5 执行指令邮件（仅管理员）。

历史回测报告见 docs/backtest-report.md（6 场危机 5 场触发全面防守，2026 美伊战争未达 15% 危机线由减仓分级应对；2008 年精确到顶部前 11 天。数字为 2026-07-30 快照，以报告与实时接口为准）。S5 执行手册见 docs/s5-execution-playbook.md。

面向 AI 时代：开放API / MCP / Skill

任何 AI 客户端或第三方开发者都可以调用信号系统：

Shortened. The full README is on GitHub.