# daily_stock_analysis: AI phân tích cổ phiếu mỗi ngày — hướng dẫn cài đặt và dùng

> daily_stock_analysis là hệ thống viết bằng Python, dùng mô hình AI lớn để phân tích danh sách cổ phiếu của bạn (A-share, Hồng Kông, Mỹ, Nhật, Hàn, Đài Loan) rồi gửi báo cáo định kỳ qua Telegram, Discord, Slack, email và các kênh khác. Cách dễ nhất là Fork repo rồi chạy bằng GitHub Actions, không cần máy chủ; chạy trên máy cá nhân cũng chỉ cần vài lệnh. Phần khó nhất là xin API key của dịch vụ AI và điền cấu hình đúng chỗ.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-01 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/daily-stock-analysis-ai-phan-tich-co-phieu-moi-ngay

daily_stock_analysis là một hệ thống phân tích cổ phiếu chạy bằng AI. Bạn khai báo danh sách mã mình quan tâm, hệ thống tự lấy giá, tin tức, rồi nhờ mô hình ngôn ngữ lớn viết ra một bản "bảng quyết định" cho từng mã và gửi thẳng vào ứng dụng nhắn tin của bạn.

Repo hợp với người có theo dõi cổ phiếu nhưng không có thời gian đọc tin mỗi ngày: nhà đầu tư cá nhân, chủ doanh nghiệp có danh mục nhỏ, hoặc lập trình viên mới muốn xem một dự án AI thực tế chạy thế nào. Hiện repo có khoảng 71.000 sao và 57.000 fork, giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây.

Điểm đáng giá nhất là cách chạy "không cần máy chủ": Fork repo về tài khoản GitHub, điền vài khoá bí mật, và GitHub Actions sẽ tự chạy theo lịch. Nếu muốn xem cách người làm video giới thiệu, bạn xem video ngắn bên dưới.

```repo
- repo | ZhuLinsen/daily_stock_analysis
- kind | Ứng dụng
- desc | Hệ thống dùng AI phân tích cổ phiếu nhiều thị trường, mỗi ngày tự gửi báo cáo "bảng quyết định" qua Telegram, Discord, Slack, email.
- stars | 71k
- lang | Python
- license | MIT
```

```video
- youtube | https://youtube.com/shorts/-M0ao5rd6Sk
- facebook | https://www.facebook.com/reel/1126018660033180
- title | Video giới thiệu daily_stock_analysis
```

## daily_stock_analysis làm được gì

Dưới đây là các năng lực chính, nói theo lợi ích thực tế.

**Báo cáo quyết định bằng AI.** Mỗi mã cổ phiếu có kết luận chính, điểm số, xu hướng, vùng mua bán, cảnh báo rủi ro, yếu tố tích cực và một danh sách kiểm tra thao tác. Bạn không phải tự gom thông tin từ nhiều nơi, chỉ cần đọc một tin nhắn.

**Nhiều thị trường trong một chỗ.** Hệ thống hỗ trợ cổ phiếu A-share (Trung Quốc đại lục), Hồng Kông, Mỹ, Nhật, Hàn, Đài Loan và cả ETF. Dữ liệu gồm giá, nến, chỉ báo kỹ thuật, tin tức, công bố thông tin và dữ liệu cơ bản. Mỗi thị trường có giới hạn riêng về nguồn dữ liệu, README có mục riêng về phần này.

**Giao diện web và bản desktop.** Bạn có thể phân tích thủ công, xem tiến độ tác vụ, đọc lại báo cáo cũ ở dạng Markdown đầy đủ, chạy backtest, quản lý vị thế đang giữ và chỉnh cấu hình. Có cả giao diện sáng và tối.

**Hỏi đáp theo chiến lược (Agent).** Trên trang chat của giao diện web, bạn hỏi tiếp nhiều lượt về một mã. README ghi có 15 chiến lược dựng sẵn như đường trung bình, Chan Lun (缠论), sóng Elliott, xu hướng, chủ đề nóng, sự kiện, tăng trưởng. Agent có thể gọi giá, nến, chỉ báo và tin tức để trả lời.

**Nhập danh sách thông minh.** Bạn có thể nhập mã từ ảnh, file CSV/Excel hoặc từ bộ nhớ tạm (clipboard). Hệ thống còn gợi ý mã theo tên, pinyin hoặc biệt danh.

**Tự động và đẩy tin.** Chạy bằng GitHub Actions, Docker, tác vụ định kỳ trên máy, hoặc dịch vụ FastAPI. Kênh nhận gồm WeCom (企业微信), Feishu (飞书), Telegram, Discord, Slack và email. Bản cấu hình mẫu còn có biến cho DingTalk.

Về nguồn dữ liệu, README nói mặc định có sẵn các nguồn miễn phí như AkShare, Baostock, YFinance nên chạy được mà không cấu hình thêm. Tuy vậy các nguồn này phụ thuộc giới hạn truy cập và thay đổi của phía cung cấp, nên độ ổn định không được đảm bảo. Nếu chạy đều đặn hoặc phân tích nhiều mã, README khuyên cân nhắc thêm Tushare hoặc Longbridge.

## Cần chuẩn bị gì

Theo README, bạn cần những thứ sau tuỳ cách chạy:

- **Tài khoản GitHub**, nếu chọn cách chạy bằng GitHub Actions (cách README khuyên dùng).
- **Ít nhất một API key của dịch vụ AI.** README liệt kê Modelflare, AIHubMix, Gemini, Claude (Anthropic), OpenAI hoặc dịch vụ tương thích OpenAI (như DeepSeek, Qwen), và Ollama cho mô hình chạy cục bộ. Ollama phù hợp chạy trên máy hoặc Docker, còn với GitHub Actions README khuyên dùng API trên đám mây.
- **Ít nhất một kênh nhận thông báo**, ví dụ bot Telegram (cần token bot và chat ID), webhook Discord, hoặc tài khoản email gửi.
- **Danh sách cổ phiếu** để điền vào biến `STOCK_LIST`.
- **Khoá tìm kiếm tin tức** (khuyến nghị, không bắt buộc), ví dụ SerpAPI, Tavily, Brave hoặc SearXNG tự dựng. README nói tin tức ảnh hưởng nhiều đến chất lượng phần dư luận và sự kiện.
- **Nếu chạy trên máy:** cần Python và pip để chạy `pip install -r requirements.txt`, cùng Git để clone. README chưa ghi rõ phiên bản Python tối thiểu; bạn xem thêm trong `pyproject.toml` của repo.

Tư liệu không nói gì về yêu cầu GPU hay cấu hình phần cứng, nên với cách dùng API đám mây bạn không cần chuẩn bị gì thêm.

```note
API key và webhook là thông tin bí mật. Chỉ điền vào mục Secrets của GitHub hoặc file .env trên máy bạn, đừng dán vào tin nhắn, ảnh chụp màn hình hay file công khai. Một số dịch vụ AI và tìm kiếm tính phí theo lượng dùng, hãy kiểm tra bảng giá của nhà cung cấp bạn chọn.
```

## Cài đặt từng bước

Có hai đường: chạy bằng GitHub Actions (không cần máy chủ) hoặc chạy trên máy của bạn. Mình hướng dẫn cả hai.

```steps
- Fork repo | Sao chép repo về tài khoản GitHub của bạn
- Điền Secrets | Nhập API key AI, kênh thông báo và STOCK_LIST
- Bật Actions | Cho phép workflow chạy trong tab Actions
- Chạy thử | Bấm Run workflow để nhận báo cáo đầu tiên
- Hoặc chạy trên máy | Clone, cài thư viện, tạo .env, chạy python main.py
```

### Fork repo về tài khoản của bạn

Vào trang repo trên GitHub, bấm nút `Fork` ở góc phải trên. Bạn sẽ có một bản sao riêng trong tài khoản của mình. Các bước sau đều làm trên bản sao này, không phải bản gốc.

### Điền Secrets cho AI, thông báo và danh sách mã

Trong bản Fork của bạn, vào `Settings` → `Secrets and variables` → `Actions` → `New repository secret`. Mỗi secret gồm tên và giá trị. Tên phải gõ đúng như README, giá trị là key của bạn.

Nhóm AI (cần ít nhất một). Ví dụ các tên README nêu: `MODELFLARE_KEY`, `AIHUBMIX_KEY`, `GEMINI_API_KEY`, `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`. Nếu dùng dịch vụ tương thích OpenAI, điền thêm `OPENAI_BASE_URL` và `OPENAI_MODEL`.

Nhóm thông báo (cần ít nhất một). Ví dụ: `TELEGRAM_BOT_TOKEN` cùng `TELEGRAM_CHAT_ID`; hoặc `DISCORD_WEBHOOK_URL`; hoặc `SLACK_BOT_TOKEN` cùng `SLACK_CHANNEL_ID`; hoặc `EMAIL_SENDER` cùng `EMAIL_PASSWORD`.

Danh sách cổ phiếu (bắt buộc) đặt trong secret `STOCK_LIST`. README cho ví dụ giá trị như sau, các mã cách nhau bằng dấu phẩy:

```text
600519,hk00700,AAPL,7203.T,005930.KS,2330.TW
```

Cách đọc: `600519` là mã A-share, `hk00700` là Hồng Kông, `AAPL` là Mỹ, `7203.T` là Nhật, `005930.KS` là Hàn, `2330.TW` là Đài Loan.

Nếu muốn tin tức tốt hơn, thêm một khoá tìm kiếm như `SERPAPI_API_KEYS` hoặc `TAVILY_API_KEYS`. Chỗ người mới hay vấp: tên secret có "S" ở cuối (`..._KEYS`) với nhóm tìm kiếm, đừng gõ nhầm thành số ít.

### Bật Actions

Vào tab `Actions` của bản Fork, bấm nút `I understand my workflows, go ahead and enable them`. GitHub tắt workflow mặc định trên bản Fork, nên bước này không thể bỏ qua.

### Chạy thử thủ công

Vào `Actions` → chọn workflow tên `每日股票分析` → bấm `Run workflow` → bấm `Run workflow` lần nữa. Chờ vài phút, nếu mọi thứ đúng bạn sẽ nhận báo cáo ở kênh đã cấu hình. Theo README, sau đó hệ thống tự chạy vào 18:00 giờ Bắc Kinh các ngày làm việc, và mặc định bỏ qua ngày nghỉ của các thị trường A, H, US.

### Hoặc chạy trên máy của bạn

Mở terminal (trên Windows là PowerShell hoặc Git Bash) tại thư mục bạn muốn đặt dự án, rồi chạy các lệnh trong README:

```bash
# 克隆项目
git clone https://github.com/ZhuLinsen/daily_stock_analysis.git && cd daily_stock_analysis

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

# 配置环境变量
cp .env.example .env && vim .env

# 运行分析
python main.py
```

Giải thích: lệnh đầu tải mã nguồn về và vào thư mục dự án; lệnh thứ hai cài thư viện Python cần thiết; lệnh thứ ba sao chép file cấu hình mẫu thành `.env` rồi mở bằng trình soạn thảo vim; lệnh cuối chạy phân tích.

Với người dùng Windows: `cp` và `vim` có thể không có sẵn. Bạn có thể tạo file `.env` bằng PowerShell rồi mở bằng Notepad:

```powershell
Copy-Item .env.example .env
notepad .env
```

Trong file `.env`, bạn điền giá trị cho các biến như `STOCK_LIST`, `GEMINI_API_KEY` (hoặc key của dịch vụ AI bạn chọn) và các biến thông báo. Tên biến có sẵn trong `.env.example`, mở file đó ra xem là thấy. Lưu file lại trước khi chạy `python main.py`.

## Kiểm tra đã chạy được chưa

Với GitHub Actions: sau khi bấm `Run workflow`, vào tab `Actions` xem lượt chạy mới có dấu xanh (thành công) không, đồng thời kiểm tra kênh thông báo đã nhận tin chưa. README nói log có thể hiện dòng "chưa cấu hình" cho các nguồn dữ liệu tuỳ chọn, và những dòng đó không ảnh hưởng việc chạy.

Với chạy trên máy: chạy thử không gửi gì bằng lệnh dưới đây, hoặc bật log chi tiết:

```bash
python main.py --dry-run
python main.py --debug
```

README không giải thích chi tiết `--dry-run` làm gì, nên mình chỉ gợi ý bạn thử nó trước, rồi đối chiếu với tài liệu trong thư mục `docs/` của repo.

Kết quả mong đợi là một bản tin dạng "bảng quyết định": đầu tin ghi số mã đã phân tích và tổng hợp mua, theo dõi, bán; sau đó là điểm số, xu hướng và các mục rủi ro, yếu tố tích cực, tin mới nhất cho từng mã.

Nếu muốn xem giao diện web, chạy lệnh sau rồi mở `http://127.0.0.1:8000` trên trình duyệt:

```bash
python main.py --webui
```

## Dùng vào việc thật

### Nhà đầu tư cá nhân nhận bản tin mỗi chiều

Bạn giữ vài mã cổ phiếu và không muốn mở nhiều trang mỗi ngày. Bạn Fork repo, điền `STOCK_LIST` với các mã của mình, nối với một bot Telegram và để GitHub Actions chạy theo lịch. Mỗi ngày làm việc, bạn nhận một tin tóm tắt cho từng mã: điểm số, xu hướng, rủi ro, yếu tố hỗ trợ. Bạn dùng nó như bản ghi chú để quyết định xem mã nào cần đọc kỹ hơn, không phải để làm theo mù quáng.

> Đừng coi AI là người quyết định: hãy coi nó là người đọc tin giúp bạn.
>
> — Ông T

### Phân tích nhanh một vài mã không có trong danh sách

Bạn vừa nghe nhắc một mã Mỹ và một mã Hồng Kông, chưa muốn thêm vào danh sách cố định. Trên máy, bạn chạy lệnh có sẵn trong README, truyền mã trực tiếp:

```bash
python main.py --stocks 600519,hk00700,AAPL,2330.TW
```

Bạn đổi các mã thành mã bạn quan tâm. Kết quả là báo cáo cho đúng các mã đó trong lần chạy này.

### Đọc tổng quan thị trường trước giờ họp

Bạn là chủ doanh nghiệp, cần nắm tình hình chung chứ không phải từng mã. README có lệnh chạy "đại bàn phục bàn" (大盘复盘, tổng kết thị trường):

```bash
python main.py --market-review
```

Bản mẫu trong README gồm các chỉ số chính, số mã tăng giảm, số mã tăng trần giảm sàn và các nhóm ngành dẫn dắt hoặc kéo giảm. Bạn đọc trong vài phút thay vì lướt nhiều nơi.

### Hỏi đáp sâu về một mã bằng Agent

Bạn là lập trình viên mới và muốn thử hỏi AI về một mã theo một góc nhìn cụ thể. Bạn bật giao diện web bằng `python main.py --webui`, vào trang `/chat`, rồi hỏi tiếp nhiều lượt. Ví dụ prompt mẫu:

```text
Phân tích mã AAPL theo xu hướng và đường trung bình. Rủi ro lớn nhất hiện giờ là gì?
```

README ghi Agent dùng được dữ liệu giá, nến, chỉ báo và tin tức, và cho phép xuất hội thoại hoặc gửi sang kênh thông báo. Bạn cần đã cấu hình ít nhất một API key AI hợp lệ thì trang chat mới dùng được. Cách khác là chạy dịch vụ ở chế độ hằng ngày: `python main.py --schedule` cho tác vụ định kỳ trên máy, hoặc `python main.py --serve-only` cho dịch vụ API.

## Lỗi hay gặp và cách xử lý

**Chạy xong nhưng không nhận được tin nhắn.** Thường do chưa điền kênh thông báo, hoặc điền sai tên secret. Kiểm tra lại tên đúng như README (ví dụ `TELEGRAM_BOT_TOKEN` và `TELEGRAM_CHAT_ID` phải có đủ cả hai). Sau đó xem log của lượt chạy trong tab `Actions` để biết dòng nào báo lỗi.

**Workflow không chạy trên bản Fork.** Bạn chưa bấm bật Actions. Vào tab `Actions` và bấm nút cho phép chạy workflow như ở bước trên. Ngoài ra, mặc định hệ thống bỏ qua ngày nghỉ của thị trường, nên nếu chạy vào ngày nghỉ mà không thấy gì thì chưa hẳn là lỗi. README có nói về cách buộc chạy trong "完整指南" (hướng dẫn đầy đủ).

**Thiếu dữ liệu hoặc lỗi lấy giá.** Các nguồn miễn phí mặc định có thể bị giới hạn truy cập hoặc thay đổi giao diện. Cách an toàn: chạy lại sau một lúc, hoặc thêm một nguồn có token như `TUSHARE_TOKEN` (cho A-share) theo README.

**Báo lỗi liên quan key AI.** Key sai, hết hạn mức, hoặc chọn sai dịch vụ. Kiểm tra lại key trong trang quản lý của nhà cung cấp, đừng dán key vào nơi công khai. Nếu dùng dịch vụ tương thích OpenAI, nhớ điền cả `OPENAI_BASE_URL` và `OPENAI_MODEL`.

**Lệnh `cp` hoặc `vim` không chạy trên Windows.** Hai lệnh này thuộc môi trường Linux/macOS. Dùng `Copy-Item .env.example .env` và `notepad .env` như đã nêu ở trên, hoặc mở terminal Git Bash.

## Có nên dùng không

**Điểm mạnh.** Cách chạy bằng GitHub Actions rất gọn: không cần máy chủ, không cần máy bật suốt. Repo hỗ trợ nhiều thị trường, nhiều mô hình AI và nhiều kênh thông báo, nên khó bị "kẹt" vào một dịch vụ. Có sẵn giao diện web và Agent hỏi đáp nếu bạn muốn đi xa hơn một bản tin hằng ngày. Giấy phép MIT, mã nguồn mở, và vẫn được cập nhật.

**Giới hạn.** README viết bằng tiếng Trung và nhiều thao tác nhắc đến dịch vụ của Trung Quốc (WeCom, Feishu), nên người dùng Việt có thể cần dịch bằng công cụ. Nguồn dữ liệu miễn phí không được đảm bảo ổn định. Chất lượng bản tin phụ thuộc vào mô hình AI và nguồn tin bạn chọn. Tư liệu không nêu chi phí cụ thể, vì thế bạn nên xem bảng giá của dịch vụ AI và tìm kiếm mình dùng.

**Quan trọng.** Tác giả ghi rõ dự án chỉ phục vụ học tập và nghiên cứu, không phải lời khuyên đầu tư, và không chịu trách nhiệm về thua lỗ khi sử dụng. Mình cũng khuyên bạn đối chiếu thêm nguồn khác trước khi ra quyết định mua bán thật.

**Khi nào chọn cách khác.** Nếu bạn cần dữ liệu thời gian thực chính xác, hoặc cần hệ thống giao dịch tự động, repo này không nhằm mục đích đó. Nếu chỉ muốn xem biểu đồ và tin cơ bản, các ứng dụng chứng khoán có sẵn có thể đủ và dễ dùng hơn.

## Câu hỏi thường gặp

### daily_stock_analysis có miễn phí không?

Mã nguồn dùng giấy phép MIT nên bạn dùng tự do. Mô tả của tác giả nói hệ thống hỗ trợ chạy định kỳ không tốn phí, và README cho biết có sẵn các nguồn giá miễn phí. Tuy nhiên dịch vụ AI và dịch vụ tìm kiếm tin tức bạn chọn có thể tính phí riêng, tư liệu không nêu rõ mức phí, nên bạn cần xem bảng giá của từng nhà cung cấp.

### Cài đặt có cần máy chủ hoặc GPU không?

Không cần máy chủ nếu chạy bằng GitHub Actions: README ghi triển khai trong khoảng 5 phút và không cần máy chủ. Tư liệu không nhắc đến yêu cầu GPU. Ollama (mô hình cục bộ) được README coi là hợp với chạy trên máy hoặc Docker, còn Actions nên dùng API đám mây.

### Chạy được trên Windows không?

Cách GitHub Actions chạy trên nền tảng của GitHub nên không phụ thuộc hệ điều hành của bạn. Với chạy cục bộ, README dùng lệnh kiểu Linux/macOS (cp, vim), còn tư liệu không nói riêng về Windows. Bạn có thể thay bằng Copy-Item và notepad trong PowerShell, hoặc dùng Git Bash.

### Hệ thống hỗ trợ những thị trường nào?

README ghi A-share, Hồng Kông, Mỹ, Nhật, Hàn, Đài Loan và ETF. Mã được viết theo từng kiểu, ví dụ 600519, hk00700, AAPL, 7203.T, 005930.KS, 2330.TW. Khả năng và nguồn dữ liệu của từng thị trường khác nhau, README có tài liệu riêng về giới hạn của từng thị trường.

### Kết quả phân tích có đáng tin để đầu tư không?

Tác giả nói rõ dự án chỉ để học tập và nghiên cứu, không phải lời khuyên đầu tư, và không chịu trách nhiệm cho thua lỗ. Nguồn giá miễn phí cũng không được đảm bảo ổn định. Bạn nên coi báo cáo là thông tin tham khảo và tự kiểm chứng thêm.

### Dữ liệu và API key của tôi có an toàn không?

Tư liệu không có thông tin riêng về bảo mật dữ liệu. Với GitHub Actions, key được lưu trong mục Secrets của chính bản Fork của bạn, và khi chạy cục bộ thì nằm trong file .env trên máy. Dù vậy, danh sách mã và nội dung phân tích sẽ được gửi tới dịch vụ AI, tìm kiếm mà bạn chọn, nên hãy đọc chính sách của họ.

### Có thể dùng mô hình AI chạy cục bộ thay vì API trả phí không?

README liệt kê Ollama (mô hình cục bộ) trong danh sách mô hình hỗ trợ và nói nó phù hợp với chạy cục bộ hoặc Docker. Tư liệu không cho biết cấu hình máy tối thiểu hay chất lượng kết quả so với các mô hình đám mây. Chi tiết nằm trong hướng dẫn cấu hình mô hình của repo.
