cn-stock-volume v3.0#

获取中国 A 股市场核心数据： 三大指数点位及涨跌幅、 成交量变化、 涨跌家数比。

📊 数据指标#

指标获取方式说明示例上证指数🤖 自动点位 + 涨跌幅3957.05 点，-1.24%深证成指🤖 自动点位 + 涨跌幅13866.20 点，-0.25%创业板指🤖 自动点位 + 涨跌幅3352.10 点，+1.30%上涨家数🤖 自动A 股上涨数量1234 家下跌家数🤖 自动A 股下跌数量3456 家今日量能✍️ 手动四市总成交金额待补充昨日量能✍️ 手动前一交易日成交金额待补充

🚀 快速开始#

步骤 1：获取自动数据#

bash

# 查询今日（自动获取指数 + 涨跌家数）
python3 scripts/generate_report.py

# 查询指定日期
python3 scripts/generate_report.py 2026-03-22

# 强制刷新（忽略缓存）
python3 scripts/generate_report.py --force

步骤 2：补充成交量数据#

bash

# 补充今日和昨日成交量（单位：万亿）
python3 scripts/补数据.py 2026-03-22 --today 1.23 --previous 1.30

# 查看当前手动数据
python3 scripts/补数据.py 2026-03-22 --show

# 清除手动数据
python3 scripts/补数据.py 2026-03-22 --clear

步骤 3：重新生成报告#

bash

# 重新生成（使用补充的成交量数据）
python3 scripts/generate_report.py 2026-03-22

📁 输出文件#

Markdown 报告（人类阅读）#

• 位置: ~/Desktop/A 股每日复盘/stock-report-YYYY-MM-DD.md
• 用途: 直接阅读、分享到群聊

JSON 数据（程序调用）#

• 位置: ~/Desktop/A 股每日复盘/data-YYYY-MM-DD.json
• 用途: 其他程序/脚本调用

🏗️ 目录结构#

text

cn-stock-volume/
├── SKILL.md              # 本文件
├── DESIGN.md             # 详细设计文档
├── scripts/
│   ├── fetch_data.py     # 数据获取核心
│   ├── generate_report.py # 报告生成
│   └── 补数据.py          # 手动补充数据
├── cache/                # 缓存（TTL=24h）
│   └── YYYY-MM-DD.json
├── manual/               # 手动补充数据
│   └── YYYY-MM-DD.json
└── output/               # 输出文件
    ├── report.md
    └── data.json

📋 数据源#

同花顺问财（浏览器自动化）

数据查询语句URL上证指数上证指数问财深证成指深证成指问财创业板指创业板指问财上涨家数A 股上涨数量[问财]( https://www.iwencai.com/unifiedwap/result?w=A 股上涨数量&querytype=zhishu)下跌家数A 股下跌数量[问财]( https://www.iwencai.com/unifiedwap/result?w=A 股下跌数量&querytype=zhishu)

🔧 特性#

缓存机制#

• TTL: 24 小时
• 位置: cache/YYYY-MM-DD.json
• 作用: 避免重复调用浏览器，提升速度

非交易日处理#

• 自动检测周末
• 往前推移直到找到最近交易日
• 最多往前推 7 天

手动补充#

• 成交量数据需手动补充
• 支持命令行补充（ 补数据.py）
• 支持直接编辑 JSON 文件
• 补充后重新生成报告即可更新

错误处理#

• 单个数据失败 → 使用占位符 待补充
• 不影响其他数据获取
• 清晰的错误提示

📝 输出示例#

Markdown#

markdown

# 📊 A 股市场日报 | 2026-03-22

## 三大指数

| 指数 | 点位 | 涨跌幅 |
|------|------|--------|
| 上证指数 | 3957.05 | 📉 -1.24% |
| 深证成指 | 13866.20 | 📉 -0.25% |
| 创业板指 | 3352.10 | 📈 +1.30% |

## 成交量

- **今日量能**：1.23 万亿
- **量能变化**：缩量 0.07 万亿 (-5.69%)
- **市场情绪**：🟢 缩量调整

## 涨跌家数

- **上涨**：1234 家
- **下跌**：3456 家
- **涨跌比**：≈ 1:2.8（下跌显著多于上涨）

JSON#

json

{
  "date": "2026-03-22",
  "indices": {
    "shanghai": { "point": 3957.05, "change": -1.24 },
    "shenzhen": { "point": 13866.20, "change": -0.25 },
    "chinext": { "point": 3352.10, "change": 1.30 }
  },
  "volume": {
    "today": 1.23,
    "previous": 1.30,
    "change": -0.07,
    "changePercent": -5.38,
    "type": "缩量"
  },
  "sentiment": {
    "up": 1234,
    "down": 3456,
    "ratio": "1:2.8",
    "description": "下跌显著多于上涨"
  }
}

⚠️ 注意事项#

1. 浏览器依赖: 需要 OpenClaw browser 工具可用（自动获取数据时）
2. 网络要求: 需要能访问同花顺问财网站
3. 成交量手动补充: 目前不支持自动获取，需手动补充
4. 缓存清理: 手动删除 cache/ 目录可清空缓存
5. 非交易日: 周末自动往前推，可能不是用户期望的日期

🛠️ 开发状态#

• 目录结构创建
• 数据获取框架（fetch_data.py）
• 报告生成脚本（generate_report.py）
• 手动补充脚本（补数据.py）
• 缓存逻辑
• 非交易日处理
• 浏览器工具集成（调用 OpenClaw browser.snapshot）
• 数据解析逻辑（解析 snapshot 文本）
• 完整流程测试（2026-03-22 测试通过）

📖 相关文档#

• DESIGN.md - 详细设计文档

💡 使用技巧#

批量补充多日数据#

bash

# 连续补充 3 天数据
python3 scripts/补数据.py 2026-03-20 -t 1.20 -p 1.25
python3 scripts/补数据.py 2026-03-21 -t 1.25 -p 1.20
python3 scripts/补数据.py 2026-03-22 -t 1.23 -p 1.25

查看缓存状态#

bash

ls -lh cache/

查看手动数据#

bash

cat manual/2026-03-22.json