logo

PAP 法国个人房源采集

按地区、交易类型和筛选条件采集法国个人房源的标价、户型、联系方式、能耗等级、周边交通与照片,逐条输出可核对的房源记录。

发布者
近 30 天成功率
—
最近更新
2026-11-20

概览

在法国找房时,价格、户型、能耗和联系方式往往分散在列表页与详情页,同一套房源要来回核对好几遍。这个应用把公开展示的个人房源整理成一行一条的记录:既有标价、房间数、面积等基本条件,也有公开电话、能源等级、周边交通和房源照片,看一行就能判断这套房值不值得继续跟进。

与手工复制相比,每条记录都带有稳定的房源编号和取数时间,同一套房源在不同批次里可以被认出来并去重。出售、长期出租和度假短租三种房源都能按地区整理,适合需要持续跟踪某一片区房源变化,而不是只查一次价格的人。

数据说明

记录来自公开展示的房源列表与对应的详情页,按搜索结果顺序整理,并以房源编号去重,同一套房源只保留一行。标价为页面展示的原始价格文本,金额单位为欧元,原文中的点号是千分位分隔;价格数值是把标价解析后的欧元数字,便于排序和分档。发布日期按页面原文保留,可能是法语月份写法;采集时间是本次取数时刻,采用带时区的时间表示,两条时间含义不同。

公开电话只收录页面主动展示的号码,不提供邮箱地址;可发消息为是,只表示房源留了站内联系入口。能源等级和排放等级是页面标注的字母,页面没有标注时留空。已下架房源、需要登录才能查看的内容,以及页面根本没有展示的字段不在结果里;部分房源的详情页信息不全,会用详情状态标出,此时详情专属字段为空。度假短租房源不展示电话。每条记录反映取数当时页面展示的内容,不是历史价格或历史状态的回放。

结果长什么样

每条记录就是一套房源。

房源编号房源标题标价房型参考号能源等级
462602186Paris 5e565.000 €AppartementG26/2186F
462601874Lyon 7e389.000 €AppartementG26/2041D
462598310Strasbourg (67)745.000 €MaisonG26/1877C

此外还有价格数值、房间数、卧室数、房源特征、公开电话、周边交通、排放等级、房源照片、详情地址、详情状态、采集时间等字段。

应用场景

做区域比价时,把价格数值和房源特征放在一起按面积分档,可以看出同一片区相近条件的房源集中在什么价位,为自己的报价找到参照。

筛掉不合适的房源时,结合房间数、卧室数、能源等级和排放等级,先排除面积不符或能耗偏高的条目,再看详情状态是否完整,避免把信息缺失的房源误当成合格候选。

准备跟进清单时,用公开电话、可发消息、房源标题和详情地址整理可联系的房源名单,并用房源编号在不同批次之间比对,识别新出现和已消失的房源。

评估通勤条件时,用纬度、经度和周边交通查看房源与站点的关系,再配合房源照片判断是否有必要安排实地看房。

输入参数

调用本 Data App 需要传入的参数。

  • 交易类型product必填string(enum)
    选择要采集的房源类型:出售、长期出租或度假短租。不同交易类型可用的筛选条件不同,选错会导致结果为空。
    可选值出售vente长期出租location度假短租vacances示例vente
  • 目标地区locations必填array<string>
    填写一个或多个法国地区,例如 Paris (75)、Lyon 7e、75005 或 France。地区写法不明确时结果可能为空,填写参考号时本项可留空数组。
    数量最多 10 项示例["Paris (75)"]
  • 最多返回条数maxResults必填integer
    本次运行最多写入的房源记录数,可填 1 到 1000。数值越大运行越久,实际返回条数可能因筛选而略少。
    范围1–1000示例5
  • 严格限定地区strictLocation选填boolean
    开启后会尽量剔除平台自动补充的邻近地区房源。默认 false,即保留邻近地区结果;对全省或全国范围的搜索不起作用。
    默认值false
  • 房源参考号reference选填string
    填写已知的房源参考号可直接定位单条房源,例如 G26/2186。留空表示按目标地区搜索。
    默认值
  • 仅看新房newOnly选填boolean
    开启后只保留出售类型中的新建房源。默认 false,即不区分新旧;仅对出售类型有效。
    默认值false
  • 房源类型propertyTypes选填array<string>
    按房源类型筛选,例如 appartement、maison、terrain、garage。默认空数组,即不限制类型。
    数量最多 10 项默认值
  • 附加条件tags选填array<string>
    按房源特色筛选,例如 ascenseur、balcon-terrasse、piscine。默认空数组,即不限制特色。
    数量最多 15 项默认值
  • 最少房间数nbPiecesMin选填integer
    房源的最少房间数。默认 0,表示不限制下限。
    范围0–50默认值0
  • 最多房间数nbPiecesMax选填integer
    房源的最多房间数。默认 0,表示不限制上限。
    范围0–50默认值0
  • 最少卧室数nbBedroomsMin选填integer
    房源的最少卧室数。默认 0,表示不限制下限。
    范围0–50默认值0
  • 最多卧室数nbBedroomsMax选填integer
    房源的最多卧室数。默认 0,表示不限制上限。
    范围0–50默认值0
  • 最低价格priceMin选填integer
    房源价格下限,单位为欧元。默认 0,表示不限制下限。
    范围0–100000000默认值0
  • 最高价格priceMax选填integer
    房源价格上限,单位为欧元。默认 0,表示不限制上限。
    范围0–100000000默认值0
  • 最小室内面积surfaceMin选填integer
    室内面积下限,单位为平方米。默认 0,表示不限制下限。
    范围0–100000默认值0
  • 最大室内面积surfaceMax选填integer
    室内面积上限,单位为平方米。默认 0,表示不限制上限。
    范围0–100000默认值0
  • 最小土地面积landSurfaceMin选填integer
    土地面积下限,单位为平方米。默认 0,表示不限制下限。
    范围0–10000000默认值0
  • 最大土地面积landSurfaceMax选填integer
    土地面积上限,单位为平方米。默认 0,表示不限制上限。
    范围0–10000000默认值0
  • 可住人数capacity选填integer
    度假短租房源的入住人数。默认 0,表示不限制;仅对度假短租类型有效。
    范围0–50默认值0
  • 入住日期stayStart选填string
    度假短租的入住起始日,格式为 YYYY-MM-DD。留空表示不指定日期;仅对度假短租类型有效。
    默认值
  • 退房日期stayEnd选填string
    度假短租的退房日期,格式为 YYYY-MM-DD。留空表示不指定日期;不得早于入住日期。
    默认值

输出数据

单条记录的字段结构。

  • 房源编号listingIdstring
    房源的稳定编号,取自详情页链接,同一房源在不同次采集中保持不变,可用于去重。
    示例462602186
  • 参考号referencestring
    房源在平台上展示的参考编号;未展示时为空。
    示例G26/2186
  • 交易类型productstring
    本次房源所属的交易类型:出售、长期出租或度假短租。
    示例vente
  • 房型代码propertyTypestring
    归一化后的房源类型标识,便于按类别分组统计。
    示例appartement

价格

条房源记录

按实际成功返回的数据条数计费,任务失败不计费。

¥0.03/ 条

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即运行

用你填写的参数真实运行一次,按价格计费。

调用方式

通过 MCP 可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。

已接入八爪鱼 Data Hub?直接在对话里用

不用再配置。复制下面这句话发给你的 AI,在后面接着写你要做的事:

用 “海色心情/pap-immobilier-listings” 这个 Data App,帮我:这里写你想要用这个 Data App 做的事情。

还没接入过?用下面任一方式配置一次,之后所有 Data App 都能直接用。

客户端配置

把 YOUR_API_KEY 替换为你自己的 API Key 即可,各类客户端与 CI、无浏览器环境通用。获取 API Key →

mcpServers 配置
{
  "mcpServers": {
    "bazhuayu_datahub": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

让 AI 自己完成配置

不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。

注意事项

适用边界

每次运行最多返回 1000 条公开展示的房源记录;只覆盖平台可公开浏览的出售、长租与度假房源,不提供登录后可见的私有信息。

不适用

  • 需要实时成交价、历史价格走势或官方评估价时,应使用专门的交易数据服务。
  • 需要中介机构内部房源、联系人邮箱地址或登录后数据,本应用不覆盖。
  • 只需要一个即时的是否在售判断,适合用更轻量的查询应用。

运行与取消

本应用异步运行,可以中途取消;取消前已返回的结果保留,照常计费。

失败处理

通过 MCP 接入时,AI 会自动读到以下说明;通过 API 或 SDK 接入时,请在代码里按此处理。

  1. 1结果为空时先确认地区写法、交易类型与价格区间是否过窄,再放宽条件重试;访问被拦截导致的空结果不能当作该地区没有房源。
  2. 2同一地区改变筛选条件后重新运行即可,重复房源按房源编号自行去重。
  3. 3部分房源的详情页信息不完整,结果中会标记详情状态,按该标记决定是否纳入后续分析。

常见问题

怎么收费?

按条计费 ¥0.03 / 条;任务失败不计费。详见价格 →

一次能采多少?有什么限制?

每次运行最多返回 1000 条公开展示的房源记录;只覆盖平台可公开浏览的出售、长租与度假房源,不提供登录后可见的私有信息。详见注意事项 →

能在 AI 助手或 Agent 里用吗?

能。接入一次八爪鱼 Data Hub,就能在对话里按名字调用全部 Data App,包括本应用 海色心情/pap-immobilier-listings。详见调用方式 →

¥0.03 / 条