Daily Stock Analysis

# Daily Stock Analysis (股票智能分析系统)

> Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection.

LLM-powered stock analysis system for A-share, Hong Kong, and US markets. Automatically fetches quotes, news, and fundamentals, generates AI decision dashboards with buy/sell targets, and pushes results to WeChat/Feishu/Telegram/Discord/Email on a schedule via GitHub Actions — zero server cost.

## What It Does

- **AI Decision Dashboard**: One-line conclusion + precise buy/sell/stop-loss prices + checklist per stock
- **Multi-market**: A-shares (CN), HK stocks, US stocks + indices (SPX, DJI, IXIC)
- **Data sources**: AkShare, Tushare, YFinance for quotes; Tavily/SerpAPI/Brave for news
- **LLM backends**: Gemini, OpenAI, Claude, DeepSeek, Qwen via LiteLLM (unified)
- **Push channels**: WeChat Work, Feishu, Telegram, Discord, DingTalk, Email, PushPlus
- **Automation**: GitHub Actions cron schedule, no server needed
- **Web UI**: Portfolio management, history, backtesting, Agent Q&A
- **Agent**: Multi-turn strategy Q&A with 11 built-in strategies (MA crossover, Elliott Wave, etc.)

## Installation

### Method 1: GitHub Actions (Recommended, Zero Cost)

**Step 1: Fork the repository**
```
https://github.com/ZhuLinsen/daily_stock_analysis
```

**Step 2: Configure Secrets** (`Settings → Secrets and variables → Actions`)

**Required — at least one LLM key:**
```
GEMINI_API_KEY        # Google AI Studio (free tier available)
OPENAI_API_KEY        # OpenAI or compatible (DeepSeek, Qwen, etc.)
OPENAI_BASE_URL       # e.g. https://api.deepseek.com/v1
OPENAI_MODEL          # e.g. deepseek-chat, gpt-4o
AIHUBMIX_KEY          # AIHubMix (recommended, covers Gemini+GPT+Claude+DeepSeek)
ANTHROPIC_API_KEY     # Claude
```

**Required — stock list:**
```
STOCKS                # e.g. 600519,300750,AAPL,TSLA,00700.HK
```

**Required — at least one notification channel:**
```
TELEGRAM_BOT_TOKEN
TELEGRAM_CHAT_ID
FEISHU_WEBHOOK_URL
WECHAT_WEBHOOK_URL
EMAIL_SENDER / EMAIL_PASSWORD / EMAIL_RECEIVERS
DISCORD_WEBHOOK_URL
```

**Step 3: Trigger manually or wait for cron**

Go to `Actions → stock_analysis → Run workflow`

---

### Method 2: Local / Docker

```bash
git clone https://github.com/ZhuLinsen/daily_stock_analysis
cd daily_stock_analysis
cp .env.example .env
# Edit .env with your keys
pip install -r requirements.txt
python main.py
```

**Docker:**
```bash
docker build -t stock-analysis .
docker run --env-file .env stock-analysis
```

**Docker Compose:**
```bash
docker-compose up -d
```

## Configuration

### `.env` File (Local)

```env
# LLM - pick one or more
GEMINI_API_KEY=your_gemini_key
OPENAI_API_KEY=your_openai_key
OPENAI_BASE_URL=https://api.deepseek.com/v1
OPENAI_MODEL=deepseek-chat
AIHUBMIX_KEY=your_aihubmix_key

# Stock list (comma-separated)
STOCKS=600519,300750,AAPL,TSLA,00700.HK

# Notification
TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id

# Optional settings
REPORT_TYPE=full           # simple | full | brief
ANALYSIS_DELAY=10          # seconds between stocks (avoid rate limiting)
MAX_WORKERS=3              # concurrent analysis threads
SINGLE_STOCK_NOTIFY=false  # push each stock immediately when done
NEWS_MAX_AGE_DAYS=3        # ignore news older than N days
```

### Multi-Channel LLM (Advanced)

```env
LLM_CHANNELS=gemini,deepseek,claude
LLM_GEMINI_PROTOCOL=google
LLM_GEMINI_API_KEY=your_key
LLM_GEMINI_MODELS=gemini-2.0-flash,gemini-1.5-pro
LLM_GEMINI_ENABLED=true

LLM_DEEPSEEK_PROTOCOL=openai
LLM_DEEPSEEK_B