---
name: ecodata-mcp
version: 3.77.0
platform: OpenAI Codex CLI / Codex Agent
mcp_endpoint: https://ecodata.io.vn/mcp
mcp_sse_endpoint: https://ecodata.io.vn/mcp/sse
description: >
  Bộ chỉ thị và kỹ năng chuyên dụng cho OpenAI Codex CLI / Agent để khai thác
  EcoData MCP Server (37 công cụ, 105 mô hình kinh tế lượng, chuỗi lịch sử 34/63 tỉnh thành,
  7 phân hệ Finco & Thị trường Hàng hóa) và sinh kịch bản tái lập Python, R, Stata.
---

# Kỹ năng khai thác EcoData MCP cho OpenAI Codex Agent

Đặt nội dung này vào `.agents/skills/ecodata-mcp/SKILL.md` hoặc tích hợp vào `AGENTS.md` để Codex Agent tự động truy xuất dữ liệu chuẩn hóa và kiểm định kinh tế lượng từ EcoData.

## 1. Nguyên tắc thực thi cho Codex Agent

- **Batch-First**: Luôn gom cụm truy vấn đa tỉnh, đa quốc gia và đa mã cổ phiếu bằng `query_macro_data_unified`, `get_global_macro_data` và `get_batch_financial_data`.
- **1-Click Econometrics**: Sử dụng `run_complete_econometric_study`, `run_macro_econometric_pipeline` và `run_panel_econometric_pipeline` để chạy toàn trình từ trích xuất dữ liệu, kiểm định khuyết tật đến sinh mã Stata 18 MP, R `fixest`/`plm` và Python `statsmodels`/`linearmodels`.
- **Chuẩn hóa địa giới hành chính Việt Nam 1995–2026**:
  - Truyền `boundary_mode="34"` trong `query_macro_data_unified` khi xây dựng chuỗi dữ liệu bảng 34 tỉnh thành theo Nghị quyết 202/2025/QH15.
  - Truyền `boundary_mode="63"` khi phân tích lịch sử theo cấu trúc 63 tỉnh thành trước ngày 01/07/2025.
  - Hệ thống đã tự động xử lý 3 mốc biến động lịch sử: giai đoạn 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; giai đoạn 2003–2008 theo Nghị quyết 15/2008/QH12 hợp nhất Hà Tây vào Hà Nội chống tính trùng hồi tố; và giai đoạn 2025 theo Nghị quyết 202/2025/QH15 gộp 63 thành 34 tỉnh thành theo 5 quy tắc `sum`, `weighted_mean`, `growth_constant_scale`, `index_chain`, `non_aggregable`.

## 2. Danh mục nguồn dữ liệu Finco & Hàng hóa trên EcoData

- `NSO`: 28 bảng PX-Web và Phụ lục 34 tỉnh thành `PLV01..PLV14`.
- `FISCAL`: Chuỗi Thu – Chi Ngân sách Nhà nước `THUCHINS` của Bộ Tài chính giai đoạn 1995–2026.
- `KTXH_GSO`: Báo cáo Kinh tế – Xã hội định kỳ tháng, quý, năm giai đoạn 2000–2026.
- `CUSTOMS`: 11 biểu mẫu Hải quan `1X, 1N, 2X, 2N, 3X, 3N, 4, 5X, 5N, HTX, PTVT`.
- `SURVEY_INDEX`: Bộ chỉ số thể chế cấp tỉnh `PCI, PGI, PAPI, PII, ICT, PAR, SIPAS` và khảo sát `VHLSS`.
- `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 qua 5 tab Tổng quan, Sản xuất, Xuất khẩu, Nhập khẩu & Tiêu thụ, Giá & Thị trường.
- `MAIN_MARKET`: 8 khu vực kinh tế trọng điểm gồm Việt Nam, Hoa Kỳ, Trung Quốc, Ấn Độ, Châu Âu, Đông Á, Đông Nam Á và Châu Mỹ – Trung Đông – Châu Đại Dương.