Trung tâm hướng dẫn
Cài vnstock thế hệ 6 cùng trợ lý AI
Sao chép lời nhắc, gửi cho trợ lý AI và xem kế hoạch cài đặt. Sau khi bạn duyệt, trợ lý sẽ tự chạy các bước có thể thực hiện hoặc đưa lệnh để bạn chạy.
01 · Cài đặt
Cài bằng một lời nhắc
Bạn không cần nhớ từng dòng lệnh. Trợ lý AI lập kế hoạch, chờ bạn duyệt rồi cài thư viện. Khi cần kết nối nguồn dữ liệu, bạn tự nhập khoá trong cửa sổ dòng lệnh.
Thế hệ 6 là bản đang phát hành. Bạn cần tự đăng ký khoá với nguồn dữ liệu mình chọn. Dự án viết cho thế hệ 5, vnstock 4.x hay vnstock_data 3.x: xem Chuyển dự án sang thế hệ 6.
Lời nhắc và lệnh bên dưới đổi theo máy bạn chọn.
1
Mở trợ lý AI bạn đang dùng
Ứng dụng trên máy tính, bản web hay trợ lý dòng lệnh đều được.
Ứng dụng trò chuyện
Claude, ChatGPT, Antigravity
Chạy lệnh trên máy
Claude Code, Codex, VS Code, Antigravity IDE
2
Dán lời nhắc vào trợ lý
Lời nhắc không chứa khoá. Trợ lý trình bày toàn bộ kế hoạch, chờ bạn duyệt rồi mới bắt đầu cài.
Lời nhắc · macOSHãy giúp tôi thiết lập thư viện Python vnstock thế hệ 6 (bản Cộng đồng), theo mục "Setup (generation 6)" của tài liệu hướng dẫn tại https://vnstocks.com/files/vibe-onboarding.md - Đọc trực tiếp toàn bộ tệp đó trước khi lập kế hoạch (ví dụ curl -fsSL https://vnstocks.com/files/vibe-onboarding.md), không thay bằng tìm kiếm web, skill hay ghi nhớ cũ. Không đọc được thì báo tôi, đừng tự đoán lệnh. - Trước tiên xác định bạn đang chạy ở đâu, theo mục G1 của tài liệu. Tôi mở trang hướng dẫn trên macOS, nhưng nơi cài là nơi bạn đang chạy. - Nếu là máy cá nhân hoặc máy chủ: cài vào môi trường cố định ~/.venv bằng nguyên văn hai lệnh sau (lệnh đầu bỏ qua nếu môi trường đã có; hai lệnh này viết cho macOS). Nếu môi trường đó đang có vnstock thế hệ 5 hoặc 4.x, nêu trong kế hoạch rồi nâng thẳng lên thế hệ 6 theo mục G2, vì các bản cũ đã ngừng xác thực: python3 -m venv ~/.venv ~/.venv/bin/python -m pip install -U --extra-index-url https://vnstocks.com/api/packages "vnstock==6.0.1" "vnstock-oapi==0.1.2" - Nếu là Google Colab, GitHub Codespaces hoặc Kaggle: không tạo môi trường ảo, cài thẳng vào Python của phiên đó bằng nguyên văn lệnh sau: python3 -m pip install -U --extra-index-url https://vnstocks.com/api/packages "vnstock==6.0.1" "vnstock-oapi==0.1.2" - Không viết lại các lệnh trên, không bỏ --extra-index-url và số phiên bản. - Trước khi chạy bất kỳ lệnh nào, hãy trình bày kế hoạch đầy đủ: các bước theo thứ tự, lệnh sẽ chạy ở từng bước, nơi cài, những tệp sẽ tạo hoặc sửa. Chờ tôi duyệt kế hoạch một lần. - Sau khi tôi duyệt, hãy thực hiện trọn kế hoạch mà không hỏi lại từng lệnh, rồi báo kết quả ngắn gọn. Chỉ dừng lại hỏi khi gặp việc ngoài kế hoạch, lỗi cần đổi cách làm, hoặc lệnh có thể làm mất dữ liệu của tôi. - Không hỏi hay yêu cầu tôi cung cấp khoá truy cập (API key) qua khung chat. - Khoá Open API của nguồn dữ liệu do tôi tự quản lý: hãy hỏi tôi dùng nguồn nào và không tự chọn nguồn. Tôi tự cất khoá theo mục G5 (máy có kho khoá: vnstock keys set; Colab, Codespaces, Kaggle: biến môi trường hoặc tệp .env). Không mở và không in các khoá đó. - Đưa vào kế hoạch việc ghi vào AGENTS.md của dự án đúng khối hướng dẫn ở mục G9 của tài liệu, kèm nội dung dự kiến để tôi xem khi duyệt.
3
Nhập khoá của nguồn dữ liệu
Khi trợ lý yêu cầu, chạy lệnh này trong cửa sổ dòng lệnh rồi tự nhập khoá. Ký tự được ẩn khi bạn gõ và không xuất hiện trong khung chat.
Terminal · macOS$ ~/.venv/bin/vnstock keys set <nguồn>Mở terminal để dán lệnh
Trong ứng dụng Claude trên máy tính, bấm nút có dấu >_ ở góc trên bên phải để mở bảng Terminal. Bạn tự đăng ký tài khoản và khoá ở nguồn, theo điều khoản của nguồn đó. Chưa có khoá thì trợ lý vẫn cài xong và dừng trước bước lấy dữ liệu. Xem danh sách nguồn và nơi đăng ký.
Trợ lý sẽ làm
4 bước · duyệt kế hoạch một lần
- 01
Cài vào môi trường ~/.venv
kiểm tra Python 3.10 trở lên, tạo hoặc nâng ~/.venv
- 02
Hỏi nguồn bạn dùng
trợ lý không tự chọn nguồn; bạn tự nhập khoá ở bước 3
- 03
Ghi chỉ dẫn cho trợ lý AI
vào AGENTS.md (khuyên dùng, bạn bỏ chọn được)
- 04
Kiểm tra và chạy thử
vnstock doctor, rồi một truy vấn nhỏ ở nguồn của bạn
Đích đến: Thế hệ 6 chạy được trên máy, lấy được dữ liệu từ nguồn của bạn
Sau khi cài xong, bạn có thể dùng các kỹ năng viết sẵn để sàng lọc cổ phiếu, theo dõi danh mục hoặc phân tích báo cáo tài chính.
02 · Hướng dẫn
Chọn hướng dẫn phù hợp
Bắt đầu bằng cách mô tả yêu cầu cho trợ lý AI, sau đó học thêm về kỹ năng và quy trình khi cần.
Từ cơ bản đến nâng cao
Bắt đầu thực hành
Khi cần thêm
03 · Cách hoạt động
Dữ liệu đi thẳng từ nguồn về máy bạn
Khoá Open API do nguồn bạn chọn (công ty chứng khoán, FMP…) cấp cho chính bạn và nằm trong kho bảo mật của máy. vnstock-oapi dùng khoá đó để gọi nguồn; vnstock 6 đưa phản hồi về một bảng chung tên cột, kiểu và đơn vị.

04 · Hỏi đáp
Câu hỏi thường gặp
Những thắc mắc phổ biến nhất của người mới khi làm quen với Vnstock.
