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
CODEBLOCK0
Fetch statistical data
CODEBLOCK1
Test connectivity
CODEBLOCK2
Filter Parameters
- -
--cd-tab — Table item code (表章事項コード) - INLINECODE1 — Time code (時間軸事項コード). Example:
2024000 for 2024 - INLINECODE3 — Area code (地域事項コード). Example:
13000 for Tokyo - INLINECODE5 — Classification code 01 (分類事項01コード)
Common Statistics
Find table IDs via estat-mcp search:
| Topic | Search keyword | Examples |
|---|
| Population (人口) | INLINECODE7 | 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 - INLINECODE13 → fetch data with filters
- 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 INLINECODE16
技能名称: estat-mcp
详细描述:
e-Stat:日本政府统计数据API
从e-Stat(政府统计综合窗口)搜索和获取官方统计数据,这是日本政府开放数据的中央门户。涵盖人口、GDP、CPI、贸易、劳动力以及来自所有部委的3000多个统计表格。
使用场景
- - 按都道府县和年份查询日本人口
- 比较消费者物价指数随时间的变化趋势
- 获取GDP和国民账户数据用于经济分析
- 按商品或国家检索贸易统计数据
- 访问劳动力调查数据
命令
搜索统计数据
bash
按关键词搜索(日语或英语)
estat-mcp search 人口
estat-mcp search 消費者物価指数 --limit 10
estat-mcp search GDP --format json
获取统计数据
bash
基本数据获取
estat-mcp data 0003410379
带筛选条件(地区=东京,年份=2024)
estat-mcp data 0003410379 --cd-area 13000 --cd-time 2024000
用于程序化处理的JSON输出
estat-mcp data 0003410379 --limit 50 --format json
测试连接
bash
estat-mcp test
筛选参数
- - --cd-tab — 表格项目代码
- --cd-time — 时间代码。示例:2024000 代表2024年
- --cd-area — 地区代码。示例:13000 代表东京
- --cd-cat01 — 分类代码01
常用统计数据
通过 estat-mcp search 查找表格ID:
| 主题 | 搜索关键词 | 示例 |
|---|
| 人口 | 人口推計 | 总数、按年龄、按都道府县 |
| CPI(物价) |
消費者物価指数 | 月度/年度价格指数 |
| GDP(国民经济核算) | 国民経済計算 | 名义/实际GDP、支出 |
| 劳动力 | 労働力調査 | 失业率、就业人数 |
| 贸易 | 貿易統計 | 按国家分类的进出口 |
工作流程
- 1. estat-mcp search <关键词> → 查找统计表格ID
- estat-mcp data --format json → 使用筛选条件获取数据
- 分析JSON输出
设置
- - 需要 ESTATAPPID 环境变量
- 免费API密钥注册:https://www.e-stat.go.jp/api/api-info/use-api
- 速率限制为每秒1次请求
- Python包:pip install estat-mcp 或 uv tool install estat-mcp