France Dvf

@pipeworx/france-dvf

法国官方房产转让价格记录——由公共财政总局（DGFiP）发布的“Demandes de valeurs foncieres”（DVF）——涵盖每笔登记的销售（以及少量其他转让类型），包括价格、市镇、地块、房产类型、面积和坐标。Fleet #2935。

属于 Pipeworx 的一部分——一个将 AI Agent 连接到 1773+ 个实时数据源的 MCP 网关。这是一个独立、非官方的集成，与上游提供方无关联，未获其认可，也非由其发布。

DGFiP 每年 4 月和 10 月各发布一次滚动五年范围的 DVF 批量数据，而非提供 API，因此 Pipeworx 也按同样的半年周期刷新数据副本。底层文件不包含个人姓名——数据精确到地址和地块，而非个人。

工具

• fr_property_sales(commune?, postcode?, from?, to?, type?, limit?, offset?) — 列出某个市镇（5 位 INSEE 代码或名称，例如 "75111" 或 "Lyon"；名称会匹配所有以其开头的市镇，因此 "Lyon" 会返回所有 9 个里昂区的销售记录）和/或邮政编码对应的已登记交易，并可选按日期范围和房产类型筛选。每条结果是一项转让记录（一笔交易中的特定地块/单元）。
• fr_property_sale(id) — 根据 id_mutation（来自 fr_property_sales 的结果）查询一笔交易（“mutation”），返回其包含的所有地块/单元，以及共同的交易价格、日期和性质。
• fr_property_stats(commune, year) — 查询某个市镇某年的每平方米价格中位数和平均值，按房产类型（Maison/Appartement）分类，并返回交易总数。若市镇名称匹配多个市镇（例如 "Saint-Martin"，或像 "Lyon" 这样未指定区名、且包含多个区的城市名称），则返回候选列表而非数值；请传入一个 INSEE 代码以消除歧义。

每条响应都包含 data_as_of（已加载数据副本的发布日期）、source、licence 和 coverage_note。

为什么每平方米价格仅根据单地块销售计算

valeur_fonciere 是整笔交易的总价，而非单个地块的价格——一笔销售可能包含多个单元（例如，一栋房子加一个车库，或同一份契约中的多套公寓）。用这个总价除以一个地块的面积，会导致每平方米价格被错误计算且不易察觉。因此，fr_property_stats 仅根据恰好包含一个已登记单元、房产类型为住宅（Maison/Appartement）且建筑面积为正数的交易计算每平方米价格。 fr_property_sales 和 fr_property_sale 不做此类筛选——它们会返回每笔已登记的转让记录，每条记录都包含 single_lot_sale，调用方可自行应用相同的筛选条件。

市镇匹配

传入 5 位 INSEE 市镇代码即可精确匹配。名称按前缀进行不区分大小写的匹配（"Lyon" 会匹配 "Lyon 1er Arrondissement" 到 "Lyon 9e Arrondissement"，也会匹配 "Lyons-la-Foret"；后者是一个名称恰好具有相同前缀的不同市镇）——匹配不会折叠重音符号，因此带重音的名称应保留重音输入，或改用 INSEE 代码查询。

认证

无需密钥。这些工具仅通过 Pipeworx 网关响应，数据副本由网关持有；单独执行 npm install 没有可读取的数据，并且每个工具都会在该环境中明确抛出“not bound in this runtime”错误，而不是返回空列表。

数据源

• DGFiP，Demands de valeurs foncieres (DVF) — 滚动发布的五年批量数据，每年更新两次（4 月／10 月）。涵盖法国本土和海外省，不包括 Alsace（省份 67、68）、Moselle（57）和 Mayotte（976），这些地区使用单独的土地登记册（Livre foncier），不在本次发布范围内。

许可：Licence Ouverte / Open Licence v2.0 (Etalab) — 可免费再利用，包括商业用途，但须遵守以下两项条件，本软件包将确保遵守：

1. 不得利用这些数据间接重新识别交易相关个人的身份。
2. 不得让外部搜索引擎将这些数据编入索引。

本软件包只通过 MCP 工具调用向网关请求记录，不提供可供搜索引擎编入索引的可抓取列表页；底层文件不含姓名，因此调用方看到的内容与发布方已公开的地址和地块级详情完全相同，不会更多。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/france-dvf/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 的共享元工具 — ask_pipeworx、discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于本表所列：目前，单个软件包端点除了列出软件包自身的工具，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是当天情况的权威依据。

这是有意为之，并非意外进行多路复用。元工具使限定范围的连接能够通过 ask_pipeworx 跨整个目录进行路由，从而回答本软件包未涵盖的问题，无需你再添加第二个 MCP 服务。目前无法挂载不带这些元工具的软件包端点；如果额外的 schema 占用的上下文多于路由带来的价值，请连接一次完整网关，而不是连接多个软件包端点。

也可以连接完整的 Pipeworx 网关，直接列出所有软件包的工具，而不只是本软件包的工具：

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

两个 URL 都会连接到同一个网关和相同的 1773+ 个数据源。唯一的区别是，哪些软件包的工具会被直接列出；从任一端点都可以通过 ask_pipeworx 访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/fr_property_sales \
  -H 'Content-Type: application/json' \
  -d '{"commune":"75111","from":"2025-01-01","to":"2025-12-31"}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/fr_property_sales。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行 — 无需 Pipeworx 账户，也不必往返网关：

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

也可以直接运行，以确认服务能够启动：

npx -y @pipeworx/mcp-france-dvf

它通过 stdin/stdout 使用 MCP，并且仅为本软件包的工具响应 initialize/tools/list/tools/call — 不包含上述网关连接提供的任何共享元工具。数据源相同，工具相同，但没有 ask_pipeworx 路由。

与 ask_pipeworx 配合使用

你也可以用通俗英语提问，而不必直接调用工具 — 软件包端点和完整网关都支持此方式：

ask_pipeworx({ question: "your question about France Dvf data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档与指南
• pipeworx.io

许可证

MIT