daily_stock_analysis: AI phân tích cổ phiếu, tự đẩy báo cáo mỗi ngày — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về ZhuLinsen/daily_stock_analysis — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: 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 →

Tóm tắt nhanh
daily_stock_analysis là hệ thống mã nguồn mở viết bằng Python, dùng mô hình ngôn ngữ lớn để phân tích cổ phiếu (A-share, Hồng Kông, Mỹ, Nhật, Hàn, Đài Loan) và gửi báo cáo “bảng quyết định” mỗi ngày. Bạn có thể chạy miễn phí trên GitHub Actions, không cần server, hoặc chạy trên máy cá nhân. Cài không quá khó nhưng cần có API key của một nhà cung cấp AI và một kênh nhận thông báo.
daily_stock_analysis là một hệ thống phân tích cổ phiếu chạy bằng AI, viết bằng Python, mã nguồn mở theo giấy phép MIT. Bạn khai báo danh sách mã cổ phiếu 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ảng quyết định” gồm kết luận, điểm số, xu hướng, rủi ro và yếu tố hỗ trợ. Kết quả được đẩy thẳng đến kênh chat hoặc email của bạn.
Repo này hợp với người có thói quen theo dõi một nhóm cổ phiếu nhưng không có thời gian đọc tin và xem biểu đồ mỗi ngày. Nó cũng hợp với lập trình viên mới muốn xem một dự án AI thực tế được tổ chức ra sao. Hiện repo có khoảng 71.137 sao và 57.170 fork, và vẫn được cập nhật trong 3 tháng gần đây.
Điểm đáng giá nhất: bạn có thể chạy hoàn toàn trên GitHub Actions, theo lời tác giả là “5 phút, zero cost, không cần server”. Hệ thống mặc định dùng các nguồn giá miễn phí nên có thể chạy gần như không cần cấu hình thêm. Xem video ngắn bên dưới để thấy giao diện thực tế trước khi cài.
Đây là công cụ để học và nghiên cứu. Chính tác giả ghi rõ: dự án không phải lời khuyên đầu tư, đầu tư có rủi ro và tác giả không chịu trách nhiệm cho thua lỗ. Hãy coi báo cáo AI là tài liệu tham khảo, không phải lệnh mua bán.
ZhuLinsen/daily_stock_analysis
Hệ thống Python dùng mô hình AI phân tích danh mục cổ phiếu nhiều thị trường mỗi ngày và tự gửi bảng quyết định qua Telegram, Slack, email…
I.daily_stock_analysis làm được gì
Dưới đây là các tính năng chính, kèm lợi ích thực tế.
A.Báo cáo quyết định bằng AI
Mỗi mã cổ phiếu được phân tích thành một báo cáo gồm kết luận cốt lõi, điểm số, xu hướng, vùng mua bán, cảnh báo rủi ro, yếu tố thúc đẩy và danh sách việc cần kiểm tra trước khi hành động. Bạn đọc một màn hình là nắm được tình hình, thay vì mở nhiều trang web.
B.Gộp dữ liệu nhiều thị trường
Hệ thống bao phủ 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ó nguồn dữ liệu và giới hạn riêng, README trỏ đến tài liệu “biên giới hỗ trợ thị trường” trong repo để bạn xem chi tiết.
C.Giao diện web / ứng dụng máy tính
Ngoài chạy tự động, bạn có giao diện web để 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 đủ, backtest, quản lý danh mục nắm giữ và chỉnh cấu hình. Có chế độ sáng và tối.
D.Hỏi đáp theo chiến lược (Agent)
Trang chat cho phép hỏi nhiều lượt liên tiếp. Hệ thống có 15 chiến lược dựng sẵn như đường trung bình, Chan Lun (Triền luận), sóng Elliott, xu hướng, chủ đề nóng, sự kiện, tăng trưởng, kỳ vọng. Nó có thể gọi giá, nến, chỉ báo và tin tức khi trả lời. Tính năng này dùng được trên Web, bot và API.
E.Nhập danh mục thông minh
Bạn có thể nhập danh sách cổ phiếu từ ảnh, CSV/Excel hoặc clipboard. Ô nhập cũng gợi ý theo mã, tên, pinyin và tên gọi khác. Bạn đỡ phải gõ tay từng mã.
F.Tự động hoá và đẩy thông báo
Chạy theo lịch bằng GitHub Actions, Docker, tác vụ định kỳ trên máy hoặc dịch vụ FastAPI. Báo cáo gửi được qua WeChat Work, Feishu, Telegram, Discord, Slack và email. README cũng nhắc DingTalk trong file cấu hình mẫu.
G.Chọn nhà cung cấp AI linh hoạt
Bạn có thể dùng Gemini, Claude, các dịch vụ tương thích OpenAI (như DeepSeek, Qwen), Modelflare, AIHubMix hoặc Ollama chạy mô hình cục bộ. Chỉ cần ít nhất một nhà cung cấp.
II.Cần chuẩn bị gì
Theo README, tuỳ cách chạy bạn cần những thứ sau.
- Chạy bằng GitHub Actions (khuyên dùng): một tài khoản GitHub. Không cần server.
- Chạy trên máy: cài Python và pip. README không ghi số phiên bản Python cụ thể, bạn xem thêm trong file pyproject.toml của repo. Hệ điều hành cũng không được nêu rõ trong README.
- API key của ít nhất một mô hình AI, ví dụ Gemini, Anthropic Claude, hoặc dịch vụ tương thích OpenAI. Với dịch vụ tương thích OpenAI, điền thêm địa chỉ và tên mô hình.
- Ít nhất một kênh nhận thông báo: webhook WeChat Work/Feishu/Discord, bot Telegram (token và chat ID), bot Slack, hoặc email (tài khoản gửi và mật khẩu).
- Danh sách cổ phiếu (bắt buộc), ví dụ mã A-share, Hồng Kông, Mỹ.
- Nguồn tin tức (nên có): README khuyên cấu hình ít nhất một dịch vụ tìm kiếm như SerpAPI, Tavily, Brave, Anspire, Bocha, MiniMax hoặc SearXNG tự dựng, vì nó ảnh hưởng nhiều đến chất lượng phần tin tức và sự kiện.
- Nguồn giá (tuỳ chọn): mặc định có AkShare, Baostock, YFinance miễn phí. Nếu cần ổn định hơn có thể dùng TickPlus, Tushare, Longbridge.
README không nói cần GPU. Nếu bạn muốn chạy mô hình cục bộ bằng Ollama thì cần xem thêm cấu hình máy ở phía Ollama, README không đề cập.
III.Cài đặt từng bước
- Fork repoSao chép repo về tài khoản GitHub của bạn (cách chạy khuyên dùng)
- Điền SecretsNhập API key AI, kênh thông báo, danh sách cổ phiếu
- Bật ActionsCho phép workflow chạy trong repo của bạn
- Chạy thửBấm Run workflow để nhận báo cáo đầu tiên
- Hoặc chạy trên máyClone, pip install, tạo file .env và chạy python main.py
Có hai cách. Cách một (GitHub Actions) không cần cài gì trên máy. Cách hai là chạy cục bộ.
A.Cách 1, bước 1: Fork repo
Mở trang repo trên GitHub, bấm nút Fork ở góc phải trên để sao chép về tài khoản của bạn. Mọi cấu hình sau đây làm trên bản fork của bạn, không phải repo gốc.
B.Cách 1, bước 2: Điền Secrets
Trong bản fork, vào Settings → Secrets and variables → Actions → New repository secret. Mỗi secret gồm tên và giá trị. Bạn cần tối thiểu các nhóm sau (tên đúng theo README):
- Mô hình AI (ít nhất một): MODELFLARE_KEY, AIHUBMIX_KEY, GEMINI_API_KEY, ANTHROPIC_API_KEY, hoặc OPENAI_API_KEY. Nếu dùng dịch vụ tương thích OpenAI, thêm OPENAI_BASE_URL và OPENAI_MODEL.
- Thông báo (ít nhất một): WECHAT_WEBHOOK_URL, FEISHU_WEBHOOK_URL, TELEGRAM_BOT_TOKEN cùng TELEGRAM_CHAT_ID, DISCORD_WEBHOOK_URL, 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): STOCK_LIST. README cho ví dụ giá trị như sau:
600519,hk00700,AAPL,7203.T,005930.KS,2330.TWCác mã cách nhau bằng dấu phẩy, không có khoảng trắng. Mã có hậu tố theo thị trường: .T là Nhật, .KS là Hàn, .TW là Đài Loan, hk đứng trước là Hồng Kông, mã chữ như AAPL là Mỹ.
- Tin tức (nên có): ví dụ SERPAPI_API_KEYS, TAVILY_API_KEYS, BRAVE_API_KEYS…
- Nguồn giá (tuỳ chọn): TICKPLUS_API_KEY, TUSHARE_TOKEN…
Chỗ người mới hay vấp: dán key phải đúng tên secret, không thừa dấu cách hay dấu nháy. Nếu dòng log báo “chưa cấu hình” một nguồn giá tuỳ chọn, README nói điều đó không ảnh hưởng việc chạy.
C.Cách 1, bước 3: Bật Actions
Vào tab Actions của bản fork, bấm nút có chữ “I understand my workflows, go ahead and enable them”. Mặc định GitHub tắt workflow ở repo vừa fork, nên bỏ qua bước này là sẽ không chạy gì cả.
D.Cách 1, bước 4: Chạy thử
Vào Actions, chọn workflow tên “每日股票分析” (phân tích cổ phiếu hằng ngày), bấm Run workflow. Sau khi chạy xong, kênh thông báo của bạn sẽ nhận báo cáo. Từ đó, README nói hệ thống tự chạy vào mỗi ngày làm việc lúc 18:00 giờ Bắc Kinh, và mặc định không chạy vào ngày nghỉ của thị trường A/H/US.
E.Cách 2: Chạy trên máy của bạn
Mở terminal (PowerShell hoặc Terminal), đi tới thư mục bạn muốn lưu dự án rồi chạy các lệnh sau. Đây là đúng lệnh trong README:
# Clone dự án
git clone https://github.com/ZhuLinsen/daily_stock_analysis.git && cd daily_stock_analysis
# Cài thư viện
pip install -r requirements.txt
# Tạo file cấu hình
cp .env.example .env && vim .env
# Chạy phân tích
python main.pyGiải thích từng dòng:
- Dòng git clone tải mã nguồn về và vào luôn thư mục dự án. Cần cài Git trước.
- Dòng pip install cài các thư viện Python trong requirements.txt.
- Dòng cp tạo file .env từ file mẫu rồi mở bằng vim. Nếu bạn dùng Windows và không quen vim, tự tạo bản sao file .env.example thành .env rồi mở bằng Notepad để sửa. Trong file này bạn điền các biến giống danh sách secret ở trên, ví dụ STOCK_LIST, GEMINI_API_KEY, TUSHARE_TOKEN. File mẫu còn có nhiều biến khác (nhóm tìm kiếm, DingTalk, chọn backend sinh nội dung) để bạn xem thêm.
- Dòng python main.py chạy phân tích một lượt.
Nếu bạn muốn chạy bằng Docker, README chưa ghi lệnh cụ thể ở phần này mà trỏ sang hướng dẫn đầy đủ trong thư mục docs của repo, kèm thư mục docker.
File .env chứa API key. Đừng đưa nó lên GitHub hoặc gửi cho người khác. Với GitHub Actions, hãy điền key vào Secrets, không dán vào file trong repo.
IV.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 báo thành công (dấu xanh), rồi kiểm tra kênh thông báo đã nhận tin chưa. Nếu bạn thấy tin gửi tới, bạn đã cài xong.
Với chạy cục bộ, hãy thử chế độ chạy thử trước:
python main.py --dry-runRồi chạy thật cho vài mã cụ thể:
python main.py --stocks 600519,hk00700,AAPL,2330.TWKết quả mong đợi theo README là một bản “bảng quyết định” như sau: tiêu đề kèm số mã đã phân tích, phần tóm tắt từng mã (quan sát/mua/bán, điểm số, xu hướng), rồi tới mục tin quan trọng, cảnh báo rủi ro, yếu tố thúc đẩy và diễn biến mới nhất. README có ví dụ trực tiếp. Hệ thống cũng có bản “tổng kết thị trường” với các chỉ số chính, số mã tăng giảm và nhóm ngành mạnh yếu.
Nếu cần xem chi tiết khi lỗi, thêm cờ gỡ lỗi:
python main.py --debugV.Dùng vào việc thật
A.Nhà đầu tư cá nhân muốn bản tin mỗi chiều
Bạn có vài mã quan tâm và không muốn mở nhiều ứng dụng mỗi ngày. Cách làm: dùng GitHub Actions, điền STOCK_LIST và kênh nhận tin như Telegram. Hệ thống tự chạy mỗi ngày làm việc và gửi bản quyết định cho từng mã. Bạn nhận về tóm tắt kèm điểm số, cảnh báo rủi ro và yếu tố thúc đẩy ngay trên điện thoại.
B.Người làm việc theo nhóm, cần gửi báo cáo vào kênh chung
Giả sử bạn trong nhóm tư vấn hoặc nhóm đầu tư nhỏ và cả nhóm dùng Slack hoặc Discord. Điền DISCORD_WEBHOOK_URL hoặc SLACK_BOT_TOKEN cùng SLACK_CHANNEL_ID. Mỗi ngày kênh nhận một bản tin chung. Mọi người cùng đọc một nguồn, không phải mỗi người tự tra.
C.Muốn xem nhanh một danh sách mã bất kỳ
Bạn đang cân nhắc vài mã và muốn xem AI đánh giá thế nào. Chạy một lần:
python main.py --stocks 600519,hk00700,AAPL,2330.TWKết quả là báo cáo cho đúng các mã đó, không cần sửa file cấu hình. Muốn xem thêm bối cảnh chung của thị trường, thêm:
python main.py --market-reviewHệ thống không chỉ cho bạn một con số mà cho cả lý do: rủi ro nào, yếu tố nào đẩy giá, và việc cần kiểm tra trước khi hành động.
Ông T
D.Lập trình viên muốn một giao diện để hỏi đáp và quản lý
Bạn muốn xem lịch sử báo cáo và hỏi tiếp bằng ngôn ngữ tự nhiên. Chạy giao diện web:
python main.py --webuiHoặc chỉ chạy giao diện mà không chạy phân tích định kỳ:
python main.py --webui-onlyMở trình duyệt vào http://127.0.0.1:8000. README nói khi đã có API key AI hợp lệ, trang chat ở đường dẫn /chat dùng được để hỏi theo chiến lược, hỏi nhiều lượt liên tiếp. Ngoài ra còn có các lệnh python main.py --schedule (chạy theo lịch) và python main.py --serve-only (chỉ chạy dịch vụ API), bạn xem thêm trong hướng dẫn đầy đủ.
VI.Lỗi hay gặp và cách xử lý
A.Chạy xong nhưng không thấy tin nhắn
Thường do chưa điền đúng secret của kênh thông báo, hoặc tên secret gõ sai. Hãy kiểm tra lại tên secret (ví dụ TELEGRAM_BOT_TOKEN và TELEGRAM_CHAT_ID phải có cả hai). Với Telegram và Slack, hai giá trị đi cùng nhau. Xem log của lượt chạy trong tab Actions để biết thông báo lỗi cụ thể.
B.Workflow không chạy tự động
Bản fork mặc định bị tắt workflow. Hãy làm lại bước bật Actions. Cũng cần biết hệ thống mặc định không chạy vào ngày nghỉ của thị trường A/H/US, nên nếu hôm nay là ngày nghỉ thì không có tin là bình thường. README nhắc có cách ép chạy, bạn xem trong hướng dẫn đầy đủ.
C.Dữ liệu giá bị thiếu hoặc chập chờn
Nguồn giá miễn phí mặc định (AkShare, Baostock, YFinance) phụ thuộc giới hạn của bên cung cấp, thay đổi giao diện và mạng. README thừa nhận độ ổn định không được đảm bảo. Nếu chạy định kỳ hoặc phân tích hàng loạt, hãy cân nhắc thêm nguồn có token như Tushare hoặc Longbridge.
D.Báo cáo thiếu tin tức hoặc sự kiện
Nếu chưa cấu hình dịch vụ tìm kiếm tin, phần dư luận, công bố và yếu tố thúc đẩy sẽ nghèo hơn. Hãy thêm ít nhất một khoá tìm kiếm, ví dụ SERPAPI_API_KEYS hoặc TAVILY_API_KEYS.
E.Lệnh pip hoặc python báo lỗi trên máy
Thường do chưa cài Python hoặc dùng terminal sai thư mục. Hãy chắc rằng bạn đã vào thư mục daily_stock_analysis (có file requirements.txt) trước khi chạy pip install. README không ghi phiên bản Python tối thiểu, nên nếu báo lỗi phiên bản hãy xem pyproject.toml. Nếu gặp lỗi vim không tìm thấy trên Windows, dùng Notepad để sửa file .env như đã nói.
VII.Có nên dùng không
Điểm mạnh: chạy được miễn phí trên GitHub Actions, không cần server. Hỗ trợ nhiều thị trường và nhiều nhà cung cấp AI, kể cả mô hình cục bộ. Có nhiều kênh nhận tin, có giao diện web, có chat theo chiến lược. Giấy phép MIT, dự án đang được cập nhật.
Giới hạn: README và giao diện chủ yếu bằng tiếng Trung (có bản tiếng Anh và tiếng Trung phồn thể), báo cáo mẫu cũng bằng tiếng Trung, nên bạn cần kiên nhẫn đọc hướng dẫn. Nguồn giá miễn phí không ổn định tuyệt đối. Phần lớn nguồn giá và tin trong README nghiêng về thị trường Trung Quốc và quốc tế. README không nhắc hỗ trợ cổ phiếu Việt Nam, vì vậy chưa có thông tin về điều này. Chất lượng báo cáo phụ thuộc mô hình AI và nguồn tin bạn chọn, và AI vẫn có thể sai.
Khi nên chọn cách khác: nếu bạn cần dữ liệu cổ phiếu Việt Nam, hoặc cần lời khuyên đầu tư có trách nhiệm pháp lý, hãy dùng nguồn dữ liệu và tư vấn phù hợp với thị trường đó. Nếu bạn chỉ cần xem giá thì một ứng dụng chứng khoán thông thường là đủ. Còn nếu bạn thích tự động hoá, muốn có bản tóm tắt gọn mỗi ngày và sẵn sàng bỏ chút công cấu hình, repo này là một lựa chọn đáng thử, miễn là bạn coi nó như công cụ hỗ trợ chứ không phải người ra quyết định.
Câu hỏi thường gặp
daily_stock_analysis có miễn phí không?
Bản thân repo là mã nguồn mở theo giấy phép MIT, và README nói có thể chạy zero cost trên GitHub Actions. Tuy nhiên bạn vẫn cần API key của một nhà cung cấp AI, và nhà cung cấp đó có thể tính phí theo cách riêng. README không nêu mức phí cụ thể.
Có cần GPU hay server không?
Không cần server nếu chạy bằng GitHub Actions, README gọi đây là cách khuyên dùng. README không nhắc yêu cầu GPU. Ollama (mô hình cục bộ) được nhắc là hợp với chạy trên máy hoặc Docker, nhưng yêu cầu phần cứng cho Ollama chưa có trong tư liệu.
Chạy trên Windows được không?
README không nêu rõ hệ điều hành hỗ trợ. Lệnh cài đặt là các lệnh Python và Git thông dụng, nên về nguyên tắc chạy được khi đã cài Python. Riêng lệnh sửa file .env bằng vim trong README thì trên Windows bạn nên thay bằng Notepad. Cách chắc chắn nhất là dùng GitHub Actions.
Dữ liệu và API key của tôi có an toàn không?
Với GitHub Actions, key được lưu trong Secrets của repo bạn. Với chạy cục bộ, key nằm trong file .env trên máy bạn. Dù theo cách nào, bạn nên giữ riêng tư các key này. Tư liệu chưa có thông tin chi tiết về cách dữ liệu được xử lý ở phía nhà cung cấp AI.
Có hỗ trợ cổ phiếu Việt Nam không?
README nêu hỗ trợ A-share, Hồng Kông, Mỹ, Nhật, Hàn, Đài Loan và ETF. README không nhắc cổ phiếu Việt Nam, vì vậy chưa có thông tin về việc hỗ trợ thị trường này.
Kết quả phân tích có thể tin để mua bán không?
Không nên coi đó là căn cứ duy nhất. 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 cho thua lỗ. Hãy tự kiểm chứng trước khi quyết định.
Hệ thống có thể gửi báo cáo tới những đâu?
README liệt kê WeChat Work, Feishu, Telegram, Discord, Slack và email. File cấu hình mẫu còn có biến cho DingTalk. Bạn chỉ cần cấu hình ít nhất một kênh.


