观点——证据 · 研报验证工具
> SkillHub 版本 v1.2 | 纯研报自动化获取 | 快速验证投资观点的研报支撑
功能简介
一句话说明：输入中信行业 + 多空方向 + 关键词，自动从东财数据库抓取研报并生成验证报告 PDF。
适用场景
- ✅ 快速验证"XX 行业 / 看多-看空 / 关键词"是否有研报证据
- ✅ 10 分钟内输出：PDF 报告 + 研报原文压缩包
- ✅ 投研报告收集、观点佐证
输入四要素
| 序号 | 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
| 1 | 中信一级行业 | 枚举 | 必填，30 个固定值 | 银行、医药 |
| 2 | 多空方向 | 枚举 | 必填，三选一 | 看多、看空、中性 |
| 3 | 关键词 | 字符串 | 必填，原样透传 | 高股息红利、出海 |
| 4 | 时间范围 | 字符串 | 必填 | 最近1个月、2026年至今 |
30 个中信一级行业
银行、 非银金融、 房地产、 交通运输、 家电、 煤炭、 钢铁、 电子、 汽车、 电力设备及新能源、 基础化工、 建材、 纺织服装、 轻工制造、 商零售、 消费者服务、 食品饮料、 农林牧渔、 医药、 电力及公用事业、 机械、 国防军工、 计算机、 传媒、 通信、 石油石化、 有色金属、 环保与公共事业、 综合
执行流程
Step 1：解析用户输入
确认行业代码、方向、关键词、时间范围。
Step 2：调用研报获取脚本
python scripts/main.py --industry 银行 --direction 看多 --keyword 高股息 --time 最近1个月
脚本自动执行：
1. 东财成分股 API → 获取行业成分股列表
2. 东财行业研报 API → 获取行业研报列表
3. 东财个股研报 API → 遍历成分股获取个股研报
4. 东财 PDF 直链下载 → https://pdf.dfcfw.com/pdf/H3_{infoCode}_1.pdf
5. 关键词过滤 → 筛选匹配的研报
Step 3：生成验证报告
脚本自动生成：
- 观点验证报告_{行业}_{方向}_{日期}.html
- 观点验证报告_{行业}_{方向}_{日期}.pdf（如安装了 wkhtmltopdf 或 weasyprint）
- 研报PDF/ 目录下各研报原文 PDF
Step 4：打包交付
脚本自动将所有文件打包为 ZIP：
- 观点验证_{行业}_{方向}_{日期}.zip
输出示例
output/ve_银行_20260616/
├── 观点验证报告_银行_看多_20260616.html
├── 观点验证报告_银行_看多_20260616.pdf
├── 观点验证_银行_看多_20260616.zip
└── 研报PDF/
├── 研报_行业_AP00xxxx.pdf
├── 研报_个股_00xxxxxx.pdf
└── ...
依赖安装
# 必需
pip install requests beautifulsoup4
# PDF生成（可选二选一）
pip install weasyprint # 方式1
# 或
apt install wkhtmltopdf # 方式2 (Linux)
brew install wkhtmltopdf # 方式2 (macOS)
快速开始
方式1：直接调用 Python
# Windows PowerShell 需设置 UTF-8 编码
$env:PYTHONIOENCODING='utf-8'
python scripts/main.py -i 银行 -d 看多 -k "高股息" -t "最近1个月"
方式2：通过 AI Agent 调用
当用户提供行业+方向+关键词时，执行：
import subprocess, os
os.environ["PYTHONIOENCODING"] = "utf-8" # Windows 必需
result = subprocess.run([
"python", "scripts/main.py",
"--industry", "银行",
"--direction", "看多",
"--keyword", "高股息红利",
"--time", "最近1个月"
], capture_output=True, text=True, cwd="skills/viewpoint-evidence")
print(result.stdout)
字段说明
| 字段 | 含义 |
|---|---|
| 行业 | 中信一级行业分类 |
| 方向 | 看多=看好上涨 / 看空=看跌或回避 / 中性=无明确方向 |
| 关键词 | 用户提供的原词，不做二次改写 |
| 时间范围 | 支持"最近1/3/6个月"、"2026年至今"、"具体日期区间" |
注意事项
- 东财 API 节流：脚本内置 1 秒间隔避免被限流
- PDF 下载失败：部分研报无直链或已下架，脚本会跳过并继续
- PDF 生成依赖：如未安装 wkhtmltopdf/weasyprint，仅生成 HTML
- 成分股遍历限制：默认最多 10 只股票，每只 5 份研报，避免超时
- Windows 编码：PowerShell 环境必须设置
$env:PYTHONIOENCODING='utf-8' - API 接口：
- 行业研报：reportapi.eastmoney.com/report/list（qType=1）
- 个股研报：reportapi.eastmoney.com/report/list（qType=0）
- 成分股：push2.eastmoney.com/api/qt/clist/get
风险提示
> ⚠️ 本工具仅供参考，不构成任何投资建议。观点验证基于公开研报数据，不代表对未来走势的预测。投资有风险，决策需谨慎。
版本信息
- v1.0-SH (2026-06-16)：SkillHub 首发版
- v1.1-SH (2026-06-16)：修复东财 API 失效问题
- v1.2-SH (2026-06-16)：优化报告 HTML 格式，新增统计卡片和方向标签
