{
  "markdown": "# japan-data-mcp\n\n<!-- mcp-name: io.github.Izyuusya/japan-data-mcp -->\n\n日本の地域分析・比較に特化した MCP（Model Context Protocol）サーバーです。\n\n[e-Stat（政府統計の総合窓口）](https://www.e-stat.go.jp/)、\n[国税庁 法人番号公表サイト](https://www.houjin-bangou.nta.go.jp/)、\n[国土交通省 不動産情報ライブラリ](https://www.reinfolib.mlit.go.jp/)、\n[適格請求書発行事業者公表サイト](https://www.invoice-kohyo.nta.go.jp/) の API を通じて\n日本の公的データにアクセスし、人間が読みやすい形式に自動変換して返します。\n\n<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/Izyuusya/japan-data-mcp/main/docs/demo-chat.gif\" alt=\"japan-data-mcp デモ: Claude Desktopで「札幌市の人口を教えて」と聞くと、出典付きデータが返る\" width=\"700\">\n</p>\n\n> **解説記事**: [e-Stat APIを100回叩いてわかった、政府データが宝の持ち腐れな件｜DATA POPCORN](https://datapopcorn.jp/japan-data-mcp/)\n\n## 特徴\n\n- **コード自動変換** — e-Stat が返すコード番号（`13000` → `東京都`）を名称に自動変換\n- **全国市区町村対応** — 47 都道府県 + 20 政令指定都市 + 全国約 1,700 市区町村に対応\n- **地域比較** — 複数地域のデータをピボットテーブルで並べて比較\n- **プリセット分析** — 統計表 ID を知らなくても、地域名だけで人口データや地域プロファイルを取得\n- **法人検索** — 法人名から企業の法人番号・所在地・種別を検索\n- **インボイス確認** — 会社名からインボイス登録番号を検索、登録状況・有効性を確認\n- **不動産取引価格** — 地域の不動産取引データと価格サマリーを取得\n- **データ検証** — 全ての出力にデータ出典・検証リンク・取得日時を付与\n\n## 提供ツール一覧\n\n### 統計データ（e-Stat API）\n\n| ツール名 | 説明 |\n| --- | --- |\n| `search_statistics` | キーワードで統計表を検索 |\n| `get_regional_data` | 指定地域の統計データを取得（`summary=True` で最新データのみ） |\n| `compare_regions` | 複数地域のデータを比較（ピボットテーブル） |\n| `get_meta_info` | 統計表のメタ情報（分類コード体系）を確認 |\n| `resolve_area` | 地域名 → 地域コードを検索 |\n| `list_available_stats` | 統計分野コードの一覧を表示 |\n| `get_population` | 地域の人口データを自動取得（プリセット） |\n| `get_regional_profile` | 地域の総合プロファイルを自動取得（プリセット） |\n\n### 法人情報（法人番号 Web-API）\n\n| ツール名 | 説明 |\n| --- | --- |\n| `search_corporations` | 法人名で企業を検索（地域・種別で絞り込み可） |\n| `get_corporation` | 法人番号から企業の詳細情報を取得 |\n\n### インボイス（適格請求書発行事業者公表 Web-API）\n\n| ツール名 | 説明 |\n| --- | --- |\n| `search_invoice_by_name` | 会社名からインボイス登録番号を検索（法人のみ） |\n| `check_invoice_registration` | 登録番号（T+13桁）でインボイス登録状況を確認 |\n| `validate_invoice_on_date` | 指定日時点でのインボイス登録有効性を確認 |\n\n### 不動産取引（不動産情報ライブラリ API）\n\n| ツール名 | 説明 |\n| --- | --- |\n| `get_real_estate_transactions` | 不動産取引価格情報を取得（価格サマリー付き） |\n\n## セットアップ\n\n### 1. インストール\n\n```bash\n# uv（推奨）\nuv add japan-data-mcp\n\n# pip\npip install japan-data-mcp\n\n# ソースから\ngit clone https://github.com/Izyuusya/japan-data-mcp.git\ncd japan-data-mcp\nuv sync\n```\n\n### 2. APIキー設定\n\n対話的セットアップコマンドで簡単に設定できます:\n\n```bash\njapan-data-mcp setup\n```\n\n画面の案内に従って API キーを入力すると `.env` ファイルが自動生成されます。\n\n#### 必要なAPIキー\n\n| 環境変数 | API | 必須 | 取得先 |\n| --- | --- | --- | --- |\n| `ESTAT_APP_ID` | e-Stat API | **必須** | [e-Stat API ガイド](https://www.e-stat.go.jp/api/api-info/api-guide) |\n| `CORP_APP_ID` | 法人番号 Web-API | 任意 | [法人番号公表サイト](https://www.houjin-bangou.nta.go.jp/webapi/)（発行まで2〜4週間） |\n| `REALESTATE_API_KEY` | 不動産情報ライブラリ API | 任意 | [不動産情報ライブラリ](https://www.reinfolib.mlit.go.jp/api/request/) |\n\n- **e-Stat API は必須** です。未設定の場合サーバーが起動しません。\n- 法人番号・不動産 API は任意です。未設定でも他の機能は正常に動作します。\n- `CORP_APP_ID` はインボイスAPIでも共用されます（追加キー不要）。\n- 全て **無料** で取得できます。\n\n#### 手動設定する場合\n\nプロジェクトルートに `.env` ファイルを作成:\n\n```\nESTAT_APP_ID=あなたのアプリケーションID\nCORP_APP_ID=あなたのアプリケーションID\nREALESTATE_API_KEY=あなたのAPIキー\n```\n\n### 3. サーバー起動\n\n```bash\njapan-data-mcp\n```\n\n## Claude Desktop での設定\n\n`claude_desktop_config.json` に以下を追加してください。\n\n### uv でインストールした場合\n\n```json\n{\n  \"mcpServers\": {\n    \"japan-data-mcp\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"japan-data-mcp\"],\n      \"env\": {\n        \"ESTAT_APP_ID\": \"あなたのアプリケーションID\",\n        \"CORP_APP_ID\": \"あなたのアプリケーションID（任意）\",\n        \"REALESTATE_API_KEY\": \"あなたのAPIキー（任意）\"\n      }\n    }\n  }\n}\n```\n\n### pip でインストールした場合\n\n```json\n{\n  \"mcpServers\": {\n    \"japan-data-mcp\": {\n      \"command\": \"japan-data-mcp\",\n      \"env\": {\n        \"ESTAT_APP_ID\": \"あなたのアプリケーションID\",\n        \"CORP_APP_ID\": \"あなたのアプリケーションID（任意）\",\n        \"REALESTATE_API_KEY\": \"あなたのAPIキー（任意）\"\n      }\n    }\n  }\n}\n```\n\n> **ヒント**: `.env` ファイルに設定済みの場合は `env` セクションを省略できます。\n\n## 使用例\n\n### 地域の人口データを取得する\n\n```\nget_population(\"札幌市\")\n```\n\n### 複数地域を比較する\n\n```\ncompare_regions(\n    stats_data_id=\"0003433219\",\n    areas=[\"札幌市\", \"仙台市\", \"福岡市\"]\n)\n```\n\n### 法人を検索する\n\n```\nsearch_corporations(\"トヨタ\", area=\"愛知県\")\n```\n\n### インボイス登録を確認する\n\n```\nsearch_invoice_by_name(\"トヨタ自動車\", area=\"愛知県\")\n```\n\n### 不動産取引価格を調べる\n\n```\nget_real_estate_transactions(\"札幌市\", year=2023)\n```\n\n### 地域の総合プロファイルを取得する\n\n```\nget_regional_profile(\"東京都\")\n```\n\n人口・経済・労働など複数分野のデータをまとめて取得し、1 つのレポートとして返します。\n\n## 開発\n\n```bash\n# 依存関係のインストール\nuv sync\n\n# テスト実行\nuv run python -m pytest tests/ -v\n\n# サーバーの直接起動\nuv run japan-data-mcp\n```\n\n## 出典\n\nこのプロジェクトは以下の API を利用しています:\n\n- [e-Stat（政府統計の総合窓口）](https://www.e-stat.go.jp/) — 統計データは [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/deed.ja) で提供\n- [国税庁 法人番号公表サイト Web-API](https://www.houjin-bangou.nta.go.jp/webapi/) — 法人番号・法人情報\n- [国税庁 適格請求書発行事業者公表サイト Web-API](https://www.invoice-kohyo.nta.go.jp/web-api/) — インボイス登録情報\n- [国土交通省 不動産情報ライブラリ](https://www.reinfolib.mlit.go.jp/) — 不動産取引価格情報\n\n> このサービスは各 API 提供元のデータを利用していますが、サービスの内容は各機関によって保証されたものではありません。\n\n## ライセンス\n\nMIT License\n",
  "bytes": 4830,
  "sha": "1a65293de43b350f486b386ff674d963b66f91d79561d69f3568696b4815b2c5",
  "repo_slug": "izyuusya/japan-data-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_izyuusya_japan_data_mcp_f9e6cd50/readme"
}