Macro
boj-mcp
boj-mcp is a command-line tool that provides direct access to Bank of Japan flat-file time-series statistics. It enables dataset discovery (boj-mcp datasets), keyword search across or within datasets (boj-mcp search), and data retrieval in table or JSON formats (boj-mcp data ... --format json).
Overview
boj-mcp is a command-line tool that provides direct access to Bank of Japan flat-file time-series statistics.
boj-mcp is a command-line tool that provides direct access to Bank of Japan flat-file time-series statistics. It enables dataset discovery (boj-mcp datasets), keyword search across or within datasets (boj-mcp search), and data retrieval in table or JSON formats (boj-mcp data ... --format json). Covered series include Corporate Goods Price Index (CGPI), Services PPI (SPPI), TANKAN survey, flow of funds, balance of payments, international investment position (QIIP), BIS statistics, money stock, interest rates, and exchange rates. Key features: no API key required, local caching for faster subsequent access, connectivity testing (boj-mcp test), and standardized dataset prefixes for quick navigation. Use cases include price and inflation analysis, balance-sheet and liquidity research, international accounts examination, automated reporting, and integration into analytic pipelines or visualizations.
Skill.md
How this skill works
boj-mcp is a command-line tool that provides direct access to Bank of Japan flat-file time-series statistics. It enables dataset discovery (boj-mcp datasets), keyword search across or within datasets (boj-mcp search), and data retrieval in table or JSON formats (boj-mcp data ... --format json).
BOJ: Bank of Japan Statistical Data
Access Bank of Japan time-series statistics from the official flat file download service. Covers price indices (CGPI, SPPI), flow of funds, balance of payments, international investment position, BIS statistics, and TANKAN survey data.
Use Cases
- Look up Corporate Goods Price Index (CGPI/企業物価指数) trends
- Analyze Services Producer Price Index (SPPI/企業向けサービス価格指数)
- Retrieve Flow of Funds data (資金循環統計)
- Access Balance of Payments statistics (国際収支統計)
- Review BIS international statistics
- Explore TANKAN survey results (短観)
Commands
List available datasets
# Show all available BOJ flat file datasets
boj-mcp datasets
Download and display data
# Display dataset in table format
boj-mcp data cgpi_m_en
# JSON output with more rows
boj-mcp data sppi_m_en --format json --rows 50
Search for series
# Search within a specific dataset
boj-mcp search "electricity" --dataset cgpi_m_en
# Search across datasets by name
boj-mcp search "price"
Test connectivity
boj-mcp test
Available Dataset Categories
| Category | Prefix | Description |
|---|---|---|
| Prices | cgpi, sppi, cspi, rop | Corporate/Services price indices |
| Surveys | co | TANKAN (Short-term Economic Survey) |
| Flow of Funds | fof | Financial assets & liabilities |
| Balance of Payments | bp | International transactions |
| International Investment | qiip | International investment position |
| BIS Statistics | bis | BIS international banking/debt |
| Money Stock | md | Money stock statistics |
| Interest Rates | ir | Various interest rates |
Workflow
boj-mcp datasets-> browse available datasetsboj-mcp search <keyword>-> find relevant seriesboj-mcp data <dataset_name>-> retrieve data
Important
- No API key required — BOJ flat files are publicly available
- Data is cached locally after first download for faster subsequent access
- Files are in Shift_JIS encoding (handled automatically)
- Data source: Bank of Japan (https://www.stat-search.boj.or.jp/)
- Python package:
pip install boj-mcporuv tool install boj-mcp
Best used for
When to use it
boj-mcp is a command-line tool that provides direct access to Bank of Japan flat-file time-series statistics. It enables dataset discovery (boj-mcp datasets), keyword search across or within datasets (boj-mcp search), and data retrieval in table or JSON formats (boj-mcp data ... --format json).
01 · PRE-MEETING
Prepare a decision brief
Turn scattered evidence into a structured case before an investment committee meeting.
02 · TEAM WORKFLOW
Standardize handoffs
Create consistent research outputs across analysts, portfolio managers, and agents.
03 · LIVE UPDATE
Refresh the thesis
Update scenarios after a new catalyst, KPI release, or earnings result.
Community notes
Built to improve with use.
随着 Skill 被使用与评审，反馈将展示在这里。
Discover more
Related skills
View allSupply Chain Analysis
Translate supplier signals, lead times, capacity, channel checks, and inventory behavior into forward revenue and margin implications. Use when the user wants a supply-chain-based demand or risk…
Consumer Spending Tracker
Track consumer demand through spending, traffic, category mix, promotions, and channel behavior. Use when the user wants a live read on discretionary or staples demand trends.
Enterprise IT Spending Intent
Translate enterprise IT budgets, CIO surveys, channel checks, and vendor commentary into demand signals for software and infrastructure names. Use when the user wants a forward read on enterprise…