CommunityResearch & Data Analysisgithub.com

japan-gyousei-data

Access Japanese government open data. Search and retrieve real estate transaction prices (Ministry of Land), government procurement/bidding information, and e-Stat official statistics.

What is japan-gyousei-data?

This skill enables AI agents to access and query Japanese government open data in real-time via the MCP server at `mcp.n-3.ai`. It covers three major data sources: 1) Real estate transaction prices from the Ministry of Land, Infrastructure, Transport and Tourism, 2) Government procurement and bid information from KKJ (官公需), and 3) Official statistics from the e-Stat portal. The skill uses a shell script (`scripts/mcp-call.sh`) to make `curl` calls, as SSE is not supported for `web_fetch`. Each tool requires specific parameters—such as year, quarter, area codes for real estate, or search queries for procurements—and supports various filters. It is particularly useful for developers building AI tools that need to fetch live Japanese government data, such as property prices, contract tenders, or demographic statistics, without needing to handle the underlying API complexity.

Works with~Claude Code~Codex CLI~Cursor
npx skills add naoterumaker/japan-gyousei-data

Installed? Explore more Research & Data Analysis skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Administrative Open Data Skill

Access Japanese government open data via the MCP server (mcp.n-3.ai).

Data Sources

#NamePurposeTool
1Real Estate Transaction PriceActual transaction data from the Ministry of Landreinfolib-real-estate-price, reinfolib-city-list
2Government Procurement (Bids)Search for government and local government procurement caseskkj-search
3e-StatGovernment statistics portale-stat-get-stats-list, e-stat-get-meta-info, e-stat-get-data-catalog

How to Invoke

Use exec with curl. web_fetch is not available because it does not support SSE.

Use the script scripts/mcp-call.sh:

bash <skill_dir>/scripts/mcp-call.sh <data_source> <tool_name> '<arguments_json>'

Examples

# Real estate: Transaction prices in Osaka City
bash scripts/mcp-call.sh reinfo reinfolib-real-estate-price '{"year":"2025","quarter":"3","area":"27","city":"27102"}'

# Real estate: Get list of municipalities
bash scripts/mcp-call.sh reinfo reinfolib-city-list '{"area":"27"}'

# Government procurement: Search for AI-related bids (category 3=Services)
bash scripts/mcp-call.sh kkj kkj-search '{"query":"AI 人工知能","category":"3"}'

# e-Stat: Search statistics list
bash scripts/mcp-call.sh estat e-stat-get-stats-list '{"searchWord":"人口"}'

Tool Details

See references/tools.md for detailed parameters of each tool.

Notes

  • Government procurement region filter: kkj-search does not support prefecture parameters. Include a place name in the query string to narrow down results.
  • Government procurement details: The MCP only returns a list of search results. Check the original portal site for specifications, amounts, and deadlines.
  • Real estate prefecture code: 2-digit code (Tokyo=13, Osaka=27, etc.). Use reinfolib-city-list to get municipality codes.
  • e-Stat: First use get-stats-list to identify the statistic ID, then get-meta-info for metadata, and get-data-catalog to retrieve data.
  • Rate limits: Use at a reasonable frequency as these are public APIs.

Related Skills