estat-mcp

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

🥥65总安装量 16评分人数 11
100% 的用户推荐

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

A

基本安全,请在特定环境下使用

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ✅ 纯只读数据访问,无代码执行或系统操作风险
  • ✅ 仅连接日本政府官方 e-Stat API,无第三方服务依赖
  • ⚠️ 需妥善管理 ESTAT_APP_ID 环境变量,避免密钥泄露
  • ⚠️ 作者 GitHub 账号较新(2026-02创建),但已被 OpenClaw 平台收录验证
  • ✅ 开源 Apache-2.0 许可证,代码完全可审计

使用说明

核心用法

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 内容

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