---
name: ecodata-mcp
version: 3.77.0
platform: Claude Code CLI / Claude Desktop
mcp_endpoint: https://ecodata.io.vn/mcp
mcp_sse_endpoint: https://ecodata.io.vn/mcp/sse
description: >
  Kỹ năng chuyên dụng cho Claude Code và Claude Desktop để truy xuất EcoData MCP Server:
  37 công cụ dữ liệu kinh tế vĩ mô, chuỗi lịch sử 34 và 63 tỉnh thành Việt Nam qua 3 mốc
  địa giới hành chính, 7 phân hệ Finco & Thị trường Hàng hóa, báo cáo tài chính 30 năm
  và 105 mô hình kinh tế lượng.
---

# Kỹ năng khai thác EcoData MCP cho Claude Code và Claude Desktop

Lưu tệp này vào `.claude/skills/ecodata-mcp/SKILL.md` hoặc đính kèm vào `CLAUDE.md` của dự án để Claude tự động chọn công cụ tối ưu nhất khi phân tích dữ liệu kinh tế và tài chính.

## 1. Cài đặt nhanh kết nối MCP

Chạy lệnh sau trên Claude Code CLI hoặc thêm vào `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "ecodata": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sse", "https://ecodata.io.vn/mcp/sse"],
      "env": {
        "ECODATA_TOKEN": "YOUR_ECODATA_ACCESS_TOKEN"
      }
    }
  }
}
```

## 2. Quy tắc điều phối công cụ Batch-First và 1-Click

1. **Một bước cho nghiên cứu hoàn chỉnh**: Khi yêu cầu phân tích kinh tế lượng đã rõ biến số, gọi `run_complete_econometric_study`, `run_macro_econometric_pipeline` hoặc `run_panel_econometric_pipeline`. Không gọi lặp thêm các công cụ thống kê rời rạc sau khi pipeline hoàn tất.
2. **Một bước cho dữ liệu vĩ mô & tỉnh thành**: Gọi `query_macro_data_unified` thay vì gọi riêng lẻ từng tỉnh hoặc từng năm.
3. **Một bước cho báo cáo tài chính**: Gọi `get_batch_financial_data` để trích xuất đồng thời nhiều mã chứng khoán theo 4 chế độ kế toán Việt Nam gồm `NonFin`, `Bank`, `Stock` và `Insurance`.

## 3. Xử lý ba mốc lịch sử địa giới hành chính Việt Nam

Tham số `boundary_mode` trong `query_macro_data_unified` hỗ trợ hai chế độ `"63"` và `"34"`:
- **Giai đoạn 1995–2003 theo Nghị quyết 22/2003/QH11**: Chuẩn hóa tách Lai Châu và Điện Biên, Đắk Lắk và Đắk Nông, Cần Thơ và Hậu Giang.
- **Giai đoạn 2003–2008 theo Nghị quyết 15/2008/QH12**: Chuẩn hóa hợp nhất Hà Tây, Mê Linh và 4 xã Hòa Bình vào Hà Nội, tự động kiểm soát hồi tố để không cộng trùng số liệu.
- **Giai đoạn 2025 theo Nghị quyết 202/2025/QH15**: Chuẩn hóa sáp nhập 63 tỉnh thành còn 34 tỉnh thành theo 5 quy tắc gộp chỉ tiêu `sum`, `weighted_mean`, `growth_constant_scale`, `index_chain`, `non_aggregable`, khớp từ 99,5% trở lên với Phụ lục 34 tỉnh NSO `PLV01..PLV14`.

## 4. Tra cứu nhanh 7 phân hệ Finco & Thị trường Hàng hóa

- **Thống kê & Ngân sách**: `NSO` (28 bảng PX-Web, Phụ lục `PLV01..PLV14`), `FISCAL` (Thu chi ngân sách Bộ Tài chính `THUCHINS` 1995–2026), `KTXH_GSO` (Báo cáo Kinh tế – Xã hội 2000–2026).
- **Ngoại thương & Hàng hóa**: `CUSTOMS` (11 biểu mẫu `1X, 1N, 2X, 2N, 3X, 3N, 4, 5X, 5N, HTX, PTVT`), `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).
- **Khảo sát & Khu vực**: `SURVEY_INDEX` (`PCI, PGI, PAPI, PII, ICT, PAR, SIPAS`), `VN_34_REBUILD` (Panel 34 tỉnh 2000–2026), `MAIN_MARKET` (8 khu vực kinh tế lớn toàn cầu).