核心用法
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次的速率限制,避免对官方服务造成压力。