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: 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:

Workflow

1. estat-mcp search → find statistics table ID
2. estat-mcp data --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