Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Stock Sentinel

by SheldonZhuangversion 1.1.0i★ 1iRuns on your computerRepository ↗
Registry nameio.github.SheldonZhuang/stock-sentinel

How to install

What it does

US stock attack/defense macro signals: 4-dimension framework, 26-year backtested. Research only.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Search & AI memory

Use together with

Skills that teach the AI this kind of work; they work alongside this one

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

by google-research★ 35,6381 skills

Skill · How-to guide

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

by BigBodyCobain★ 11,6051 skills

Skill · How-to guide

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

by gosom★ 8,2361 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity4/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score16/100

Quality: Passed 2/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Stock Sentinel. Follow https://mcp.popnx.com/i/sheldonzhuang-stock-sentinel.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 2/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Stock Sentinel for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "stock-sentinel": { "command": "npx", "args": [ "-y", "stock-sentinel-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Stock Sentinel tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  3. Paste these settings and save the file

    {
      "mcpServers": {
        "stock-sentinel": {
          "command": "npx",
          "args": [
            "-y",
            "stock-sentinel-mcp"
          ]
        }
      }
    }
  4. Quit Claude and open it again

  5. Try it

    Use Stock Sentinel and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Stock Sentinel or shows a Stock Sentinel tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • STOCKSENTINEL_API_KEY Optional API key for higher daily limits (default trial: 25 req/day)

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Stock Sentinel yet

Stock Sentinel runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Stock Sentinel

  • Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • Install Node.js on your computer first (one time)
  • Install Node.js on your computer first (one time)
  • Install Node.js on your computer first (one time)

B · Others in Search & AI memory that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Stock Sentinel for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user stock-sentinel -- npx -y stock-sentinel-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Stock Sentinel tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --scope user stock-sentinel -- npx -y stock-sentinel-mcp
  4. Type /mcp in Claude Code

    You should see Stock Sentinel listed as connected

  5. Try it

    Use Stock Sentinel and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Stock Sentinel or shows a Stock Sentinel tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • STOCKSENTINEL_API_KEY Optional API key for higher daily limits (default trial: 25 req/day)

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Stock Sentinel for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "stock-sentinel": { "command": "npx", "args": [ "-y", "stock-sentinel-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Stock Sentinel tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Open the AI chat in Cursor in Agent mode

  4. Try it

    Use Stock Sentinel and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Stock Sentinel or shows a Stock Sentinel tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • STOCKSENTINEL_API_KEY Optional API key for higher daily limits (default trial: 25 req/day)

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Stock Sentinel for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "stock-sentinel": { "type": "stdio", "command": "npx", "args": [ "-y", "stock-sentinel-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Stock Sentinel tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Open the AI chat in VS Code in Agent mode

  4. Try it

    Use Stock Sentinel and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Stock Sentinel or shows a Stock Sentinel tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • STOCKSENTINEL_API_KEY Optional API key for higher daily limits (default trial: 25 req/day)

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Stock Sentinel💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user stock-sentinel -- npx -y stock-sentinel-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "stock-sentinel": {
      "command": "npx",
      "args": [
        "-y",
        "stock-sentinel-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "stock-sentinel": {
      "command": "npx",
      "args": [
        "-y",
        "stock-sentinel-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "stock-sentinel": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "stock-sentinel-mcp"
      ]
    }
  }
}

Values you fill in

  • STOCKSENTINEL_API_KEY secret env
    Optional API key for higher daily limits (default trial: 25 req/day)

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
69/wk
Licencei
No licence stated
Connection
Runs on your computer
Latest versioni
1.1.0
Published to registryi
Oct 24, 2026
Code last changedi
Nov 11, 2026
Maker
SheldonZhuang
Packages
npm: stock-sentinel-mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account SheldonZhuang, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 8 days ago

  • ✕ Fail

    Has a licence

    No licence file found in the repo

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for stock-sentinel-mcp@1.1.0

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/sheldonzhuang-stock-sentinel.svg)](https://mcp.popnx.com/en/servers/sheldonzhuang-stock-sentinel)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Search & AI memoryi

  • More stars than 76% of the other 6430 servers in this category
  • Published to the registry more recently than 60% of the other 6430 servers in this category
  • Basic checks equal to or better than 50% of the other 6430 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Stock Sentinel safe?

It passed 2 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 8 days ago, and the latest version (1.1.0) reached the registry 26 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

by every-appWidely used★ 28.3KUpdated 5 days ago

Runs in the cloud✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

by exa-labsWidely used★ 5.2KUpdated 2 months ago

Runs in the cloud✓ service owner · exa.aiTried by the PopNx team

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

by MicrosoftDocsWidely used★ 2KUpdated 12 months ago

Runs in the cloud✓ service owner · microsoft.comTried by the PopNx team

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

by proxysoulGrowing★ 1.6KUpdated 2 months ago

Runs in the cloud✓ empryo.com
Compared with similar ones
This one
Stock Sentinel
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoYesYesYesNoNo
Basic checks2/35/52/44/44/44/4
License–MITMITCC-BY-4.0NOASSERTIONApache-2.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

股哨兵 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供需(长线主线)现金流三件套,沿产业链资金流向:OpenRouter 模型调用量(需求侧)→ SEC EDGAR 云厂商资本开支(投资侧)→ FRED IPG3344S 半导体产出同比(供给侧)调用量 28日均vs前28日均 >+3% 宽松 / <−3% 收紧;capex 滚动4季同比 >+10% 宽松 / <0% 收紧,另有单季侦察兵规则(最新单季同比<0 拦截宽松;连续两季<0 直接收紧,比 TTM 提前 1-2 个季度);半导体产出同比 >+5% 宽松 / <0% 收紧。三件套共识:任一环节收缩→收紧(供过于求预警),全链向上→宽松,其余中性
货币政策Fed 官方 FOMC 声明(决议当日即时)+ FRED DFEDTARU 利率 + WALCL 资产负债表(核心PCE/Trimmed PCE/失业率仅参考展示)按最近一次 FOMC 决议方向判定:加息(含渐进25bp)→收紧并保持到下次决议;降息或按兵不动→宽松。单次调整 ≥50bp(不论方向)触发应对式调整锁强制全面防守。QT 只拦截宽松评级不单票定罪(回测实证 QT 年份市场多数上涨)。决议当晚即生效:Fed 官网美东 14:00 发布声明后直接读声明文本(fetch-fed-rate.js 解析目标区间与动词),不等 FRED 日更序列(后者次一工作日才见新台阶,此前会造成决议当晚"持平/方向反了");FRED 台阶落地后自动切回序列口径
财政政策FRED MTSO133FMS 联邦月度支出"大市场小政府"原则:滚动12月实际(PCE平减)支出同比扩大 >5%→收紧(政府变大),收缩 >5%→宽松(政府瘦身)。用支出不用赤字:减税型赤字不应判收紧
行政政策FRED EPUTRADE(月度贸易专项)+ USEPUINDXD(日频EPU 7日均线)+ WTI 油价(战争冲击实时代理,期货主力单合约优先、取不到才用现货;高位判断比期货近2年中位)油价30天涨跌 ≥±20% 事件层优先:飙升且 EPU 高位且油价处高位(高于近2年中位,低位反弹不判战争冲击)→收紧;暴跌且 EPU 未高位→宽松。否则 EPU 双源10年百分位 >80→收紧(已收紧时跌破75才退出),<50→宽松,双源一致才定档

全局叠加(防守分级):

  • 进攻(非对称) = 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 客户端或第三方开发者都可以调用信号系统:

通道位置说明
开放 REST API/v1/*(OpenAPI 规范)X-API-Key 鉴权;免key试用 25次/日/IP,free 250/日,pro 10000/日(pro 与订阅有效期挂钩,到期自动按 free 计);密钥在管理后台签发并可绑定归属用户
MCP Servermcp/Claude Desktop/Cursor 等一行配置接入,8个工具(当前信号/历史/产业链/个股/回测/日报/研究笔记/ask_company)
Claude Skillskills/stock-sentinel/教 AI 正确理解四维框架与解读规范
AI 日报/v1/daily-report每日 cron 后 LLM 自动生成中英双语信号解读(经 OpenRouter,可配 AI_REPORT_MODEL)
公开 Track Record网站 /track-record每日信号档位不可篡改存档 + 回测成绩,供任何人验证
发现层(SEO/GEO,125号)llms.txt / robots.txt / sitemap.xml(网站根)、GET /v1/openapi.yaml(API 自发现)、首页 meta/OG/JSON-LD让搜索引擎与 AI Agent 自动发现全部调用通道;首页对未登录访客开放只读(个人化功能仍需登录)

所有输出均附免责声明:仅供研究参考,不构成投资建议。

后台管理(/admin,仅管理员):信号覆盖 / 锁应急清除 / 密钥签发 / 用户管理与API用量监控 (注册与订阅状态、剩余时间与配额、按用户端点统计与30天调用明细、全站功能热度——资源投放依据), 详见 docs/admin-guide.md。

公司研究 Agent

对 AI 产业链 8 家公司(MSFT、GOOGL、AMZN、META、NVDA、AMD、AVGO、TSM)的 SEC 财报与公告,自动生成每季一份带出处的结构化研究笔记,内容包括:

  • 关键数字,以及与上季、去年同期的对比;
  • 是否达成管理层指引,这一结论由程序计算;
  • 业务变化与风险点。

每条陈述都附 SEC 原文链接、字符区间和逐字引文,生成后由程序逐条核对;核对不通过的陈述标记为"待人工核对",不会被悄悄保留。研究笔记不参与进攻/防守信号判定。

  • 网站:/research,公开只读,点数字可跳到原文出处
  • 开放 API:GET /v1/research/notes/{ticker}/{quarter}、POST /v1/research/ask(问答需要 API key,free 档每日 5 次)
  • MCP:get_research_note、ask_company
  • 评估:npm run eval:research。160 个 XBRL 金标事实上,Claude 与 Grok 数值准确率 100%;AI 盲评有用性分别为 4.59 / 4.06(5 分制)
  • 文档:架构、评估方法、已知局限与成本见 docs/research-agent.md;演示脚本见 docs/research-agent-demo-script.md

技术栈

  • 后端:Node.js + Express + sql.js(WASM SQLite)+ node-cron + bcryptjs + JWT
  • 前端:Vue 3 + Vite + vue-i18n(中/英/法/德/西/日/韩 七语言)
  • 测试:Vitest 全量套件(后端+前端,具体用例数以 npm test 实跑为准)
  • 数据源:FRED API(宏观/财政/行政/半导体产出/收益率曲线)、Fed 官网 FOMC 声明与货币政策 RSS(决议结果即时源,14:00 发布后当天生效)、行情多层回退 moomoo OpenD(本机网关,美股LV3实时,可选)→Yahoo→Tiingo→TwelveData(估值:Yahoo summary + EDGAR 计算 P/S;日线口径复权源 Yahoo/Tiingo 优先于生价源)、SEC EDGAR XBRL(云厂商capex,双口径)、OpenRouter(模型调用量)、Federal Register API(政策参考素材)
  • 部署:Railway(后端)+ Vercel(前端);数据库每日备份至 GitHub 私有仓库

目录结构

StockSentinel/

├── backend/ │ ├── server.js # Express 入口,路由 + cron 任务 │ ├── config/ # signal.config / ai-chain.config / fomc-meetings │ ├── api/ # signal / fetch-macro / fetch-policy / fetch-ai-chain / market-data / payloads / mcp / public ... │ ├── backtest/ # 历史回测引擎与变体守卫 │ ├── utils/ # storage(sql.js 封装) / mailer(Resend) / backup(GitHub) / usage-log(调用明细埋点) │ └── tests/ ├── frontend/ │ ├── public/ # robots.txt / sitemap.xml / llms.txt / favicon(SEO/GEO 发现层) │ └── src/ │ ├── components/ # SignalHero / MacroPanel / AiChainPanel / WatchlistPanel / SignalTimeline / AdminPanel / UserPanel ... │ ├── views/ # HomeView / LoginView / AdminView / TrackRecordView │ ├── i18n/locales/ # zh en fr de es ja ko │ └── stores/auth.js ├── mcp/ # MCP Server(stdio) ├── skills/stock-sentinel/ # Claude Skill └── docs/ # 回测报告 / S5手册 / 方法论评审(OpenAPI 规范在 backend/openapi.yaml,随 API 部署)

本地运行

环境变量

在 backend/.env 中配置:

FRED_API_KEY=your_fred_api_key

JWT_SECRET=your_jwt_secret ADMIN_EMAIL=your_admin_email RESEND_API_KEY=your_resend_api_key TIINGO_API_KEY=your_tiingo_key # 行情备用源(可选) TWELVEDATA_API_KEY=your_twelvedata_key # 行情备用源(可选) MOOMOO_WS_HOST=127.0.0.1 # moomoo OpenD 本机网关,美股LV3实时行情(可选,三项配齐才启用) MOOMOO_WS_PORT=33333 # OpenD 的 WebSocket 端口(与 TCP 11111 是两个开关) MOOMOO_WS_KEY=your_opend_ws_key # 对应 OpenD"WebSocket鉴权密钥"字段——勿填进"WebSocket私钥/证书"(SSL文件字段),会致OpenD设置错误无法登录;排障见 docs/moomoo-cloud-setup.md FMP_API_KEY=your_fmp_key # 仅 CapEx 备源(EDGAR 失败时、财报后新季值),可选 OPENROUTER_API_KEY=your_openrouter_key # 模型调用量监测 + AI日报 + 研究 Agent(可选) CLAUDE_GATEWAY_URL=https://your-claude-gateway # 可选:OpenAI 兼容的 Claude 网关;OpenRouter 上的 Claude 不可用时优先用它 CLAUDE_GATEWAY_KEY=your_gateway_key # 与上一行成对;都不配则 Claude 不可用时直接用最新 Grok

模型选择(backend/research/models.js):OpenRouter 最新 Claude Opus/Fable → 网关 Claude → OpenRouter 最新 Grok;DeepSeek / GLM 永久弃用

CLOUDFLARE_API_TOKEN=your_cf_token # AI需求第二源:Radar全网AI bot流量趋势,仅用于usage分歧核查邮件的独立佐证,不进判定(可选,免费申请仅需Radar读权限) GITHUB_BACKUP_REPO=owner/private-repo # 数据库每日备份(可选) GITHUB_BACKUP_TOKEN=fine_grained_pat # 仅需该仓库 Contents 读写(可选) ADMIN_PASSWORD=strong_password # 强烈建议:启动种子管理员账户并封锁 ADMIN_EMAIL 抢注(116号) INSTANCE_ROLE=primary # primary(默认,云端)|replica(本机第二实例:不群发订阅邮件、不上传备份) BACKUP_ENCRYPTION_KEY=64_hex_chars # 备份 AES-256-GCM 加密(可选;两实例须同钥并在密码管理器留底) BACKEND_PUBLIC_URL=https://your-api # 邮件一键退订链接的基址(可选,默认 Railway 域名) PORT=3001

启动后端
cd backend

npm install npm run dev # node --watch server.js npm test # vitest run

启动前端
cd frontend

npm install npm run dev # http://localhost:5173,代理 /api 到 localhost:3001 npm run build

当前状态

信号体系已过七轮专家复查与多轮方法论审查(判定逻辑 v2、防守分级、收益率曲线否决、趋势再入场、降档迟滞、capex 单季侦察兵与指引下修事件 N3、信用利差进攻否决均已实证定案),全量测试用例全过,每日云端自动运行并公开存档。capex 指引自动检测为双源(EDGAR 新闻稿 + web 检索电话会/媒体),财报后单公司 capex 快报(单季/TTM 额度同比、本财年/未来指引)自动入档。第七轮系统性审查(116号,2026-07-30)修复了 FOMC 决议日货币维闪变、N3 事件绕过降档迟滞、邮件发送库错误语义(失败被计成功)、双实例重复群发与备份互踩等 30 余处,详见 docs/systematic-review-2026-07-30.md。

后续迭代:付费订阅墙的实际启用、移动端原生 App/小程序、Google OAuth 登录接入。