cnstock · 中国股票数据 CLI

一条命令拿到 A 股行情、财报、估值和研报。免 API Key、零配置、多源自动降级。

上面是真实终端输出录制的动画，不是示意图。

为什么不用 akshare / tushare

最关键的差异是第三行。这些公开接口都没有 SLA：开发期间实测过东方财富的行情接口在请求变多后所有分片同时断开连接，而 datacenter、腾讯、新浪仍然正常。只绑一个源的工具会在你不知情时静默失效，所以 cnstock 每次调用都按顺序尝试多个源，并在输出里用 source 字段告诉你这次是谁答的。

Related MCP server: stock-mcp-server

快速开始

# 直接用，不用安装
npx @wilshi/cnstock quote 600519

# 检索股票
npx @wilshi/cnstock search 茅台

# 财报 + TTM 折算
npx @wilshi/cnstock financials 600519

# 估值测算
npx @wilshi/cnstock value 600519 --growth 0.1 --discount 0.12

# 生成完整研报
npx @wilshi/cnstock report 600519 > 茅台研报.md

任何命令加 --json 都输出结构化 JSON，方便管道处理：

npx @wilshi/cnstock quote 600519 --json | jq .price

命令一览

作为 MCP 服务使用

cnstock 同时是一个 MCP server，可以直接接进 Claude Desktop、Cursor 等支持 MCP 的客户端：

{
  "mcpServers": {
    "cnstock": {
      "command": "npx",
      "args": ["-y", "--package", "@wilshi/cnstock", "cnstock-mcp"]
    }
  }
}

提供的 6 个工具：cnstock_search、cnstock_quote、cnstock_kline、cnstock_financials、cnstock_valuation、cnstock_report。

接上之后就能直接问：

「茅台现在贵吗？按 10% 折现率帮我算一下。」

两个它做得比别家认真的地方

1. TTM 不是随便取一期

A 股财报是累计口径——三季报的净利润是 1 到 9 月的累计值，直接当年度数据用会严重失真。cnstock 按 最新累计 + 上年年报 - 上年同期 折算 TTM，并把计算依据一起输出：

TTM 归母净利    821.61 亿元
TTM 口径        TTM = 2026年 三季报累计 + 2025年报 - 2025年同期

2. 不同生意用不同估值模型

对银行套 DCF 会算出荒谬的「安全边际」——平安银行用 DCF 会显示低估 69.8%，而正确做法是用 Gordon 增长形式的 合理 PB = (ROE - g) / (r - g)。cnstock 会自动识别并切换。

此外它会反推当前股价隐含的增速：茅台现价隐含 5 年增速约 14.2%，你可以自己判断这个预期是否合理。

也支持 Docker

MCP server 以 stdio 通信，容器内不需要暴露端口：

docker build -t cnstock-mcp .
docker run --rm -i cnstock-mcp

非 root 运行，多阶段构建。

财务排雷（全市场）

cnstock 现在能做两件事：查数据，以及扫描全市场的财务风险。

# 单公司体检
npx @wilshi/cnstock audit 600519

# 全市场扫描：分「高危 / 关注」两级
npx @wilshi/cnstock scan --limit 20

# 只看高危
npx @wilshi/cnstock scan --tier red

全市场扫描：检查 5563 家，[红] 112 家，[黄] 1240 家

[红] 高危     300212 *ST易录 [ST]
    · 净资产为负：-19.53 亿
    · 连续两年亏损：-28.65 亿 / -27.17 亿
    · 经营现金流连负：-2.41 亿 / -1.59 亿

扫描 5563 家约 50 秒，之后命中本地缓存是 1 秒级。

规则是怎么选的（不是拍脑袋）

这些规则用 **313 家 ST/*ST 公司作为验证集**跑过全市场回测，按区分能力筛选：

「提升倍数」= ST 公司触发概率 ÷ 正常公司触发概率。1x 等于随机，越高越有区分力。

一个被公开否定的设计

我们最初还实现了「净利现价比」（经营现金流 ÷ 净利润），直觉上是最可靠的造假信号。但全市场验证显示它的提升倍数是 0.16x —— 反而是反指标：ST 公司触发它的概率比正常公司还低。

原因：该规则只对「有盈利但现金流差」的公司生效，而 ST 公司大多处于亏损状态，直接跳过了这条规则。

所以它没有进入 scan。 相关实验代码保留在 scripts/rule-compare.ts 与 scripts/rule-combo.ts，可复现。

分层而不是打分

验证也说明了一件事：不存在又准又全的单一规则集。

规则加得越多召回越高，但全加进去会标出 39% 的 A 股 —— 等于没标。所以产品输出分层：红灯只放高置信度信号，黄灯保留覆盖面。

它不能做什么（重要）

• 不能识别财务造假。 造假检测需要的信号（跨期调节、虚构收入、关联交易非关联化）无法用比率分析可靠识别，且缺乏有效的统计验证方法。

• 不能预测爆雷。 上述验证用的是「当前财务状态 vs 当前 ST 状态」的横截面区分度，不是时序预警能力。

• 数据是重述后的。 已被处罚公司的历史报表都经过追溯调整，无法还原「事发前原始披露」的数字。

• 不构成投资建议。 输出的是「需人工复核」，不是「卖出」。

已知局限和后续验证计划见 docs/red-flag-design.md。

项目结构

├── src/
│   ├── cli.ts                # 命令行入口
│   ├── mcp.ts                # MCP server 入口
│   ├── index.ts              # 库导出
│   ├── datasource/
│   │   ├── index.ts          # 多源降级编排
│   │   ├── eastmoney.ts      # 东方财富
│   │   ├── tencent.ts        # 腾讯（备用）
│   │   ├── sina.ts           # 新浪（兜底）
│   │   └── types.ts
│   └── analysis/
│       ├── valuation.ts      # DCF / PB-ROE / TTM
│       └── report.ts         # Markdown 研报
└── scripts/mcp-smoke.mjs     # MCP 协议冒烟测试

数据源

均为公开接口，无需注册。行业与概念标签只有东方财富提供；降级到备用源时这些字段为空，输出会如实标注。

免责声明

本项目是数据工具，不构成投资建议。数据来自第三方公开接口，可能存在延迟、缺失或口径差异；估值结果对假设高度敏感。据此操作风险自担。

License

MIT © 2026 WilShi