📊 trading-briefing

每日交易决策自动化引擎 · 港股 / A股 / 美股 三市联动

Automated daily market briefing for HK / A-share / US markets — powered by Python & AI agents.

English · 中文 · 架构 · 快速开始

---

中文

🎯 一句话定位

每天早 6 点，自动帮你生成一份整合了持仓、宏观、潜力股、博主观点的三市交易决策报告。

✨ 核心能力

模块	做什么	数据源
🌏 三市操作建议	港股 / A股 / 美股 分开给结论	富途 · AKShare
🎯 潜力标的发现	三层漏斗：赛道雷达 → 候选池 → 证据补齐	YouTube · 涨停板 · 财联社 · i问财
📈 技术位置过滤	识别"右侧第一推动"，过滤追高和套牢位	MA / RSI / 量比 / 乖离率
🏭 行业黑名单	申万一级行业 3 年回看，自动剔除坑爹行业	AKShare 申万指数
💰 市值剪枝	>5000 亿非龙头排除 / <50 亿非龙头排除	AKShare
📝 自动归档	同步到腾讯 IMA 知识库，可搜索可引用	IMA OpenAPI

🚀 为什么需要它

现代散户的三个痛点：

1. 信息过载 — 7 个 App 才能凑齐"今天怎么样"
2. 追高焦虑 — 热门股看到时已经 RSI 85
3. 风格漂移 — 看到涨停就追，跌了就砍，毫无纪律

这个工具强行把你的投研流程模板化，每天早上一份报告，纪律替代情绪。

🏗️ 架构

┌─────────────────────────────────────────────────────┐
│                    Data Sources                      │
│  Futu · AKShare · YouTube · Polymarket · i问财       │
└───────────────────────┬─────────────────────────────┘
                        │
┌───────────────────────▼─────────────────────────────┐
│                    Pipeline                          │
│         Collect → Analyze → Filter                   │
└───────────────────────┬─────────────────────────────┘
                        │
┌───────────────────────▼─────────────────────────────┐
│                  Intelligence                        │
│  Opportunity Scanner · Technical Filter · Market    │
└───────────────────────┬─────────────────────────────┘
                        │
┌───────────────────────▼─────────────────────────────┐
│                     Output                           │
│         Markdown Report · IMA Knowledge Base         │
└──────────────────────────────────────────────────────┘

🔧 快速开始

# 1. 克隆
git clone https://github.com/casparzhong/trading-briefing.git
cd trading-briefing

# 2. 一键安装
bash install/install.sh

# 3. 配置
cp config/config.example.yaml config/config.yaml
# 按 config.yaml 注释填入 API keys

# 4. 手动跑一次
python daily_pipeline.py --mode=us_morning

# 5. 上定时任务
# 见 install/automation_guide.md

🔐 必需凭证

必须	可选	用途
无（ManualBroker 模式）	富途 OpenD	真实持仓拉取
无	IMA OpenAPI	报告归档到知识库
无	YouTube Data API	博主视频观点

零配置也能跑：用 ManualBroker 在 yaml 里填持仓，其他数据源全是免费公开 API。

📂 项目结构

trading-briefing/
├── SKILL.md                    # Skill 元信息
├── daily_pipeline.py           # 主编排器
├── opportunity_scanner.py      # 潜力发现（三层漏斗）
├── technical_filter.py         # 右侧第一推动识别
├── market_filter.py            # 市值/行业黑名单
├── brokers/
│   ├── broker_interface.py     # 抽象基类
│   ├── futu_broker.py          # 富途接入
│   └── manual_broker.py        # 零依赖 fallback
├── config/
│   ├── config.example.yaml
│   └── SECRETS.md
├── install/
│   ├── install.sh              # 一键安装
│   ├── setup_guide.md
│   └── automation_guide.md
└── references/
    ├── architecture.md         # 架构详解
    ├── algorithms.md           # 算法说明
    ├── troubleshooting.md      # 常见坑
    └── youtube_setup.md        # OAuth 配置

⚠️ 免责声明

• 本项目是信息聚合工具，不是投资建议
• 所有"操作建议"基于规则生成，不代表未来表现
• 使用者应自行判断，作者不对任何投资损失负责
• 数据源均为公开/授权 API，勿用于商业转售

🤝 贡献

欢迎 PR！特别欢迎：

• 🔌 新 broker（老虎 / 雪盈 / 华泰）
• 📊 新数据源（同花顺 / 东方财富）
• 🌍 海外市场支持（欧股 / 日股）

📄 License

MIT — 自由使用、修改、分发，保留署名即可。

---

English

What it does

Auto-generates a daily trading briefing at 6AM covering HK / A-share / US markets, with holdings analysis, opportunity discovery, technical filtering, and archived to a knowledge base.

Key Features

• 🌏 3-market coverage — HK / A-share / US
• 🎯 Opportunity discovery — 3-layer funnel from track scan to candidate verification
• 📈 Technical filter — Detects "right-side early momentum", filters out overbought & stuck positions
• 🏭 Industry blacklist — SW-L1 industry 3Y lookback, auto-excludes loser sectors
• 💰 Market cap pruning — Excludes >500B non-leaders & <5B micro-caps
• 📝 Auto archive — Syncs to Tencent IMA knowledge base

Quick Start

git clone https://github.com/casparzhong/trading-briefing.git
cd trading-briefing
bash install/install.sh
python daily_pipeline.py --mode=us_morning

Stack

Python 3.10+ · AKShare · futu-api · pywencai · Google API · WorkBuddy Skill SDK

---

If this helped you, please ⭐ star the repo.

Built with 🦉 by Caspar Zhong