Back to Skill Marketplace

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).

Updated today<1 min setup

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).

SKILL.mdALPHIO / VERIFIED

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

CategoryPrefixDescription
Pricescgpi, sppi, cspi, ropCorporate/Services price indices
SurveyscoTANKAN (Short-term Economic Survey)
Flow of FundsfofFinancial assets & liabilities
Balance of PaymentsbpInternational transactions
International InvestmentqiipInternational investment position
BIS StatisticsbisBIS international banking/debt
Money StockmdMoney stock statistics
Interest RatesirVarious interest rates

Workflow

  1. boj-mcp datasets -> browse available datasets
  2. boj-mcp search <keyword> -> find relevant series
  3. boj-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-mcp or uv 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.

Feedback will appear here as this skill is used and reviewed.

Leave feedback

Discover more

Related skills

View all
featuredMacro

Supply 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…

MacroExplore
featuredMacro

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.

MacroExplore
featuredMacro

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…

MacroExplore
Kostenlos starten