# Chinese Stock Analysis

> A股全维度分析工具 — 个股分析、概念板块扫描、宏观市场概览、每日复盘、ETF期权扫描

- Skill: `bobby1129/chinese-stock-analysis` (Agent Skill, multi-file: 12 files)
- Install (CLI): `npx skillmds@latest add bobby1129/chinese-stock-analysis`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bobby1129/chinese-stock-analysis/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bobby1129 (https://skillmd.com/u/bobby1129)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/bobby1129/chinese-stock-analysis

---


# chinese-stock-analysis (stock-analysis-pro)

A股全维度分析 + ETF 期权分析工具，覆盖个股深度分析、概念板块扫描、宏观市场概览、每日复盘、ETF 期权扫描五大核心功能。

---

## 首次安装

```bash
# 1. 克隆到 ~/.hermes/skills/ 下
git clone https://github.com/bobby1129/stock-analysis-pro.git ~/.hermes/skills/stock-analysis-pro
cd ~/.hermes/skills/stock-analysis-pro

# 2. 安装依赖
pip install -r requirements.txt

# 3. 安装 Playwright 浏览器 (用于东财F10/股吧/研报采集, 概念板块用HTTP API不需要)
playwright install chromium

# 4. 配置
cp config/config.example.yaml config/config.yaml
# 编辑 config.yaml，填入东财 Cookie (见下方说明)
# 如有代理需求，配置 proxy.https 或设置 HTTPS_PROXY 环境变量
```

**Cookie 获取步骤**：
1. 浏览器打开 https://quote.eastmoney.com/bk/
2. F12 → Network → 刷新页面
3. 找到 `push2.eastmoney.com` 请求
4. 复制 Request Headers 中的 Cookie 值

> ⚠️ Cookie 有效期 1-7 天，过期后概念板块功能降级为离线缓存模式。

---

## 验证安装

```bash
# 1. 验证基本功能（不需要Cookie）
python core/cli.py analyze 600519 --brief
# 预期输出：贵州茅台 实时价格 + PE/PB/市值

# 2. 验证概念板块（需要有效Cookie）
python core/cli.py concept
# 预期输出：Top10概念列表 + 成分股分析
# 如果提示Cookie过期，按提示重新获取

# 3. 验证HTML报告
python core/cli.py analyze 600519 --html
# 预期输出：output/stock_600519.html 生成
```

如果第1步就失败，检查：
- `playwright install chromium` 是否执行成功
- `pip install -r requirements.txt` 是否完整
- `config/config.yaml` 是否存在（从 `config.example.yaml` 复制）

---

## 命令参考

所有命令在项目根目录下执行：

```bash
# ── 每日复盘 ──
python core/cli.py review              # 文本输出
python core/cli.py review --html       # HTML 报告（推荐，微信/浏览器查看）

# ── ETF 期权扫描 ──
python core/cli.py options             # 全合约扫描（卖方+买方机会）
python core/cli.py options --top 10    # 取前10个
python core/cli.py options --symbol 510050  # 指定标的（默认自动检测）

# ── 持仓管理 ──
python core/cli.py portfolio           # 查看持仓（默认list）
python core/cli.py portfolio --action list   # 查看持仓
python core/cli.py portfolio --action add --code 603893 --name 瑞芯微
python core/cli.py portfolio --action rm --code 603893
python core/cli.py portfolio --action update --code 603893 --cost 120 --shares 100

# ── 个股分析 ──
python core/cli.py analyze 600519          # 全维度分析 (文本)
python core/cli.py analyze 600519 --html   # HTML 报告
python core/cli.py analyze 600519 --json   # JSON 输出
python core/cli.py analyze 600519 --brief  # 简要模式

# ── 概念板块扫描 ──
python core/cli.py concept                 # 资金流入 Top10
python core/cli.py concept --html          # HTML 报告

# ── 宏观市场概览 ──
python core/cli.py market                  # 文本输出
python core/cli.py market --html           # HTML 报告

# ── 自选股 ──
python core/cli.py add 600519              # 加入自选
python core/cli.py rm 600519               # 移除
python core/cli.py list                    # 查看列表
python core/cli.py analyze-all             # 批量分析自选股
```

---

## 架构 (三层流水线)

```
collectors/          analysis/           plans/
┌─────────────┐    ┌──────────────┐    ┌──────────────┐
│  数据采集层  │ ──▶│   分析引擎层  │ ──▶│  输出规划层   │
│  (多源采集)  │    │  (评分/聚合)  │    │ (格式化呈现)  │
└─────────────┘    └──────────────┘    └──────────────┘
```

### 数据源

| 数据源 | 用途 | 方式 | 状态 |
|--------|------|------|------|
| 腾讯 qt.gtimg.cn | 实时行情(价格/PE/PB/市值) | 直连 | ✅ |
| 新浪 money.finance | K线数据(250日) | 直连 | ✅ |
| 东财 emweb | 公司F10 (Playwright) | Playwright拦截 | ✅ |
| 东财 guba | 股吧热帖 (Playwright) | Playwright拦截 | ✅ |
| 东财 search-api | 概念新闻 | 直连 | ✅ |
| 东财 push2 | 概念资金流 | HTTP API + Cookie (主链路, 1s间隔) / Playwright (F10辅助) | ✅ |
| 东财 行情页 | 涨跌家数 | HTTP API + Cookie | ✅ |
| akshare THS | 财务/分红/预测 | 需代理 | ✅ |
| akshare 涨停池 | 涨跌停统计 | 需代理 | ✅ |
| 新浪 期权 | IV/HV/Greeks/行情 | 直连 | ✅ |
| 新浪 期权 | 全合约列表 | 直连 | ✅ |

---

## 分析维度

### 每日复盘 (review)

每日收盘后自动生成综合报告，包含：

1. **指数概览** — 上证/深证/创业板/科创50 实时行情
2. **涨跌统计** — 涨跌家数、涨停跌停数、赚钱效应分析
3. **概念板块 TOP10** — 资金净流入 TOP10 + 涨幅 TOP10（同花顺数据源）
4. **持仓跟踪** — 当日持仓盈亏、涨跌、风险提示
5. **自选股监控** — 自选股列表及表现
6. **宏观指标** — 北向资金、市场情绪、关键事件

输出格式：
- 文本模式：终端查看，紧凑格式
- HTML 模式：可视化报告，浅色主题，支持微信/浏览器查看

数据来源：
- 指数行情：腾讯 qt.gtimg.cn
- 涨跌家数：东财 push2 HTTP API (需 Cookie)
- 涨跌停数据：akshare 涨停池 (需代理)
- 概念板块：同花顺 data.10jqka.com.cn (无需 Cookie，不触发滑块)
- 持仓数据：`config/config.yaml` 的 `portfolio` 字段

### ETF 期权扫描 (options)

全市场 ETF 期权合约扫描，寻找高胜率交易机会：

**卖方机会分析**（卖出期权赚时间价值）：
- IV > HV 的虚值期权（时间价值高估）
- 按时间价值/天排序，找出衰减最快的合约
- 风险提示：Delta 暴露、Gamma 风险、跳空风险

**买方机会分析**（买入期权赌方向）：
- IV < HV 的平值/浅虚值期权（波动率低估）
- 近期事件驱动（财报、政策、技术突破）
- 按性价比排序（预期收益/权利金）

**风险指标**：
- Delta：方向暴露
- Gamma：Delta 变化速度
- Theta：时间价值衰减/天
- Vega：波动率敏感度

**过滤规则**：
- 剩余天数 > 7 天（避免末日轮）
- 成交量 > 100 手（流动性）
- 持仓量 > 500 手（市场关注度）

数据来源：
- 全合约列表：新浪期权频道
- IV/HV/Greeks：新浪期权频道 (hq.sinajs.cn)
- 标的行情：腾讯 qt.gtimg.cn

### 个股分析 (analyze)

6大维度全方位，综合评分 -100 ~ +100：

| 维度 | 关键数据 |
|------|----------|
| 公司概况 | F10资料、主营、行业、实控人 |
| 技术面 | MA/MACD/KDJ/RSI/BOLL、量价、支撑压力 |
| 基本面 | ROE/毛利率/负债率/增速/分红/一致预期 |
| 估值 | PE/PB/市值/换手率 |
| 资金面 | 成交额统计、北向持股 |
| 舆情 | 股吧情绪、新闻、分析师评级 |

评级: 强看多(≥60) / 看多(≥30) / 偏多(≥10) / 中性(≥-10) / 偏空(≥-30) / 看空(≥-60) / 强看空(<-60)

### 概念板块扫描 (concept)

1. HTTP API 请求东财 push2，按资金流入排序概念 (需 Cookie, 1s间隔)
2. 过滤非行业概念(风格/市值/地域类)
3. 成分股涨幅分布 → 趋势定性(启动/主升浪/走弱)
4. 双轨评分: 轨道A板块强度(赚钱效应/资金强度/板块宽度) + 轨道B选股决策(可买标的/标的质量/追高风险/新鲜度)
5. 新闻归因 → 驱动逻辑

### 宏观市场概览 (market)

| 维度 | 关键数据 |
|------|----------|
| 国际环境 | 美债10Y/美联储利率/黄金/白银/原油 |
| 国内经济 | CPI/PMI/M2/LPR → 经济周期+流动性定性 |
| 事件驱动 | 涨停数/连板/热门方向/昨日涨停今日表现 |
| 综合研判 | 多维加权 → 操作建议 |

---

## 输出格式

| 格式 | 参数 | 场景 |
|------|------|------|
| 文本 | (默认) | 终端 |
| HTML | `--html` | 微信/浏览器 (暗色主题) |
| JSON | `--json` | 程序对接 |
| 简要 | `--brief` | 快速概览 |

HTML 报告输出到 `cache/` 目录，可直接发送给用户查看。

---

## ⚠️ 常见陷阱

1. **Playwright 必须安装 Chromium**: `playwright install chromium`，否则 F10/股吧/研报采集失败
2. **东财 Cookie 会过期**: 概念板块返回空或使用离线缓存时，重新获取 Cookie 并更新 `config.yaml`
3. **滑块验证触发**: 连续断连(RemoteDisconnected)≥2次时打印`⚠️ 疑似触发东财滑块验证`，浏览器打开 https://data.eastmoney.com/bkzj/gn.html 手动验证后重试
4. **东财搜索 API 返回 JSONP**: 需要剥离 jQuery 回调包装再解析
5. **腾讯行情 PB 在 d[46]**: 不是 d[52] (52是涨停价)
6. **push2his 个股主力资金流不可用**: 服务器 IP 被封，用成交额+北向替代