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 variable - Free API key registration: https://www.e-stat.go.jp/api/api-info/use-api - Rate limited to 1 req/sec - Python package: `pip install estat-mcp` or `uv tool install estat-mcp`