核心用法
boj-mcp 是一款面向日本央行（Bank of Japan）统计数据的查询工具，通过官方扁平文件下载服务获取权威经济指标。用户可通过三步工作流完成数据检索：首先使用 boj-mcp datasets 浏览可用数据集，随后通过 boj-mcp search <keyword>> 定位目标序列，最后执行 boj-mcp data <dataset_name>> 获取数据。支持表格与JSON两种输出格式，并可指定返回行数。
该工具覆盖八大类数据集：价格指标（CGPI企业物价指数、SPPI服务业价格指数等）、短观调查（TANKAN）、资金循环统计（Flow of Funds）、国际收支、国际投资头寸、BIS国际统计、货币存量及各类利率数据。所有数据源自日本央行官方统计搜索系统（https://www.stat-search.boj.or.jp/），采用Shift_JIS编码自动处理，首次下载后本地缓存加速后续访问。
显著优点
权威数据源：直接对接日本央行官方统计系统，数据公信力无需质疑，适用于学术论文、政策研究等严肃场景。零门槛使用：无需注册API密钥，所有扁平文件公开可访问，大幅降低使用成本。本地化缓存机制：首次下载后数据本地存储，重复查询响应迅速，兼顾效率与离线可用性。多格式输出：支持人类可读的表格格式与机器友好的JSON格式，满足不同下游处理需求。精准检索能力：支持跨数据集关键词搜索与指定数据集内搜索，快速定位目标时间序列。
潜在缺点与局限性
依赖外部工具：实际功能由独立的 boj-mcp Python包实现，本Skill仅为文档封装，工具本身的安全性、维护状态需额外评估。来源可信度有限：由个人开发者（ajtgjmdjp）维护，非日本央行官方或认证组织发布，长期维护承诺存疑。功能边界明确：仅支持数据读取，无数据分析、可视化或导出为Excel/CSV等高级功能，需配合其他工具完成完整工作流。日语环境依赖：原始数据采用Shift_JIS编码，虽自动处理，但部分指标名称保留日文（如"企業物価指数"），对非日语用户存在理解门槛。缓存管理缺失：文档未说明缓存清理机制，长期使用可能占用磁盘空间。
适合的目标群体
宏观经济研究人员：需要获取日本官方价格指标、资金流量数据进行经济周期分析。金融从业者：从事汇率、利率、跨境投资分析，需引用BIS统计或国际收支数据。学术教育工作者：经济学、金融学课程教学中需要真实央行数据案例。政策分析师：研究日本央行货币政策传导机制，需TANKAN调查等前瞻性指标。数据工程师：构建日本经济数据管道，需要标准化、可编程的数据获取接口。
使用风险
依赖项风险：boj-mcp Python包若停止维护或出现安全漏洞，将直接影响本Skill可用性，建议定期审查依赖状态。数据时效性：扁平文件更新频率取决于日本央行发布节奏，非实时数据流，高频交易等场景不适用。网络可达性：数据源为日本官方服务器，部分地区可能存在访问延迟或连接不稳定问题。缓存一致性：本地缓存机制未明确失效策略，用户需手动管理以确保获取最新数据。生产环境审慎：对数据来源可信度要求极高的生产系统，建议直接使用日本央行官网API或官方渠道，而非第三方封装工具。