---
description: Quy tắc điều phối EcoData MCP Server (37 công cụ, 105 mô hình kinh tế lượng, chuỗi 34/63 tỉnh thành Việt Nam, 7 phân hệ Finco & Thị trường Hàng hóa) cho Cursor và Windsurf IDE
globs: **/*
alwaysApply: true
---

# Quy chuẩn khai thác EcoData MCP trên Cursor và Windsurf IDE

1. **Truy vấn dữ liệu vĩ mô & tỉnh thành 1 bước**:
   - Luôn ưu tiên gọi `query_macro_data_unified` cho dữ liệu kinh tế Việt Nam, GSO, Hải quan và Niên giám tỉnh thành.
   - Đặt `boundary_mode="34"` khi phân tích chuỗi dữ liệu lịch sử 34 tỉnh thành giai đoạn 2000–2026 theo Nghị quyết 202/2025/QH15, hoặc `boundary_mode="63"` cho hệ 63 tỉnh trước sáp nhập.
   - EcoData tự động chuẩn hóa 3 mốc địa giới lịch sử: 1995–2003 theo Nghị quyết 22/2003/QH11 tách Lai Châu/Điện Biên, Đắk Lắk/Đắk Nông, Cần Thơ/Hậu Giang; 2003–2008 theo Nghị quyết 15/2008/QH12 hợp nhất Hà Tây về Hà Nội chống trùng lặp hồi tố; và 2025 theo Nghị quyết 202/2025/QH15 sáp nhập 63 thành 34 tỉnh thành với 5 quy tắc toán học `sum`, `weighted_mean`, `growth_constant_scale`, `index_chain`, `non_aggregable`.

2. **Khai thác 7 phân hệ dữ liệu Finco & Thị trường Hàng hóa**:
   - Sử dụng `get_gso_data` và `query_macro_data_unified` cho phân hệ `NSO` (28 bảng PX-Web, Phụ lục `PLV01..PLV14`), `FISCAL` (Ngân sách Bộ Tài chính `THUCHINS` 1995–2026) và `KTXH_GSO` (Báo cáo Kinh tế – Xã hội 2000–2026).
   - Sử dụng `get_customs_commodity_trade`, `get_customs_country_trade`, `get_customs_province_trade` và `get_customs_trade_data` cho phân hệ `CUSTOMS` (11 biểu mẫu Hải quan) và `COMMODITY_MARKET` (5 nhóm ngành Năng lượng, Kim loại, Nông sản, Thủy sản & Chăn nuôi, Vật liệu công nghiệp).
   - Sử dụng `get_vhlss_survey_data` và `query_macro_data_unified` cho `SURVEY_INDEX` (`PCI, PGI, PAPI, PII, ICT, PAR, SIPAS`, `VHLSS`).
   - Sử dụng `get_global_macro_data` với nhóm vùng `ASEAN, G7, BRICS, OECD, EU` cho phân hệ `MAIN_MARKET`.

3. **Truy vấn Báo cáo tài chính & Kinh tế lượng 1-Click**:
   - Dùng `get_batch_financial_data` để lấy báo cáo tài chính nhiều mã chứng khoán trong 1 lệnh, tự động phân tách 4 chế độ kế toán `NonFin`, `Bank`, `Stock`, `Insurance`.
   - Dùng `run_complete_econometric_study`, `run_macro_econometric_pipeline` hoặc `run_panel_econometric_pipeline` để thực thi trọn gói thống kê mô tả, tương quan, ước lượng mô hình, kiểm định chẩn đoán và sinh mã tái lập Stata, R, Python.