io.github.Izyuusya/japan-data-mcp
日本の公的データ(統計・法人・不動産)にAIからアクセスするMCPサーバー。e-Stat統計API・法人番号Web-API・不動産情報ライブラリAPIの3API統合。全国約1,700市区町村対応。
Versions
0.1.1latestTools 14
search_statistics キーワードで統計表を検索する. Args: keyword: 検索キーワード(例: "人口", "国勢調査", "県内総生産") survey_years: 調査年で絞り込み(例: "2020", "2015-2020") stats_field: 統計分野コードで絞り込み(例: "02"=人口・世帯)。 list_available_stats で分野一覧を確認できます。 limit: 取得件数上限(デフォルト10) Returns: 検索結果の統計表一覧(ID・統計名・タイトルなど)
get_regional_data 指定した地域の統計データを取得し、整形して返す. コード番号は自動的に人間が読める名称に変換される。 Args: stats_data_id: 統計表ID(search_statistics で取得) area: 地域名(例: "東京都")または地域コード(例: "13000") tab_code: 表章項目コード(特定の指標に絞り込む場合) time_code: 時間軸コード(特定の年に絞り込む場合) cat01_code: 分類事項01コード(特定のカテゴリに絞り込む場合) limit: 取得件数上限(デフォルト1000) summary: Trueの場合、最新時点の主要指標のみ返す(データ量を大幅に削減) Returns: 整形済みの統計データ(マークダウンテーブル)
compare_regions 複数地域の統計データを比較する. 時間軸(年)を行、地域を列にしたピボットテーブルを生成。 Args: stats_data_id: 統計表ID(search_statistics で取得) areas: 比較する地域名のリスト(例: ["東京都", "大阪府", "愛知県"]) tab_code: 表章項目コード(特定の指標に絞り込む場合) cat01_code: 分類事項01コード(特定のカテゴリに絞り込む場合) Returns: 地域比較のピボットテーブル(マークダウン)
search_corporations 法人名で企業を検索する. 国税庁の法人番号公表サイトから法人情報を検索。 地域や法人種別で絞り込み可能。 Args: name: 検索キーワード(法人名、部分一致) area: 地域名で絞り込み(都道府県名、例: "東京都") kind: 法人種別で絞り込み("01"=国の機関, "02"=地方公共団体, "03"=設立登記法人, "04"=その他) limit: 取得件数上限(デフォルト10、最大2000) Returns: 法人情報の一覧(マークダウンテーブル)
get_corporation 法人番号から企業の詳細情報を取得する. 13桁の法人番号を指定して、法人の正式名称・所在地・種別などを取得。 Args: corp_number: 法人番号(13桁の数字) Returns: 法人の詳細情報(マークダウン)
get_real_estate_transactions 不動産取引価格情報を取得する. 国土交通省の不動産情報ライブラリから、指定地域の不動産取引データを取得。 取引種別・価格・面積・建築年・最寄駅などの情報を含む。 Args: area: 地域名(例: "東京都", "水戸市")または地域コード year: 取引年で絞り込み(例: 2023) quarter: 四半期で絞り込み(1〜4) Returns: 不動産取引データの一覧と価格サマリー(マークダウン)
check_invoice_registration 適格請求書発行事業者の登録情報を登録番号で確認する. インボイス制度に基づく適格請求書発行事業者の登録状況・ 名称・所在地などを確認できる。 Args: number: 登録番号(T+13桁の数字、例: "T1234567890123")。 カンマ区切りで最大10件まで同時に検索可能。 history: 変更履歴を含めるか(デフォルト: False) Returns: 登録事業者の情報(マークダウン)
validate_invoice_on_date 指定日時点での適格請求書発行事業者の登録有効性を確認する. 特定の取引日に事業者がインボイス発行資格を持っていたかを確認できる。 Args: number: 登録番号(T+13桁の数字、例: "T1234567890123") day: 確認日(YYYY-MM-DD形式、例: "2024-12-01") Returns: 指定日時点の登録状態(マークダウン)
search_invoice_by_name 会社名からインボイス登録番号を検索する. 法人番号APIで会社名を検索し、該当法人のインボイス登録状況を 自動で確認する。法人番号 → 登録番号(T+法人番号)の変換を 内部で行うため、登録番号を知らなくても検索できる。 ※ 個人事業主は法人番号を持たないため、このツールでは検索できません。 個人事業主の場合は登録番号(T+13桁)を直接指定して check_invoice_registration をご利用ください。 Args: name: 検索キーワード(会社名、部分一致) area: 地域名で絞り込み(都道府県名、例: "東京都") limit: 取得件数上限(デフォルト5、最大10) Returns: インボイス登録情報の一覧(マークダウン)
resolve_area 地域名から e-Stat の地域コードを検索する. 都道府県名の部分一致で検索可能。 「東京」→「東京都 (13000)」のように接尾辞なしでもマッチする。 Args: name: 地域名(例: "東京", "大阪府", "北海") Returns: マッチした地域名と地域コードの一覧
list_available_stats 利用可能な統計分野の一覧を表示する. search_statistics の stats_field パラメータに使えるコードの一覧。 Returns: 統計分野コードと名称の一覧
get_meta_info 統計表のメタ情報(分類コード体系)を取得する. 統計表にどのような次元(地域・時間・カテゴリ等)があるか、 各次元にどのようなコードが定義されているかを確認できる。 データ取得前の下調べに便利。 Args: stats_data_id: 統計表ID(search_statistics で取得) Returns: 分類オブジェクトの一覧(各次元のコード→名称マッピング)
get_population 地域の人口データを自動取得する(プリセット). 統計表IDを知らなくても、地域名を指定するだけで 人口推計や国勢調査から人口推移データを取得できる。 Args: area: 地域名(例: "東京都")または地域コード(例: "13000") Returns: 人口推移の整形済みレポート(マークダウン)
get_regional_profile 地域の総合プロファイルを自動取得する(プリセット). 人口・経済・労働など複数分野の統計データを自動検索・取得し、 1つのレポートにまとめる。地域の概要を素早く把握したいときに便利。 Args: area: 地域名(例: "東京都")または地域コード(例: "13000") Returns: 地域の総合プロファイル(マークダウン)
Permissions 3
network medium filesystem low env_vars low