Qmt Bridge Fundamental Screen

QMT Trading Skill · 基本面筛选

> 实现状态：✅ screen_financial.py（筛选；下载见 [financial-download](../qmt-bridge-financial-download/SKILL.md)）

目标

基于服务端 xtquant 财务报表缓存 做可验证粗筛；单只或少量标的缺数时脚本可自动补下载。

相关 Skill

| 需求 | Skill | |------|--------| | 只下载 / 批量补缓存 / 下载后验证 | [qmt-bridge-financial-download](../qmt-bridge-financial-download/SKILL.md) | | 按指标筛选 | 本 Skill |

脚本（优先使用）

# 筛选（默认缺数自动 download + 等待 5s）
python skills/qmt-bridge-fundamental-screen/scripts/screen_financial.py \\
  --host HOST --port PORT \\
  --codes 300394.SZ,603986.SH --table Pershareindex

# ROE ≥ 5%（别名 roe → du_return_on_equity）
python skills/qmt-bridge-fundamental-screen/scripts/screen_financial.py \\
  --codes 300394.SZ,603986.SH --table Pershareindex --field roe --min 5

# 关闭自动下载（需已缓存）
python skills/qmt-bridge-fundamental-screen/scripts/screen_financial.py \\
  --codes 600584.SH --no-if-missing

大批量下载请先：

python skills/qmt-bridge-financial-download/scripts/download_financial_data.py \\
  --codes ... --verify

推荐流程（Agent）

1. 解析股票列表与筛选条件
2. 若用户仅要「下载财报」→ 使用 financial-download，不要本脚本
3. 运行 screen_financial.py（默认 --if-missing）
4. 输出：代码 + 中文名 + 指标 + 报告期

主要参数

| 参数 | 说明 | |------|------| | --codes | 必填 | | --table | 默认 Pershareindex | | --field | 筛选字段，支持别名 roe | | --min / --max | 数值过滤（ROE 等为百分点，5 表示 5%） | | --from-positions | 使用当前持仓代码列表 | | --if-missing / --no-if-missing | 缺数自动下载（默认开） | | --download | 查询前强制下载 | | --wait | 下载后等待秒数（默认 5） | | --json | JSON 输出 |

常用字段（Pershareindex）

| 字段 | 含义 | |------|------| | du_return_on_equity | ROE（--field roe） | | s_fa_eps_basic | 基本每股收益 | | s_fa_bps | 每股净资产 |

API

| 操作 | 路径 | |------|------| | 查询 | GET /api/financial/data | | 下载 | POST /api/download/financial_data（或 financial-download Skill） |

安全

• 筛选以只读查询为主；自动/强制下载会写缓存
• 不输出投资建议

参考

• [financial-download](../qmt-bridge-financial-download/SKILL.md) · docs/rest-api.md

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: atorber
• Source: atorber/qmt-trading-skill
• License: MIT
• Homepage: https://atorber.github.io/qmt-trading-skill/

Install and usage instructions live in the source repository linked above.