SkillHub

estat-mcp

v0.2.2

Search and retrieve Japanese government statistics (人口, GDP, CPI, 貿易, 雇用) from e-Stat API — Japan's official open data portal with 3,000+ statistical tables. Population, economy, trade, employment data. Free API.

Sourced from ClawHub, Authored by ajtgjmdjp

Installation

Please help me install the skill `estat-mcp` from SkillHub official store. npx skills add ajtgjmdjp/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

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

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