Sentinelle syndic FR

Sentinelle syndic：法国公寓物业管理方与委托期限结束日期 MCP 服务

面向 AI Agent 的 MCP 服务和按次付费 API。 数据来自法国官方公寓物业登记系统（ANAH，约 656,000 个公寓物业），可查询公寓物业的管理方及其委托期限结束日期，并列出某个城市、邮政编码、行政区或管理方业务组合中即将到期的公寓物业。

• MCP 端点（可流式传输的 HTTP）： https://syndic.amacunia.fr/mcp
• REST 端点： GET https://syndic.amacunia.fr/v1/syndic?immatriculations=AA0581645 和 GET https://syndic.amacunia.fr/v1/syndic/echeances?commune=44109&type_syndic=professionnel
• 免费示例： https://syndic.amacunia.fr/v1/exemple
• Agent 文档： https://syndic.amacunia.fr/llms.txt
• 价格： 对 1 到 50 个公寓物业的查询，每次调用收费 0.01 USDC；对区域列表（最多 100 个公寓物业）的查询，每次调用收费 0.03 USDC，通过 Base 上的 x402 协议支付。无需账户、API 密钥或订阅。免费试用：每位调用者每天可在 /v1/syndic 上免费调用 3 次。
• 官方 MCP 注册表： io.github.Marcoco27/sentinelle-syndic

项目缘起

每个法国公寓物业（copropriété）都必须登记在由法国国家住房署（Agence nationale de l'habitat）运营的国家登记系统中（《建筑与住房法典》第 L711-1 条）。其管理方 syndic 必须在其中申报委托期限。委托期限最长为 三年（1967 年 3 月 17 日第 67-223 号法令第 28 条）；期限结束前，业主大会会续聘原管理方或选聘新的管理方。

想在业主大会召开前竞标的物业管理公司、楼宇保险公司、承包商和房地产软件供应商，都需要了解哪些委托期限何时结束。登记系统虽然公开，但数据只有一个大型每日文件。本服务会为其建立索引，并通过一次调用返回结果。

工具

工具	价格	功能
syndic_lookup	0.01 USDC（x402）	查询 1 到 50 个公寓物业（登记编号）的当前专业管理方、SIRET、委托期限结束日期和状态
syndic_echeances	0.03 USDC（x402）	查询某个区域内委托期限将在指定日期范围内结束的公寓物业（默认未来 180 天），每次最多返回 100 个，按结束日期排序
syndic_example	免费	实际响应示例（南特的一处公寓物业，以及南特列表的摘录；计算日期为 2026-11-09），可用于查看输出格式

syndic_lookup 的输入： immatriculations，1 到 50 个登记编号（两个字母，七位数字），以逗号分隔。

syndic_echeances 的输入： 从 commune（INSEE 代码）、code_postal、departement 或 siret_syndic（管理方的业务组合）中选择一个区域；可选参数包括 apres、avant（日期范围，最长两年）、type_syndic（professionnel、bénévole）、lots_min、decalage（分页）。无效输入会被拒绝，且不会收费。

输出示例

南特一处有 421 个房间的公寓物业，其管理方的委托期限将于 2026 年 11 月 13 日结束。

{
  "date_calcul": "2026-11-09",
  "mandats_finissant_sous_90_jours": 1,
  "resultats": [{
    "immatriculation": "AA0581645",
    "trouvee": true,
    "copropriete": {
      "nom_usage": "NAMET C",
      "commune": "Nantes",
      "code_insee": "44109",
      "lots_total": 421,
      "periode_construction": "De 1949 à 1974",
      "type_syndic": "professionnel",
      "syndic": "AMARA GESTION",
      "siret_syndic": "95150146900013",
      "date_fin_mandat": "2026-11-13",
      "jours_avant_fin_mandat": 4,
      "statut": "echeance_dans_90_jours",
      "date_derniere_mise_a_jour": "2026-10-17"
    }
  }],
  "donnees": { "millesime": "2026-11-07", "adresse": "https://www.data.gouv.fr/datasets/62da71c068871f4c54258c7c/" },
  "source": "Registre national d'immatriculation des copropriétés, ANAH, data.gouv.fr (Licence Ouverte 2.0) ; art. L. 711-1 du code de la construction et de l'habitation",
  "avertissement": "Information, pas un conseil juridique. Les données sont déclarées par le syndic au registre…"
}

字段名称为法语。statut 的取值包括 mandat_en_cours、echeance_dans_90_jours、echeance_depassee_fiche_a_mettre_a_jour、echeance_depassee_successeur_declare、echeance_depassee_sans_mandat_declare、aucune_date_de_fin_declaree。

连接

任何 MCP 客户端都可以连接并调用 syndic_example。调用付费工具时会返回 x402 需要付款 响应：客户端必须支持 x402 付款才能支付（见下文）。

Claude Code

claude mcp add --transport http sentinelle-syndic https://syndic.amacunia.fr/mcp

Claude Desktop / claude.ai： 依次打开“设置”“连接器”“添加自定义连接器”，并输入 URL https://syndic.amacunia.fr/mcp。

Cursor（~/.cursor/mcp.json）

{ "mcpServers": { "sentinelle-syndic": { "url": "https://syndic.amacunia.fr/mcp" } } }

VS Code（.vscode/mcp.json）

{ "servers": { "sentinelle-syndic": { "type": "http", "url": "https://syndic.amacunia.fr/mcp" } } }

使用 x402 付款

付费工具遵循 x402 MCP 约定：首次调用会返回付款要求（scheme exact、网络 Base eip155:8453、资产 USDC、金额 10000 = 0.01 USDC 或 30000 = 0.03 USDC）；客户端对付款进行签名，将其放入请求 _meta 中的 x402/payment，然后再次调用。只有工具成功时才会结算付款：无效输入不会被收费。

使用官方 x402 SDK 的最简 Python 客户端见 examples/pay_mcp.py。同一服务也通过普通 HTTP 提供（GET /v1/syndic 和 GET /v1/syndic/echeances，先返回 HTTP 402，再重试），所有 x402 HTTP 客户端均支持这种方式。

数据与限制

• 来源：Registre national d'immatriculation des copropriétés，Agence nationale de l'habitat (ANAH) 发布于 data.gouv.fr，采用 Licence Ouverte 2.0 (Etalab)，每日更新。
• 数据由管理者自行申报：过去的任期结束日期可能意味着记录已过时，而非公寓楼没有管理者；statut 字段会说明记录显示的是哪种情况。
• 仅列出专业管理者（公司）。登记处不公布志愿管理者的身份，也不会返回其身份信息。不返回或存储任何个人数据。
• 仅供参考，不构成法律建议。

同一作者

• Sentinelle créances：按公司提供法国破产通知以及债权申报截止日期。
• Sentinelle catnat：按市镇提供法国自然灾害法令以及保险索赔申报截止日期。

关于此代码仓库

此代码仓库包含公开文档、MCP Registry 清单（server.json）和客户端示例。服务本身运行于 syndic.amacunia.fr。欢迎提交问题或提问；联系邮箱：[email protected]。

---

法语版

面向 AI Agent 的 MCP 服务和按次付费 API：依据公寓楼国家登记册（Anah），逐一提供当前在任的专业管理者及其任期结束日期，并列出某个市镇、邮政编码、部门或某位管理者的业务组合中，任期即将结束的公寓楼。每条记录收费 1 美分，每份清单收费 3 美分（x402 协议，Base 上的 USDC）。仅供参考，不构成法律建议。介绍页面：https://syndic.amacunia.fr