qmt-bridge-financial-downloadlisted
Install: claude install-skill Serennity007/qmt-trading-skill
# QMT Trading Skill · 财报下载
> **实现状态**:✅ `download_financial_data.py`
## 目标
向 Bridge 服务端 **写入** 财务数据缓存,供后续 `GET /api/financial/data` 或 [fundamental-screen](../qmt-bridge-fundamental-screen/SKILL.md) 使用。
## 何时用本 Skill(而非筛选 Skill)
| 场景 | 使用 |
|------|------|
| 用户明确要「下载/补全/刷新」财报 | **本 Skill** |
| 批量标的、指定表、下载后验证 | **本 Skill** |
| 按 ROE/EPS 等指标筛选 | [fundamental-screen](../qmt-bridge-fundamental-screen/SKILL.md) |
| 筛选时偶发缺数 | 筛选脚本默认 `--if-missing`;大批量仍建议先本 Skill |
## 脚本
```bash
# 下载每股指标表(默认 Pershareindex)
python skills/qmt-bridge-financial-download/scripts/download_financial_data.py \\
--host HOST --port PORT \\
--codes 600584.SH,603986.SH --table Pershareindex
# 下载后验证缓存是否有数据
python skills/qmt-bridge-financial-download/scripts/download_financial_data.py \\
--codes 600584.SH --verify --wait 8
# 下载全部财务表(较慢,勿对全市场使用)
python skills/qmt-bridge-financial-download/scripts/download_financial_data.py \\
--codes 600519.SH --all-tables --verify
```
`python skills/qmt-bridge-financial-download/scripts/download_financial_data.py` 与上述参数相同。
## 推荐流程(Agent)
```
1. 确认用户给出的股票列表(勿擅自扩大为全市场)
2. 说明:下载会写服务端缓存,可能耗时数秒~数十秒
3. 运行 download_financial_data.py,建议加 --verify
4. 若有仍无数据的代码:加大 --wait、检查 QMT 是否登录、或换表名
5. 需要筛选时,再运行 fundamental-screen 的 screen_financial.py
```
## 主要参数
| 参数 | 说明 |
|------|------|
| `--codes` | 必填,逗号分隔 |
| `--table` | 默认 `Pershareindex` |
| `--all-tables` | 下载全部表(慢) |
| `--start-time` / `--end-time` | 可选 YYYYMMDD |
| `--wait` | 下载后等待秒数(默认 5) |
| `--verify` | 等待后查询缓存;仍缺数