Statfin Fi

statfin-fi

Statistics Finland（StatFin）— Tilastokeskus が公開するフィンランドの公式統計の全カタログです。PxWeb API を通じて、人口、教育、雇用、消費者物価、住宅、健康、国民経済計算を提供します。

Pipeworx の一部です。AI エージェントを1683以上のライブデータソースに接続する MCP ゲートウェイです。

ツール

ツール	返される内容
subjects	StatFin の主題ツリーです。path が空の場合は約135個の主題フォルダーを一覧表示し、path: "vkour" の場合はそのフォルダー内の表を一覧表示します。type: "l" の項目はフォルダー、type: "t" の項目は表です。
table_meta	1つの表の次元と、各次元で有効な値をすべて返します。表の内訳を確認したい場合に使います。
query_table	実際の数値です。select に平易な英語で指定するとコードを自動解決します。body を指定すると、PxWeb クエリをそのまま渡します。

表のパス

表のパスは <folder>/<id>.px です。id は 4文字の表コードのみ です。

vkour/15ig.px      Population aged 15 or over by level of education, gender, age and origin
khi/11xs.px        Consumer price index

長い形式の statfin_<folder>_pxt_<id>.px は、古い StatFin ドキュメントのあちこちに記載されています。この形式は上流で廃止され、現在はどの表でも 400 エラー を返します。このパックは現在の形式に書き換えるため、ドキュメントに記載されているものの使えないパスで呼び出してもデータを取得できます（fleet #497）。

平易な英語での指定

select は、英語のラベルまたはネイティブコードを使って次元と値を対応付けます。query_table は、表自体のメタデータを参照して両方を解決します。

{ "path": "vkour/15ig.px", "select": { "Information": "tertiary level qualification" } }

→ 1672232 人の15歳以上のフィンランド人が高等教育の資格を取得しています（2025年）。対応する割合は 34.5% です。

指定されていない次元は自動的に補完されます。年は最新の公表年が既定値になり、StatFin が合算できる次元は合計値に集約されます。また、明示的な合計値（SSS、Total、または年齢の 15- のように表独自の下限から始まる上限のない範囲）がある次元では、その値が使われます。これらの選択はすべて selection_resolved に返されます。妥当な合計値がない次元は、暗黙に集約せず全件返されます。既定値にされた次元が見えない状態では、誤った数値を正しいものとして受け取ってしまう可能性があるためです。

複数の行に一致する値が指定された場合は、どれか1つを選ぶのではなく、すべて返されます。そのため、{"Information": "tertiary level qualification"} は人数と割合の両方を返します。一致する行が20件を超える場合は、指定が広すぎることが報告されます。

結果には figures も含まれます。最大60セルの結果について、json-stat2 の value[] 配列と次元ラベルを組み合わせたものです。こちらのほうが読みやすい形式です。json-stat2 のフラットな配列は、暗黙的な直積に基づいているためです。

次元コードはフィンランド語のネイティブコードです

/en/ エンドポイントでも次元 コード はフィンランド語で、一部のラベルは翻訳されていません。コードを推測する方法はありません。これを補うのが select です。自分で body を渡す場合は、事前に table_meta を確認する必要があります。 vkour/15ig.px の場合：

コード	意味	合計値
ikaryhma_10_20180101	年齢	15-（SSS ではありません）
sukupuoli_9_20180101	性別	SSS
syntypera_101_20180101	出自（ラベルは Syntyperä と表示されます）	SSS
timeperiod_y	年	—
contentscode	指標。例：kaste5T8 = 高等教育資格を持つ人口	—

実行例 — 2024年の、高等教育資格を持つ15歳以上の人口：

{
  "path": "vkour/15ig.px",
  "body": {
    "query": [
      { "code": "ikaryhma_10_20180101", "selection": { "filter": "item", "values": ["15-"] } },
      { "code": "sukupuoli_9_20180101", "selection": { "filter": "item", "values": ["SSS"] } },
      { "code": "syntypera_101_20180101", "selection": { "filter": "item", "values": ["SSS"] } },
      { "code": "timeperiod_y", "selection": { "filter": "item", "values": ["2024"] } },
      { "code": "contentscode", "selection": { "filter": "item", "values": ["kaste5T8"] } }
    ],
    "response": { "format": "json-stat2" }
  }
}

→ value: [1641336]、表の更新日：2026-06-18。

認証

不要です。キーも登録も不要で、レート制限用のキーもありません。Cloudflare のエグレスからアクセスできます。

データソース

• API ルート：https://pxdata.stat.fi/PXWeb/api/v1/en/StatFin
• ポータル：https://pxdata.stat.fi/PxWeb/pxweb/en/StatFin/
• 公開元：Statistics Finland / Tilastokeskus — https://stat.fi/en
• ライセンス：Creative Commons Attribution 4.0 International（CC BY 4.0）

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "statfin-fi": {
      "url": "https://gateway.pipeworx.io/statfin-fi/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/statfin-fi/mcp の tools/list は、上記の表にあるツールに加えて、共有の Pipeworx メタツールである ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツールも返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールとともに、共有ツールがおよそ30個表示されます。接続の initialize レスポンスに正確な範囲が記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な仕様であり、偶発的な多重化ではありません。メタツールを使うことで、このパックが扱わない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を通じて回答できます。MCP サーバーを追加で接続する必要はありません。現時点では、メタツールを含めずにパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利便性を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ1683以上のデータソースに接続します。違いは、どのパックのツールが直接表示されるかだけです。どちらからでも、ask_pipeworx を使えばすべてのツールにアクセスできます。

MCP クライアントがありませんか？HTTP で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/statfin_fi_subjects \
  -H 'Content-Type: application/json' \
  -d '{"path":""}'

最初の呼び出しにアカウントは不要です。ツールを調べるには、GET https://gateway.pipeworx.io/v1/tools/statfin_fi_subjects を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "statfin-fi": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-statfin-fi"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-statfin-fi

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールを使用できますが、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは、上記のパックエンドポイントでもフルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Statfin Fi data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT