Cài đặt và xác thực

Thư viện vnstock_news thế hệ 5 được phát hành chính thức trên kho gói của vnstocks.com. Để cài đặt chính xác phiên bản này thay vì các bản cũ trên PyPI, bạn cần thêm tham số --extra-index-url vào lệnh pip.

Yêu cầu môi trường

Cài đặt thư viện

Cài vào cùng môi trường cố định với vnstock: ~/.venv trên macOS và Linux, $HOME\.venv trên Windows; trên Google Colab hay GitHub Codespaces thì cài thẳng, không tạo môi trường. Cách tạo môi trường và trường hợp máy còn bản 4.x ở trang Cài đặt vnstock.

~/.venv/bin/python -m pip install -U --extra-index-url https://vnstocks.com/api/packages vnstock-news

& "$HOME\.venv\Scripts\python.exe" -m pip install -U --extra-index-url https://vnstocks.com/api/packages vnstock-news

Nếu bạn đang sử dụng bộ công cụ dòng lệnh vnstock, bạn có thể cài đặt trực tiếp bằng lệnh:

~/.venv/bin/vnstock install vnstock-news      # Windows: & "$HOME\.venv\Scripts\vnstock.exe" install vnstock-news

Kiểm tra thư viện đã sẵn sàng trên máy tính của bạn:

~/.venv/bin/python -c "import vnstock_news; print(vnstock_news.__version__)"

Đăng nhập và xác thực quyền sử dụng

Bạn có thể xác thực tài khoản theo một trong hai cách thuận tiện sau:

Cách 1: Đăng nhập một lần trên máy tính cá nhân

Chạy lệnh đăng nhập trong cửa sổ dòng lệnh Terminal:

vnstock register

Nhập khoá API lấy từ trang tài khoản. Sau khi đăng nhập thành công, khoá sẽ được lưu an toàn trên máy và bạn không cần phải nhập lại trong các lần chạy sau.

Cách 2: Thiết lập biến môi trường

Nếu bạn sử dụng thư viện trong các kịch bản chạy theo lịch hoặc môi trường kiểm thử, hãy thiết lập biến môi trường:

export VNSTOCK_API_KEY="khoa_api_cua_ban"

Kiểm tra trạng thái hoạt động

Hàm status() giúp bạn nhanh chóng kiểm tra xem thư viện đã sẵn sàng tiếp nhận lệnh hay chưa, và đang hỗ trợ bao nhiêu trang tin:

import vnstock_news

info = vnstock_news.status()
print("Trạng thái sẵn sàng:", info["ready"])
print("Số trang tin hỗ trợ:", info["site_count"])

{
    'version': '3.1.1',
    'ready': True,
    'catalog_version': '2026-10-06',
    'site_count': 18,
    'build_date': '2026-10-09',
    'expires_at': None,
    'expires_on': None,
    'days_left': None,
    'expired': False,
    'upgrade_action': 'pip install -U --extra-index-url https://vnstocks.com/api/packages vnstock-news',
    'entitlement_test_build': False
}

Vì sao bản cài đặt có hạn sử dụng

Các website tin tức thường định kỳ cập nhật cấu trúc trang web và kênh cấp tin. Nếu sử dụng phiên bản phần mềm quá cũ, việc lấy tin có thể bị gián đoạn do không kịp thích ứng với định dạng mới của các trang tin.

Vì vậy mỗi bản phát hành có thời hạn hoạt động 365 ngày kể từ ngày phát hành, để bản trên máy bạn không quá cũ so với định dạng của trang tin. Ngày hết hạn xem ở vnstock_news.status()["expires_on"].

Khi còn dưới 30 ngày, thư viện sẽ hiển thị một dòng cảnh báo nhẹ FutureWarning kèm hướng dẫn nâng cấp. Bạn chỉ cần chạy lại lệnh nâng cấp để tiếp tục sử dụng:

pip install -U --extra-index-url https://vnstocks.com/api/packages vnstock-news

Gỡ cài đặt

Khi không còn nhu cầu sử dụng, bạn có thể gỡ bỏ thư viện dễ dàng:

pip uninstall vnstock-news