Danh mục Công cụ
Cộng đồngBản Cộng đồngvnstock_mcp v0.4.0Cập nhật
Mục lục
Cơ chế tự động gọi công cụ
Bạn không cần phải nhớ chính xác tên công cụ hay cú pháp lệnh. Trò chuyện bằng tiếng Việt tự nhiên với Trợ lý AI, hệ thống sẽ tự động chọn công cụ thích hợp nhất trong 26 công cụ được cấp phép.
Tổng quan
Dưới đây là danh mục 26 công cụ cơ sở mà bạn sở hữu trong vnstock-mcp bản Cộng đồng (dành cho cá nhân, học tập và nghiên cứu), được phân chia theo 6 nhóm chức năng.
1. Tầng Reference (Thông tin Tham chiếu & Danh mục)
| Tên công cụ | Loại | Mô tả chức năng | Prompt mẫu cho Trợ lý AI |
|---|---|---|---|
reference_equity | Đọc | Tra cứu danh sách mã cổ phiếu theo sàn (HOSE, HNX, UPCOM), theo rổ chỉ số (VN30, VN100) hoặc ngành ICB. | "Liệt kê danh sách các mã cổ phiếu thuộc rổ VN30." |
reference_index | Đọc | Tra cứu danh sách các chỉ số thị trường, rổ cổ phiếu và mã thành phần của rổ. | "Xem danh sách các chỉ số ngành của sàn HOSE." |
reference_industry | Đọc | Cây phân loại ngành chuẩn ICB và ánh xạ mã ngành theo từng mã cổ phiếu. | "Mã FPT và CMG thuộc phân ngành ICB cấp mấy?" |
reference_holiday | Đọc | Lịch nghỉ lễ và các ngày đóng cửa giao dịch của thị trường chứng khoán Việt Nam. | "Năm nay thị trường chứng khoán nghỉ lễ vào những ngày nào?" |
reference_company | Đọc | Hồ sơ doanh nghiệp niêm yết: ban lãnh đạo, cổ đông lớn, công ty con, lịch sử tăng vốn. | "Cho tôi xem danh sách ban lãnh đạo và các công ty con của VCB." |
reference_instrument | Đọc | Tra cứu thông tin chứng chỉ quỹ (ETF), chứng quyền có bảo đảm (CW), phái sinh. | "Tìm các mã chứng quyền đang lưu hành của cổ phiếu HPG." |
reference_search | Đọc | Tìm kiếm thông minh mã cổ phiếu theo tên công ty hoặc từ khóa liên quan. | "Tìm mã chứng khoán của công ty sữa Vinamilk." |
2. Tầng Market (Dữ liệu Giao dịch & Bảng giá)
| Tên công cụ | Loại | Mô tả chức năng | Prompt mẫu cho Trợ lý AI |
|---|---|---|---|
market_trading_hours | Đọc | Kiểm tra giờ giao dịch, phiên hiện tại (ATO, Khớp lệnh liên tục, ATC) của các sàn. | "Hiện tại sàn HOSE đang ở phiên giao dịch nào?" |
market_board | Đọc | Bảng giá trực tuyến tổng hợp: giá khớp, biến động, khối lượng của nhiều mã cổ phiếu trong phiên. | "Cho tôi xem bảng giá trực tuyến của 3 mã VCB, BID, CTG." |
market_lookback | Đọc | Tính toán khoảng nhìn lại (lookback: 3M, 1Y, 100 nến) ra ngày bắt đầu YYYY-MM-DD chuẩn xác. | "Khoảng nhìn lại 6 tháng gần nhất từ hôm nay là từ ngày nào?" |
market_equity | Đọc | Dữ liệu giao dịch cổ phiếu: nến OHLCV theo phiên, thống kê khớp lệnh cơ bản. | "Lấy dữ liệu giá nến của FPT trong 1 tháng gần nhất." |
market_derivative | Đọc | Dữ liệu giao dịch hợp đồng tương lai phái sinh chỉ số VN30. | "Xem giá khớp và khối lượng của hợp đồng VN30F1M." |
3. Tầng Fundamental (Báo cáo Tài chính & Chỉ số)
| Tên công cụ | Loại | Mô tả chức năng | Prompt mẫu cho Trợ lý AI |
|---|---|---|---|
fundamental_financial | Đọc | Báo cáo tài chính theo quý/năm: Bảng cân đối kế toán, Kết quả kinh doanh và Lưu chuyển tiền tệ. | "Lấy Báo cáo Kết quả Kinh doanh 4 quý gần nhất của HPG." |
fundamental_ratio | Đọc | Các chỉ số tài chính cơ bản: P/E, P/B, EPS, ROE, ROA, biên lợi nhuận ròng, tỷ lệ nợ/VCSH. | "So sánh chỉ số P/E và ROE của FPT và MWG." |
fundamental_dividend | Đọc | Lịch sử trả cổ tức bằng tiền mặt và cổ phiếu của doanh nghiệp qua các năm. | "Xem lịch sử trả cổ tức của VNM trong 3 năm qua." |
4. Tầng Macro & Sentiment (Vĩ mô & Tâm lý Thị trường)
| Tên công cụ | Loại | Mô tả chức năng | Prompt mẫu cho Trợ lý AI |
|---|---|---|---|
macro_indicator | Đọc | Các chỉ số kinh tế vĩ mô cơ bản: GDP, CPI, chỉ số sản xuất công nghiệp IIP, cán cân thương mại. | "Cho tôi xem chỉ số CPI Việt Nam các tháng gần nhất." |
sentiment_market | Đọc | Chỉ báo độ rộng thị trường: số mã tăng/giảm/tham chiếu, tỷ lệ phân bổ dòng tiền toàn thị trường. | "Độ rộng thị trường hôm nay nghiêng về bên mua hay bên bán?" |
sentiment_accounts | Đọc | Thống kê số lượng tài khoản chứng khoán mở mới của nhà đầu tư cá nhân và tổ chức theo tháng. | "Số lượng tài khoản chứng khoán mở mới tháng trước là bao nhiêu?" |
5. Tầng Research (Harness Cục bộ & Tái lập Nghiên cứu)
| Tên công cụ | Loại | Mô tả chức năng | Prompt mẫu cho Trợ lý AI |
|---|---|---|---|
research_ledger | Ghi/Đọc | Quản lý bảng dữ liệu trung gian trong bộ nhớ phiên làm việc, gán tên bảng để tái sử dụng. | "Lưu bảng BCTC vừa tải vào ledger với tên bctc_hpg." |
research_io | Xuất/Nạp | Xuất bảng dữ liệu ra file CSV/JSON trên máy hoặc nạp dữ liệu từ file ngoài vào phiên nghiên cứu. | "Xuất bảng dữ liệu giá FPT ra file CSV trên Desktop của tôi." |
research_diff | Đối chiếu | So sánh độ lệch giữa 2 bảng dữ liệu từ 2 nguồn khác nhau (Vnstock và nguồn khác bạn có quyền dùng, ví dụ tệp Excel). | "So sánh giá đóng cửa trong ledger với bảng giá file excel của tôi." |
research_journal | Tái lập | Xuất toàn bộ nhật ký các bước phân tích trong phiên thành script Python độc lập để chạy định kỳ. | "Hãy xuất toàn bộ quy trình phân tích hôm nay thành file script Python để tôi chạy tự động." |
6. Tầng Quant (Tính toán Định lượng - Dùng thử 30 lượt / ngày)
Lượt dùng thử
Người dùng bản Cộng đồng có 30 lượt dùng thử / ngày cho các công cụ tính toán bên dưới (tự động làm mới vào 00:00:00 hàng ngày). Để dùng quant không bị đếm lượt dùng thử và mở khóa toàn bộ 58+ chỉ báo TA nâng cao, vui lòng xem Gói Tài trợ Bronze.
| Tên công cụ | Loại | Mô tả chức năng | Prompt mẫu cho Trợ lý AI |
|---|---|---|---|
quant_catalog | Tra cứu | Tra cứu danh mục phương pháp luận, công thức toán học và danh sách chỉ báo được hỗ trợ. | "Thư viện hỗ trợ những chỉ báo kỹ thuật cơ bản nào?" |
quant_ta_basic | Tính toán | Tính toán các chỉ báo kỹ thuật cốt lõi: SMA, EMA, RSI, MACD, Bollinger Bands, ATR, Stochastic, OBV. | "Tính chỉ báo RSI(14) và MACD(12,26,9) cho cổ phiếu SSI." |
quant_fa_basic | Tính toán | Tính các tỷ số tài chính cốt lõi trực tiếp trên bảng Báo cáo tài chính. | "Tính biên lợi nhuận gộp và tỷ lệ đòn bẩy tài chính của MSN." |
quant_compute | Tính toán | Chạy tính toán các chỉ báo cơ bản trên dữ liệu bảng ngoài do người dùng tự nạp vào. | "Tính đường SMA 20 trên cột close của bảng dữ liệu tôi vừa nạp." |
Các công cụ cao cấp (Chỉ có ở Bản Mở rộng)
Nếu bạn cần các công cụ bên dưới, hãy tham khảo Bản Mở rộng dành cho Nhà tài trợ:
market_orderbook/market_intraday: Sổ lệnh độ sâu và lịch sử khớp lệnh từng tick (Yêu cầu Bronze).market_flow: Phân tích dòng tiền tự doanh và khối ngoại chi tiết từng phiên (Yêu cầu Bronze).quant_risk: Đo lường rủi ro danh mục chuyên sâu: VaR, CVaR, Beta, Max Drawdown (Yêu cầu Bronze).quant_ta_advanced: Mở khóa đầy đủ 58+ chỉ báo kỹ thuật nâng cao: Ichimoku, SuperTrend, VWAP, CMF, Keltner, Parabolic SAR... (Yêu cầu Silver).quant_portfolio: Tối ưu hóa danh mục hiện đại: Markowitz Efficient Frontier, Risk Parity, Black-Litterman (Yêu cầu Golden / Diamond).pipeline_export: Tự động hóa xuất dữ liệu cho AmiBroker và Excel (Yêu cầu Golden / Diamond).