Clawby Stock Report Generator

基于实时金融数据的 AI 美股分析报告生成器
AI-powered US equity analysis reports, backed by real-time market data

---

这是什么

输入一个美股代码（如 AAPL），系统自动从 Clawby API 拉取行情、做空、暗池、期权、基本面、情绪等 10+ 维度数据，交给 LLM（OpenAI / Anthropic / 本地模型）生成一份结构化分析报告，并附带交互式图表 + PDF 导出。

核心功能

| | 功能 | 说明 | |---|---|---| | 📊 | 多维数据聚合 | 行情、日线、做空量、借券费率、FTD、暗池、期权链 Max Pain、SEC 财务、Reddit 情绪、分红拆股 | | 🤖 | 多 LLM 支持 | OpenAI / Anthropic / DeepSeek / Ollama / 任何兼容 API，UI 中自由切换 | | 📝 | 自定义报告模板 | 4 个内置模板（全面/快速/深度/财报），支持复制后修改 Prompt 和章节 | | 🎨 | 5 个交互式图表 | 价格走势 + MA、做空趋势、暗池分布、期权链、Reddit 情绪 | | 📄 | PDF 导出 | A4 专业排版，封面 + 正文 + 页码，一键下载 | | 🐳 | 一键部署 | Docker Compose 单命令启动，零数据库依赖 |

技术栈

Frontend:   Next.js 14 · React 18 · Tailwind CSS · Recharts · Lucide
Backend:    Python 3.11+ · FastAPI · httpx · Jinja2 · WeasyPrint
Data:       Clawby API (实时金融数据)
LLM:        OpenAI / Anthropic / 兼容接口
Deploy:     Docker Compose

快速开始

git clone https://github.com/RenYuKe-CN/Clawby-Stock-Report-Generator.git
cd Clawby-Stock-Report-Generator
cp .env.example .env
# 编辑 .env 填入 Clawby API Key + LLM API Key
bash setup.sh
# 打开 http://localhost:3000

需要：

• Clawby API Key（免费注册）
• OpenAI / Anthropic API Key（任选一）
• Docker & Docker Compose

数据流

用户输入 AAPL
    ↓
后端并行拉取 (8+ 并发请求)
    ├── 实时报价 & 市值
    ├── 365 天日线 OHLC
    ├── 短成交量 / 短利息 / 借券费率 / FTDs
    ├── 暗池 Levels + Prints
    ├── 期权链 Max Pain
    ├── SEC 财务 (EPS / 收入 / 净利润)
    ├── Reddit 情绪
    └── 分红 / 拆股 / 流通股本
    ↓
Jinja2 模板组装 → LLM 流式生成 → Markdown + 图表 + PDF

截图 / 预览

首页：

┌──────────────────────────────────────────────────┐
│  Clawby Report                           OpenAI ✅│
├──────────────────────────────────────────────────┤
│  [AAPL]     [生成报告]                            │
│  模板: 全面分析  LLM: GPT-4o  模型: gpt-4o        │
├──────────────────────────────────────────────────┤
│  ▶ 正在拉取行情数据...  ████████████░░░░ 68%      │
├──────────────────────────────────────────────────┤
│  ## AAPL 综合分析报告                             │
│  Apple Inc. 当前价格 $245.67...                    │
│  [📈 价格走势图]  [📊 做空趋势]  [📉 期权链]      │
├──────────────────────────────────────────────────┤
│           [下载 Markdown]  [下载 PDF]              │
└──────────────────────────────────────────────────┘

为什么用 Clawby

相比其他数据源（Yahoo Finance、Alpha Vantage、Polygon），Clawby 的优势：

• API 免费 — 注册即可用，有免费额度
• 覆盖全面 — 一个 API 搞定行情、做空、暗池、期权、SEC 财务、Reddit 情绪等 10+ 维度
• 实时性好 — Screener 数据实时，Quote 仅延迟 30 分钟
• 美股专精 — 数据质量高，专门针对 US 市场优化

开源说明

MIT License，欢迎 PR、Issue、Star。

仓库地址：
https://github.com/RenYuKe-CN/Clawby-Stock-Report-Generator

附：

• 完整开发文档 (中文)
• AI Agent 安装引导 (英文)

---

Not investment advice. For informational purposes only.