boj-mcp

What This Skill Does

The boj-mcp skill is a powerful data extraction agent designed for the OpenClaw ecosystem, providing direct integration with the Bank of Japan (BOJ) official statistical database. By interfacing with the BOJ’s public flat-file download service, this agent allows users to programmatically retrieve, parse, and analyze critical macroeconomic indicators without the need for manual CSV processing or API key management. It handles complex encoding issues like Shift_JIS automatically and provides a standardized command-line interface to navigate datasets ranging from price indices (CGPI, SPPI) to Flow of Funds and TANKAN survey results. This skill serves as a reliable data pipeline for economists, financial analysts, and developers building decision-support systems focused on the Japanese economy.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface or your preferred package manager. Ensure your environment has basic Python capabilities:

1. Install via OpenClaw: clawhub install openclaw/skills/skills/ajtgjmdjp/boj-mcp
2. Alternatively, install via pip: pip install boj-mcp
3. Verify the installation by running boj-mcp test to confirm connectivity to the BOJ servers.

Use Cases

• Macroeconomic Forecasting: Retrieve real-time data on Corporate Goods Price Indices to assess domestic inflation trends.
• Investment Research: Analyze Flow of Funds statistics to track the capital allocation patterns of Japanese financial institutions.
• Corporate Analysis: Leverage TANKAN (Short-term Economic Survey) results to understand business sentiment across various industrial sectors.
• Policy Analysis: Review Balance of Payments and Money Stock data to monitor the impact of Bank of Japan monetary policy shifts.

Example Prompts

1. "Search for the latest Corporate Goods Price Index (CGPI) data series related to electricity and display the results in a table."
2. "Get the last 50 entries from the SPPI (Services Producer Price Index) dataset and provide the output in JSON format for my analysis script."
3. "List all available categories for the Flow of Funds statistics so I can identify the specific dataset for corporate liabilities."

Tips & Limitations

• Caching: The tool caches downloaded datasets locally. If you suspect data has been updated, you may need to clear the cache or re-request the data.
• Data Structure: While the tool converts flat files into accessible formats, users should be familiar with the official naming conventions (e.g., cgpi_m_en for monthly price data).
• Limitations: This skill is strictly for public statistical data. It does not provide private banking records or real-time trading execution. It operates on a read-only basis for public macroeconomic reports.