Cài đặt vnstock-js cho Node, serverless, trình duyệt, CLI và MCP.
npm install vnstock-js
Cần Node 18 trở lên (dùng fetch có sẵn). Không cần khóa API và không cần gọi hàm khởi tạo: danh mục mã và lịch nghỉ được tải ở lần dùng đầu.
| Import | Dùng cho |
|---|---|
vnstock-js | Client vn, createClient(), kiểu dữ liệu, lỗi |
vnstock-js/indicators | Chỉ báo và pattern, hàm thuần trên Bar[], không gọi mạng |
vnstock-js/proxy | Proxy cho trình duyệt: nextHandler(), workerHandler(), expressHandler() |
vnstock-js/node | fileStorage() lưu cache ở ~/.vnstock-js giữa các lần chạy |
Package xuất cả CommonJS (require) và ESM (import).
Mặc định dữ liệu nền (danh mục mã, lịch nghỉ, tỷ số quý) chỉ cache trong bộ nhớ. Script chạy nhiều lần nên dùng fileStorage():
import { createClient } from "vnstock-js";
import { fileStorage } from "vnstock-js/node";
const vn = createClient({ storage: fileStorage(), preload: true });
VietCap chặn request từ trình duyệt, nên cần gắn proxy có sẵn vào server của bạn rồi tạo client với proxy. Xem Trình duyệt & proxy.
watch() ở chế độ stream cần WebSocket: Node 22 trở lên và trình duyệt có sẵn; Node 18 đến 21 cài thêm ws:
npm install ws
Hoặc dùng { mode: 'poll' } để hỏi bảng giá định kỳ, không cần WebSocket.
npx vnstock-js FPT
# hoặc cài global
npm install -g vnstock-js
vnstock history FPT --range 3mo
Xem CLI.
claude mcp add --scope user vnstock npx -y vnstock-js mcp
Xem MCP Server.