japan-gyousei-data

Access Japanese administrative open data, including real estate transaction prices, government procurement information, and e-Stat government statistics, via a real-time MCP server.

53 stars

bynaoterumaker

Complexity: medium

View on GitHub Installation ↓

About this skill

This AI agent skill provides programmatic access to key Japanese administrative open data sources. It allows agents to retrieve real estate transaction prices from the Ministry of Land, Infrastructure, Transport and Tourism (MLIT), search government and municipal procurement (bidding) information, and query official government statistics from the e-Stat portal. Data is accessed in real-time through an MCP server (`mcp.n-3.ai`) using `curl` via a provided shell script. Users can specify various parameters such as years, quarters, geographic areas for real estate, keywords and categories for procurement, and search terms for statistics. The skill simplifies the process of interacting with these public APIs, abstracting away some of the complexities of direct API calls. It's designed for automation and integration into AI agent workflows requiring Japanese public sector data. Someone would use this skill to automate the collection of official Japanese data for market analysis, academic research, public interest reporting, or for businesses looking to identify government contracting opportunities or monitor land value trends. It streamlines access to critical public information, enabling agents to perform comprehensive data-driven tasks.

Best use case

The primary use case is for AI agents, developers, and data analysts who need to programmatically and efficiently retrieve official Japanese government data for purposes such as market analysis, economic research, business intelligence, or automated reporting. It benefits users who require up-to-date information on real estate, public procurement, or national statistics without manual portal navigation.

Access Japanese administrative open data, including real estate transaction prices, government procurement information, and e-Stat government statistics, via a real-time MCP server.

Users should expect structured JSON data containing information about real estate transactions, government procurement listings, or government statistical metadata/data catalogs based on their query.

Practical example

Example input

大阪市の不動産取引価格を2025年第3四半期で調べてください。

Example output

{ "data_source": "reinfo", "tool_name": "reinfolib-real-estate-price", "query_params": { "year": "2025", "quarter": "3", "area": "27", "city": "27102" }, "result": [ { "property_type": "マンション", "transaction_price": "5000万円", "address": "大阪府大阪市北区..." } ] }

When to use this skill

When needing real-time Japanese real estate transaction price data for specific regions.
When searching for current Japanese government or municipal procurement and bidding opportunities by keyword or category.
When retrieving official Japanese government statistics from the e-Stat portal.
When automating data collection from specific Japanese public open data sources for research or analysis.

When not to use this skill

When seeking private or non-governmental Japanese data sources.
When requiring detailed specifications, exact bid amounts, or deadlines for procurement, as the skill only returns search results.
When the desired data requires Server-Sent Events (SSE) support through `web_fetch`, which is not supported by this skill's `exec` method.
When planning to make an extremely high volume of requests that might exceed public API rate limits.

How japan-gyousei-data Compares

Feature / Agent	japan-gyousei-data	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	medium	N/A

Frequently Asked Questions

What does this skill do?

Access Japanese administrative open data, including real estate transaction prices, government procurement information, and e-Stat government statistics, via a real-time MCP server.

How difficult is it to install?

The installation complexity is rated as medium. You can find the installation instructions above.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

Best AI Skills for Claude

Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.

AI Agent for Product Research

Browse AI agent skills for product research, competitive analysis, customer discovery, and structured product decision support.

AI Agent for SaaS Idea Validation

Use AI agent skills for SaaS idea validation, market research, customer discovery, competitor analysis, and documenting startup hypotheses.

SKILL.md Source

# 行政オープンデータスキル

日本政府のオープンデータに MCP サーバー（`mcp.n-3.ai`）経由でアクセスする。

## データソース

| # | 名前 | 用途 | ツール |
|---|------|------|--------|
| 1 | 不動産取引価格 | 国交省の実取引データ | `reinfolib-real-estate-price`, `reinfolib-city-list` |
| 2 | 官公需（入札） | 政府・自治体の調達案件検索 | `kkj-search` |
| 3 | e-Stat | 政府統計ポータル | `e-stat-get-stats-list`, `e-stat-get-meta-info`, `e-stat-get-data-catalog` |

## 呼び出し方法

`exec` で `curl` を使う。`web_fetch` は SSE 非対応のため不可。

スクリプト `scripts/mcp-call.sh` を使う:

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

### 例

```bash
# 不動産: 大阪市の取引価格
bash scripts/mcp-call.sh reinfo reinfolib-real-estate-price '{"year":"2025","quarter":"3","area":"27","city":"27102"}'

# 不動産: 市区町村一覧を取得
bash scripts/mcp-call.sh reinfo reinfolib-city-list '{"area":"27"}'

# 官公需: AI関連の入札検索（カテゴリ3=役務）
bash scripts/mcp-call.sh kkj kkj-search '{"query":"AI 人工知能","category":"3"}'

# e-Stat: 統計一覧検索
bash scripts/mcp-call.sh estat e-stat-get-stats-list '{"searchWord":"人口"}'
```

## ツール詳細

各ツールのパラメータ詳細は `references/tools.md` を参照。

## 注意点

- **官公需の地域フィルタ**: `kkj-search` は都道府県パラメータ未対応。クエリ文字列に地名を含めて絞り込む
- **官公需の詳細情報**: MCP は検索結果一覧のみ返す。仕様書・金額・締切は元ポータルサイトを確認
- **不動産の都道府県コード**: 2桁コード（東京=13, 大阪=27 等）。市区町村コードは `reinfolib-city-list` で取得
- **e-Stat**: まず `get-stats-list` で統計IDを特定し、`get-meta-info` でメタ情報、`get-data-catalog` でデータ取得
- **レート制限**: 公共APIのため常識的な頻度で利用する

Data & Research