Statfin Fi

statfin-fi

芬兰统计局（StatFin）—— Tilastokeskus 发布的芬兰官方统计数据完整目录，通过其 PxWeb API 提供：人口、教育、就业、消费价格、住房、健康和国民账户。

属于 Pipeworx——一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

工具	返回内容
subjects	StatFin 的主题树。path 为空时列出约 135 个主题文件夹；path: "vkour" 则列出该文件夹中的表格。type: "l" 的条目是文件夹，type: "t" 的条目是表格。
table_meta	单个表格的维度和所有有效值，可用于查看表格按哪些类别细分。
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 中返回；没有可靠总计值的维度会完整返回，而不会被静默折叠——如果默认维度对调用方不可见，就可能把错误数字当成正确数字。

如果某个值匹配多行，工具会返回所有匹配项，而不是任选其一，因此 {"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/
• 发布方：芬兰统计局 / Tilastokeskus — https://stat.fi/en
• 许可：知识共享署名 4.0 国际版（CC BY 4.0）

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

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

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/statfin-fi/mcp 返回上表中的工具，以及共享的 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