estat-mcp

# e-Stat: Japanese Government Statistics API

Search and fetch official statistics from e-Stat (政府統計の総合窓口), Japan's central portal for government open data. Covers population, GDP, CPI, trade, labor, and 3,000+ statistical tables from all ministries.

## Use Cases

- Look up Japan's population by prefecture and year
- Compare CPI (消費者物価指数) trends over time
- Fetch GDP and national accounts data for economic analysis
- Retrieve trade statistics (輸出入) by commodity or country
- Access labor force survey data (完全失業率, 就業者数)

## Commands

### Search for statistics
```bash
# Search by keyword (Japanese or English)
estat-mcp search 人口
estat-mcp search "消費者物価指数" --limit 10
estat-mcp search GDP --format json
```

### Fetch statistical data
```bash
# Basic data fetch
estat-mcp data 0003410379

# With filters (area=Tokyo, year=2024)
estat-mcp data 0003410379 --cd-area 13000 --cd-time 2024000

# JSON output for programmatic use
estat-mcp data 0003410379 --limit 50 --format json
```

### Test connectivity
```bash
estat-mcp test
```

## Filter Parameters

- `--cd-tab` — Table item code (表章事項コード)
- `--cd-time` — Time code (時間軸事項コード). Example: `2024000` for 2024
- `--cd-area` — Area code (地域事項コード). Example: `13000` for Tokyo
- `--cd-cat01` — Classification code 01 (分類事項01コード)

## Common Statistics

Find table IDs via `estat-mcp search`:

| Topic | Search keyword | Examples |
|---|---|---|
| Population (人口) | `人口推計` | Total, by age, by prefecture |
| CPI (物価) | `消費者物価指数` | Monthly/annual price indices |
| GDP (国民経済計算) | `国民経済計算` | Nominal/real GDP, expenditure |
| Labor (労働) | `労働力調査` | Unemployment, employment |
| Trade (貿易) | `貿易統計` | Imports/exports by country |

## Workflow

1. `estat-mcp search <keyword>` → find statistics table ID
2. `estat-mcp data <id> --format json` → fetch data with filters
3. Analyze the JSON output

## Setup

- Requires `ESTAT_APP_ID` environment vari...