Vnstock Logo

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.

Máy của bạn

Lời nhắc và lệnh bên dưới đổi theo máy bạn chọn.

  1. 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. 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 · macOS
    Hã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. 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

  1. 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

  2. 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

  3. 03

    Ghi chỉ dẫn cho trợ lý AI

    vào AGENTS.md (khuyên dùng, bạn bỏ chọn được)

  4. 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.

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ị.

Thế hệ 6 khác gì
Sơ đồ: trên máy của bạn, mã gọi vnstock 6 để chuẩn hoá, vnstock-oapi giữ khoá trong kho bảo mật và gửi yêu cầu tới Open API chính thức của nguồn bạn chọn (công ty chứng khoán, FMP, Binance…), dữ liệu trả về thành DataFrame.

Đã có gói quyền sử dụng?Mở rộng

Hướng dẫn riêng để lưu khoá và cài bộ thư viện mở rộng theo gói của bạn.

Sang hướng dẫn bản Mở rộng

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.

Tôi không biết lập trình, có dùng Vnstock được không?
Có. Bạn có thể nhờ trợ lý AI cài thư viện và viết đoạn mã đầu tiên từ yêu cầu bằng tiếng Việt. Bạn vẫn nên xem lại mã, nguồn dữ liệu và kết quả trước khi dùng cho công việc nghiên cứu.
Làm thế nào để bắt đầu với Vnstock?
Nếu muốn dùng ngay mà chưa cài Python, mở trang "Trải nghiệm Vnstock" và chạy ví dụ trên Google Colab. Nếu muốn làm việc trên máy của mình, dùng lời nhắc cài đặt ở đầu trang này.
Tôi cần chuẩn bị gì để lấy dữ liệu ở thế hệ 6?
Bạn chọn nguồn dữ liệu và tự đăng ký khoá Open API theo điều khoản của nguồn đó. Chưa có khoá, trợ lý AI vẫn cài được thư viện nhưng chưa thể chạy bước lấy dữ liệu. Tài liệu cài đặt thế hệ 6 có danh sách nguồn và nơi đăng ký.
Quyền sử dụng Vnstock và dữ liệu đầu vào khác nhau thế nào?
Gói quyền sử dụng cấp quyền dùng phần mềm Vnstock trong phạm vi của gói. Quyền truy cập và sử dụng dữ liệu do từng nguồn quy định. Khi dùng vnstock để kết nối nguồn bên thứ ba, phần mềm chạy trên máy bạn và chuẩn hoá phản hồi thành bảng.
Dữ liệu lấy qua Vnstock có những hạn chế nào?
Kết quả phản ánh nội dung nguồn trả về tại thời điểm truy vấn và cập nhật theo độ trễ của nguồn. Các nguồn có thể cho kết quả khác nhau vì cách tính hoặc thời điểm cập nhật khác nhau. Hãy đối chiếu lại trước khi dùng cho một quyết định tài chính quan trọng.
Tôi cần hỗ trợ kỹ thuật, phải làm sao?
Bạn có thể đăng câu hỏi trong nhóm cộng đồng Vnstock trên Facebook. Hãy kèm hệ điều hành, phiên bản thư viện, mã lỗi và lệnh đã chạy; không đăng khoá truy cập. Vấn đề kỹ thuật của người dùng gói quyền sử dụng được ưu tiên xử lý.