股票分析 Agent — 汇量科技 1860.HK

无状态、零基础设施的港股舆情分析 Agent：自动采集当日雪球/Reddit 评论，LLM 情绪评分，飞书定时推报告。无需数据库和 Redis，直接跑在 GitHub Actions 上。

---

项目简介

本项目通过多个数据采集器（雪球、Reddit、港交所披露易、Yahoo Finance）持续收集与汇量科技相关的舆情与市场数据，利用 Claude API 进行情绪打分与主题提炼，并在每天固定时间（09:00 / 12:00 / 15:00）通过飞书 Webhook 自动推送晨报、午报、收盘报。

---

架构图

┌─────────────────────────────────────────────────────────────────┐
│                       Orchestrator Agent                        │
│              (协调采集 → 分析 → 报告整个流程)                        │
└───────┬────────────────┬────────────────┬───────────────────────┘
        │                │                │
   ┌────▼────┐      ┌────▼────┐     ┌─────▼─────┐
   │Sentiment│      │Industry │     │ Financial │
   │  Agent  │      │  Agent  │     │   Agent   │
   └────┬────┘      └────┬────┘     └─────┬─────┘
        │                │                │
┌───────▼────────────────▼────────────────▼────────────┐
│                    Collectors Layer                    │
│  ┌──────────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌────────┐  │
│  │  Xueqiu  │ │Reddit│ │ HKEX │ │Yahoo │ │Futu/   │  │
│  │(Playwright│ │(PRAW)│ │(HTTP)│ │Fin.  │ │Tiger   │  │
│  └────┬─────┘ └──┬───┘ └──┬───┘ └──┬───┘ └───┬────┘  │
└───────┼──────────┼────────┼────────┼──────────┼───────┘
        └──────────┴────────┴────────┴──────────┘
                            │
              ┌─────────────▼──────────────┐
              │  (无状态，不依赖数据库/Redis)  │
              └─────────────┬──────────────┘
                            │
              ┌─────────────▼──────────────┐
              │      Analysis Layer         │
              │  Claude API · 情绪分析       │
              │  竞对比较 · 财务指标          │
              └─────────────┬──────────────┘
                            │
              ┌─────────────▼──────────────┐
              │      Reporter Layer         │
              │  飞书富文本卡片 · 晨/午/收盘报 │
              └────────────────────────────┘

---

快速开始

1. 环境准备

# 克隆项目
git clone <repo-url>
cd stock-analysis-agent

# 创建虚拟环境（推荐 Python 3.11+）
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 安装 Playwright 浏览器
playwright install chromium

2. 配置环境变量

cp .env.example .env
# 编辑 .env，填入各平台密钥

3. 启动调度器

python scripts/run.py

或直接测试单次报告：

python scripts/run_job.py morning

6. 历史数据回填

python scripts/backfill.py --ticker 1860.HK --days 30

---

🚀 GitHub Actions 部署（推荐）

无需服务器，直接用 GitHub Actions 免费运行，每天自动推送三次报告。

1. Fork 本仓库

2. 配置 Secrets

进入仓库 Settings → Secrets and variables → Actions → New repository secret，添加以下 secrets：

Secret 名称	必填	说明
LLM_PROVIDER	✅	选择模型：claude / qwen / kimi / glm / minimax
LLM_MODEL	可选	指定模型名，留空用默认值
CLAUDE_API_KEY	按需	Anthropic API Key（LLM_PROVIDER=claude 时填）
QWEN_API_KEY	按需	阿里云 DashScope Key（LLM_PROVIDER=qwen 时填）
KIMI_API_KEY	按需	Moonshot Kimi Key（LLM_PROVIDER=kimi 时填）
GLM_API_KEY	按需	智谱 GLM Key（LLM_PROVIDER=glm 时填）
MINIMAX_API_KEY	按需	MiniMax Key（LLM_PROVIDER=minimax 时填）
FEISHU_WEBHOOK	✅	飞书机器人 Webhook URL
REDDIT_CLIENT_ID	✅	Reddit App Client ID
REDDIT_CLIENT_SECRET	✅	Reddit App Secret
REDDIT_USERNAME	✅	Reddit 账号用户名
REDDIT_PASSWORD	✅	Reddit 账号密码
XUEQIU_COOKIES	✅	雪球登录 Cookie（JSON 字符串）

3. 启用 Workflow

进入仓库 Actions 标签页 → 启用 Workflows。

4. 触发时间（自动）

Workflow	Cron (UTC)	HKT 时间
晨报	0 1 * * 1-5	周一至周五 09:00
午报	0 4 * * 1-5	周一至周五 12:00
收盘报	0 7 * * 1-5	周一至周五 15:00

5. 手动触发（测试）

Actions → 📊 Stock Reports → Run workflow → 选择报告类型 → Run。

---

配置说明

变量	说明	示例
LLM_PROVIDER	LLM 提供商	claude / qwen / kimi / glm / minimax
CLAUDE_API_KEY	Anthropic Claude API 密钥	sk-ant-...
FEISHU_WEBHOOK	飞书机器人 Webhook URL	https://open.feishu.cn/open-apis/bot/v2/hook/xxx
REDDIT_CLIENT_ID	Reddit App Client ID	—
REDDIT_CLIENT_SECRET	Reddit App Secret	—
REDDIT_USER_AGENT	Reddit 请求 UA	StockBot/1.0
FUTU_HOST	FutuOpenD 服务地址	127.0.0.1
FUTU_PORT	FutuOpenD 服务端口	11111
TIGER_TIGER_ID	Tiger Broker Tiger ID	—
TIGER_PRIVATE_KEY	Tiger RSA 私钥	—

---

目录结构

stock-analysis-agent/
├── config/            # 全局配置（pydantic-settings）
├── src/
│   ├── collectors/    # 数据采集层（雪球/Reddit/HKEX/Yahoo）
│   ├── analysis/      # LLM 情绪分析（多提供商）
│   ├── scheduler/     # APScheduler 定时任务
│   └── reporters/     # 飞书报告推送
├── tests/             # 单元测试
└── scripts/           # 入口脚本（run.py / run_job.py）

---

监控指标（汇量科技 1860.HK）

• 主要竞对：AppLovin（APP）、Unity Ads（U）、Digital Turbine（APPS）
• 核心业务：程序化广告（Mintegral DSP/SSP）、移动应用发行
• 关键词：Mobvista, Mintegral, 汇量科技, 1860.HK
• 港交所公告分类：业绩公告（P3）、回购（P2）、股权变动（P2）、一般公告（P1）

---

License

MIT