estat-mcp

📈 日本政府官方统计数据一键查询

基于日本政府官方e-Stat API的只读数据查询工具,可检索人口、GDP、CPI等3000+统计表,适合经济研究与数据分析场景。

收藏
16.1k
安装
4k
版本
v0.2.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

estat-mcp 是一个专门用于访问日本政府统计数据(e-Stat)的 MCP Skill。用户通过命令行工具完成三步工作流:首先使用 estat-mcp search <关键词>> 检索统计表ID,支持日文或英文关键词;然后使用 estat-mcp data <表ID>> 获取具体数据,可配合 --cd-area(地域代码)、--cd-time(时间代码)等参数进行精准过滤;最后以 JSON 格式输出结果供进一步分析。该工具覆盖人口推計、消費者物価指数、国民経済計算、労働力調査、貿易統計等核心经济领域。

显著优点

官方数据源权威性:直接对接日本政府统计综合窗口(e-Stat),数据涵盖总务省、经济产业省、厚生劳动省等所有中央省厅的3000+统计表,确保数据的官方性和准确性。

零代码执行风险:纯只读数据查询工具,不涉及任何动态代码执行、文件系统操作或系统命令调用,从根本上杜绝了代码注入和权限提升风险。

开源可审计:采用 Apache-2.0 许可证,源码完全公开,依赖包通过标准 PyPI/uv 分发,安装过程透明可控。

轻量易用:单一职责设计,命令结构清晰(search/data/test),配合 JSON 输出格式,便于集成到数据分析 pipeline 或自动化脚本中。

潜在缺点与局限性

API 速率限制严格:e-Stat 官方限制每秒仅1次请求,大规模数据抓取场景下效率受限,需要实现重试和节流逻辑。

地域覆盖单一:仅支持日本国内统计数据,无法获取其他国家或地区的对比数据。

语言门槛:统计表元数据和部分关键词需使用日文,对非日语用户存在一定使用门槛。

作者账号较新:GitHub 账号创建于2026年2月,项目 Stars 为0,虽然被 OpenClaw 平台收录,但长期维护承诺有待观察。

适合的目标群体

  • 经济研究人员:需要获取日本宏观经济指标(GDP、CPI、失业率)进行学术分析
  • 数据分析师:构建日本市场相关的数据看板或预测模型
  • 金融从业者:跟踪日本贸易统计、物价趋势以支持投资决策
  • 学生与教育工作者:获取官方统计数据完成课程作业或教学案例
  • 跨国企业战略部门:分析日本人口结构、消费趋势等市场基础数据

使用风险

API 密钥管理风险:ESTAT_APP_ID 需用户自行从 e-Stat 官网申请并配置为环境变量,若误写入日志或代码仓库可能导致密钥泄露。建议配合密钥管理服务使用。

网络依赖与稳定性:完全依赖 e-Stat 官方 API 的可用性,若政府端服务维护或网络波动将直接影响功能。建议实现本地缓存机制应对短期中断。

数据时效性:政府统计数据存在发布延迟(如月度CPI通常在次月中下旬发布),实时性要求高的场景需确认数据更新周期。

合规使用边界:虽然数据为开放数据,但大规模自动化抓取可能触发平台风控,建议遵守每秒1次的速率限制,避免对官方服务造成压力。

安全解读

核心用法

estat-mcp 是连接日本政府统计门户 e-Stat 的 MCP 工具,通过 CLI 命令检索官方统计数据。主要工作流程为:先用 search 命令查找统计表 ID,再用 data 命令获取具体数据。支持按地区(--cd-area)、时间(--cd-time)、分类(--cd-cat01)等多维度筛选,输出格式可选 JSON 便于程序化分析。

显著优点

1. 权威数据源:直接对接日本政府统计门户,数据涵盖总务省统计局、财务省、厚生劳动省等各省厅官方统计
2. 覆盖全面:3000+ 统计表,涵盖人口推計、消費者物価指数、国民経済計算、労働力調査、貿易統計等核心经济社会指标

3. 检索便捷:支持日英双语关键词搜索,无需记忆复杂表号

4. 零代码依赖:纯 Markdown 文档型 Skill,通过外部 CLI 工具执行,无内嵌可执行代码

潜在局限

  • 环境配置门槛:需注册并配置 ESTAT_APP_ID 环境变量,对非技术用户不够友好
  • 速率限制:API 限速 1 req/sec,大规模数据抓取需控制频率
  • 输出结构复杂:日本政府统计数据编码体系(表章事項コード、時間軸事項コード等)有一定学习成本
  • T3 来源级别:由社区维护(openclaw),非日本政府或 T1/T2 级机构直接背书

适合人群

  • 经济研究者和数据分析师(需日本宏观数据)
  • 日语学习者或日本市场研究人员
  • 已有 Python/uv 环境的技术用户
  • 需要自动化获取日本官方统计数据的工作流

常规风险

  • API Key 泄露风险:ESTAT_APP_ID 需妥善保管
  • 外部依赖风险:依赖 estat-mcp CLI 包的持续维护
  • 数据解读风险:统计口径和编码需对照官方文档理解,避免误读

estat-mcp 内容

手动下载zip · 1.8 kB
SKILL.mdtext/markdown
请选择文件