dvcrn 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
# Search by keyword (Japanese or English)
estat-mcp search 人口
estat-mcp search "消費者物価指数" --limit 10
estat-mcp search GDP --format json
Fetch statistical data
# 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
estat-mcp test
Filter Parameters
--cd-tab— Table item code (表章事項コード)--cd-time— Time code (時間軸事項コード). Example:2024000for 2024--cd-area— Area code (地域事項コード). Example:13000for 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
estat-mcp search <keyword>→ find statistics table IDestat-mcp data <id> --format json→ fetch data with filters- Analyze the JSON output
Setup
- Requires
ESTAT_APP_IDenvironment 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-mcporuv tool install estat-mcp