用途:通过日本银行公开 API 获取、检索和分析时间序列统计数据,覆盖利率、货币、汇率、短观(Tankan)、国际收支等全部 BOJ 数据库。
主要能力:提供 list-db(列出全部数据库)、get-metadata(获取某库的系列元数据)、search-series(按关键词检索系列,支持 --db all 跨全部约 50 个库搜索,约需 2 分钟)、get-data(按系列代码取数)、get-layer(按层级取数)、latest(取最新数据点)等子命令。输出支持 json、csv、tsv、table,语言支持 jp、en,可分页并自动处理 NEXTPOSITION。
使用方式:脚本为 scripts/boj_statistics_cli.py(Python 3.11+,仅用标准库),通过 uv run --project scripts 执行。例如:uv run --project scripts scripts/boj_statistics_cli.py list-db;uv run --project scripts scripts/boj_statistics_cli.py search-series --db FM08 --keywords ドル 円;uv run --project scripts scripts/boj_statistics_cli.py get-data --db FM08 --code FXERD01 --start 202401 --end 202412 --format table。常用选项包括 --format、--lang、--output、--max-series-size、--max-item-length、--max-pages。
适用场景:查询汇率走势、短观业况 DI、国际收支等时间序列数据,或在不清楚系列代码时先按关键词检索。
限制:系列代码不含数据库名前缀;单次 get-data 请求内所有系列须频率一致;周/日频日期参数使用 YYYYMM 格式;API 限制高频访问,脚本自动限速;元数据结果含空 series_code 的层级表头行;错误以 JSON 输出到 stderr。具体收费、价格与平台支持情况暂未提供。