paris-compass-mcp

问题

你站在一间空店面前。Agent 说这条街很热闹。

Compass 会同时从六个维度给出答案。

每项数据都会附上来源、日期和置信度。

注意这里的措辞，产品也会保持一致：空气质量是实测的，噪声是建模估算的。噪声和人流量均为代理指标，屏幕上和本文中都会明确标注。

值得多说两句的三个问题

这里以前开过厨房吗？ 如果这里曾经是餐厅，排烟系统、隔油池和电力设施很可能都已配齐。否则，建这些设施要花上数万欧元，还需要得到楼宇管理方的同意。这是这份数据能回答的最昂贵的问题——也是你动身前就能问的问题。

这里是死气沉沉的街区，还是好地段？ 商铺不断更替的街道并不等于正在衰败：铺面可能换了店主，又重新开张。而更替率只有与该街区自身的行业情况，以及该街区本身相比才有意义——同一行业在不同街区的情况并不相同。Compass 根据三次普查衡量这两项指标。

这些数据没有在此列出。 它们基于 2017 年和 2020 年的数据版本，其许可尚未获批，服务端也不会向匿名调用者提供这些数据。本页面遵循与产品相同的规则：基于被扣留数据版本计算出的比率也会被扣留。

人们实际付了多少钱？ 自 2015 年以来，已有 25 661 笔商誉转让交易连同价格一并公布。在其中 5 971 笔与单个铺面相关的交易中，巴黎商铺 fonds 的转让价格中位数在 160 000 到 170 000 € 之间——这是一个区间，而非单一数值，因为商誉价格通常以整数申报：中位数落在一个档位上，并会跳跃变化，因此给出单一数字，反而会对来源数据不具备的精确度作出暗示。行业几乎决定了一切。

一个地址就能说明问题。在 10 rue Mandar，trace_premise 返回了 2017 至 2024 年间的六笔商誉转让交易，价格从 87 500 到 450 000 € 不等——检索日期为 2026 年 10 月 7 日。每一笔都标记为 probable，而非 established：这个门牌号对应两个铺面，而公告没有说明转让的是哪一家。2017 年和 2020 年的普查记录返回 withheld，2023 年的记录则返回 established。

数字如何获得一席之地

每个数字都附有来源、许可和日期——以及它的可信程度。

flowchart LR
    A["APUR BDCom<br/>3 censuses"] --> M["Address<br/>matching"]
    B["BODACC<br/>sales + insolvencies"] --> M
    C["INSEE Sirene<br/>establishments"] --> M
    M --> V{"Does the source<br/>name THIS unit?"}
    V -->|"names it directly"| E["established"]
    V -->|"two sources agree,<br/>neither names it"| F["corroborated"]
    V -->|"address shared by<br/>several shopfronts"| G["probable"]
    V -->|"source is silent"| H["undetermined"]
    E --> O["Every figure carries<br/>source · licence · vintage · method"]
    F --> O
    G --> O
    H --> O
    O --> UI["Map and unit file"]
    O --> MCP["MCP server,<br/>for an agent"]

四个等级，绝不用百分比。 以 100 分为满分的可信度评分，恰恰属于本产品拒绝提供的那种无法核实的数字。等级根据现有列计算得出，每一行都会附上产生该等级的原因。

截至 2026 年 10 月 6 日的语料库构成——这是质量指标；要提升质量，就要让以下四个数字逐步向左移动：

37.0% 是结构性问题，不是疏忽：BODACC 提供的是地址，BDCom 提供的是铺面，而 69% 的铺面与其他铺面共用门牌号。没有任何公开数据能指出八家铺面中究竟哪一家转让了。

在发布任何内容之前，质量门禁会对整个语料库运行 56 项不变量检查、24 个冻结基线和 8 条人工核验的时间线，之后还会按计划每天再次运行——截至 2026 年 10 月 6 日的不变量数量通过 grep -c '^-- @invariant ' eval/invariants.sql 统计。其中大多数检查函数的返回结果；有一项检查函数本身：暴露 observed 列的函数必须是 SECURITY DEFINER，因为行级安全策略会悄无声息地将被扣留的记录变成“从未调查过”。

上方的徽章统计的是不变量数量，并不表示质量门禁已通过。目前尚未解决的红色问题，均标记为 porte-rouge。

两项创立原则

大多数商业地产工具只描述房源——建筑面积、租金、照片——剩下的都留给你自行推断。Compass 不卖覆盖范围，也不卖颗粒度：它卖的是解读，而产品本身就是背景信息。

解读的价值取决于你能否核验。这个市场上的工具承诺提供基于审计数据的答案——这说的是谁核验过。Compass 承诺提供可根据注明出处的公开来源重新推导的数字——这说的是谁可以核验：你自己。内部审计是一种承诺。注明出处的来源则是任何人都能重新验证的测试，包括针对我们自己的测试。

如果一个数字无法根据注明出处的公开来源重新推导，就不会显示。

没有房东声明，没有抓取的房源信息，没有专有估算，也不会为了填补空缺而凭空编造评分。缺失的数据会显示为缺失——n/a，绝不会显示为 0。

如果同一条街上的两个单元得到相同的结论，Compass 就什么也没说。

有用的颗粒度是街道分段，有时甚至精确到人行道的某一侧。无法在这个尺度上变化的指标，只能描述一般背景信息，无法为决策定论。

适用对象

创业者——决定在哪里开店的店主、餐馆经营者、手艺人或加盟商。在职业生涯中，通常只会做一两次这样的决定，却要签下多年租约。

Agent——通过 MCP 服务提出同样问题的大模型。相同的评分核心，相同的可追溯性要求，输出形式不同：提供 JSON 和思维链，而不是地图。

**不适用于经纪人。**经纪人每个月要筛选数十处地点，需要投资组合、批量比较和全国覆盖。每一项都会让产品变得更复杂，不利于深入研究单个地址。两边都服务，结果就是两边都服务不好——想用 Compass 的经纪人能获得的，和 Agent 一样：API。

它拒绝提供什么

每一次拒绝，都能换回一些东西。关键就在于这种取舍。

状态

如实标注：这里的 已构建 表示代码可以运行且检查通过，并不表示已部署。

每个数字的来源

范围

首先覆盖巴黎市区，随后扩展至 Île-de-France。重深度而非广度：真正创造价值的数据源都来自本地。

技术栈

React 18 · TypeScript · Vite 5 · Tailwind + shadcn/ui · Leaflet（直接使用，不用封装）· TanStack Query · Supabase + PostGIS

src/core/ 是纯代码——不包含 fetch、React 或 DOM。因此，同一套评分逻辑可供浏览器、测试运行器和 MCP 服务使用。

git clone https://github.com/IvandeMurard/paris-compass.git
cd paris-compass
npm install
npm run dev

许可与署名

代码采用 Apache-2.0 许可。数据则不然。

这个区别比看起来更重要，尤其是在一个完全基于开放数据构建的产品中。该许可仅适用于本仓库中的内容——评分核心、数据导入管线和界面。它不授予对数据集的任何权利；每个数据集都遵循各自的条款：

BDCom 2017 和 2020 完全不可再分发。 它们的许可与 2023 版不同，因此数据库会按每个版本记录 publicly_redistributable 标记，并对匿名调用者隐藏其内容——内容和缺失状态都会一并隐藏，以免泄露任何信息。

本仓库不包含任何数据摘录，也不得包含。这里存放的是用于获取、建模和引用数据的代码。

由 Ivan de Murard 制作。

对这种方法或 MCP 层感兴趣？请提交 issue。