OpenClaw · Skill
Boj MCP
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.
Install
Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.
Primary command
clawhub install ajtgjmdjp/boj-mcpClawHub installer
npx clawhub@latest install ajtgjmdjp/boj-mcpOpenClaw CLI
openclaw skills install ajtgjmdjp/boj-mcpDirect OpenClaw install
openclaw install ajtgjmdjp/boj-mcpWhat this skill does
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.
Why it matters
Handles Shift_JIS encoding and local caching automatically, removing the manual overhead of downloading and parsing BOJ flat files directly.
Typical use cases
- Tracking Japan corporate goods price index trends over time
- Pulling services producer price index data for economic research
- Retrieving flow of funds data on financial assets and liabilities
- Accessing TANKAN survey results for business sentiment analysis
- Comparing Japan balance of payments across reporting periods
Source instructions
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