mcp-dutch-rental-listings

荷兰租房房源 MCP 服务

这是一个用于 Apify 上 Mamba Labs 荷兰租房房源 Actor 的 MCP 服务。它提供去重后的荷兰租房房源列表，并标注是否可以登记户籍。

内容

• 功能介绍
• 快速开始
• 前置条件
• 示例提示词
• 工具
• 输入项
• 定价
• Actor 完整文档
• 许可证

功能介绍

输入荷兰的某座城市、省份或整个国家。Actor 通过普通 HTTP 读取 Kamernet、HousingAnywhere 和 11 家反蹲租赁中介的网站，将数据合并为一个不重复的列表，并返回租金、面积、房屋类型、是否可以登记户籍及证明句、隐藏原因，以及每条房源的首次发现和最后发现时间。不涵盖 Pararius、Huurwoningen、Funda 或 Gapph。

所有工作都在 Apify 上运行。此软件包是一个轻量客户端，用于启动 Actor 运行、等待运行完成，并返回数据集行。

快速开始

需要 Node.js 18 或更高版本，以及一个带有 API 令牌的 Apify 账户。

将以下内容添加到 Claude Desktop 配置文件（claude_desktop_config.json）、Cursor 或任何 MCP 客户端中：

{
  "mcpServers": {
    "mamba-dutch-rental-listings": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-dutch-rental-listings"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

重启客户端。随后会显示 search_dutch_rental_listings 工具。

前置条件

• Node.js 18 或更高版本。
• 从 console.apify.com/account/integrations 获取 Apify API 令牌，并设置为 APIFY_TOKEN。即使没有令牌，服务也会列出其工具；但调用工具时需要令牌。

示例提示词

• “查找乌得勒支每月租金低于 800 欧元的房间。”
• “列出自上次搜索以来北荷兰省新增的反蹲租房源。”
• “显示阿姆斯特丹可以办理市政登记的单间公寓。”

工具

search_dutch_rental_listings。共 1 个工具。示例参数：

{
  "location": "Utrecht",
  "sources": [
    "kamernet",
    "housinganywhere"
  ],
  "maxResults": 20
}

输入项

Actor 面向房源买家的所有输入项。省略的输入项将采用 Actor 自带的默认值。

输入	类型	必填	描述
location	string	否	荷兰城市（Kamernet 收录的 212 个城市，例如 Utrecht 或 Den Haag）、省份（格式为 province:noord-holland），或表示整个国家的 netherlands。若名称既是城市名又是省份名（Utrecht、Groningen），则按城市处理。
radiusKm	number	否	仅适用于 Kamernet：同时搜索城市周边此范围内的房源。可选值为 0、1、2、5、10（默认值）或 20；其他值向上取整。HousingAnywhere 和各中介仅搜索城市本身。
sources	array	否	kamernet、housinganywhere、antisquat_agencies（11 家荷兰反占屋中介网站）。默认：全部三项。
propertyTypes	array	否	仅保留以下类型：room、studio、apartment、house、anti-squat、student-residence、other。空数组表示全部保留。
maxResults	number	否	返回的房源数量，按收费行计。默认值为 50。
maxRent	number	否	排除租金高于此值的房源。未注明租金的房源会保留。
minSize	number	否	排除面积小于此值的房源。未注明面积的房源会保留。
minRooms	number	否	排除房间数少于此值的房源。Kamernet 仅在详情页注明房间数，因此需将 includeDetails 设为 true 才能在该平台使用此条件。
furnished	array	否	仅保留以下状态：furnished、unfurnished、uncarpeted。未注明状态的房源会保留。
registrationOnly	boolean	否	true：仅保留文本或所列字段注明可办理市政登记的房源（registration_status yes、listed_yes 或 flag）。需将 includeDetails 设为 true 才能检查文本。
availableBy	string	否	YYYY-MM-DD。排除在此日期之后才可入住的房源。未注明日期的房源会保留。
hasInternet	string	否	Kamernet 自带的筛选条件，会随搜索一并发送。
privateBathroom	string	否	Kamernet 自带的筛选条件。
privateKitchen	string	否	Kamernet 自带的筛选条件。
privateToilet	string	否	Kamernet 自带的筛选条件。
petsAllowed	string	否	Kamernet 自带的筛选条件。
smokingAllowed	string	否	Kamernet 自带的筛选条件。
numberOfPeople	string	否	Kamernet 自带的筛选条件：1 至 5 位租户。
tenantGender	string	否	Kamernet 自带的筛选条件：male 或 female。
tenantAge	number	否	Kamernet 自带的筛选条件：你的年龄（岁），范围为 16 至 99。
roommatesMax	string	否	Kamernet 自带的筛选条件：none、up_to_4 或 up_to_8。
roommateGenders	array	否	Kamernet 自带的筛选条件：male、female、mixed。
landlordTypes	array	否	Kamernet 自带的筛选条件：private、agent。
includeDetails	boolean	否	true：读取每个返回房源的详情页，获取完整文本、房屋规则、中介类型、押金，以及基于文本的登记和隐藏规则。每读取一个页面都会收费。默认值为 false。
includeLandlordName	string	否	true：添加房东的显示名称。默认关闭，因为 Kamernet 上的大多数房东都是个人。
blockedLandlordIds	array	否	房东账号 ID（landlord_id）；这些房东的房源将作为免费的 hidden_listing 行返回，而非收费行。
excludeGenderOnly	boolean	否	true：若房源文本将租户限制为某一性别，则将其作为免费的 hidden_listing 行返回，并附上匹配的句子。false：正常返回，并在 hide_reasons 中注明原因。
excludeLanguageOnly	boolean	否	true：若房源文本将租户限制为荷兰语或波兰语使用者，则将其作为免费的 hidden_listing 行返回。
excludeStudentOnly	boolean	否	true：若房源文本将租户限制为学生，则将其作为免费的 hidden_listing 行返回。
excludeShortStay	boolean	否	true：若房源文本或所列最长租期少于 3 个月，则将其作为免费的 hidden_listing 行返回。
trackChanges	boolean	否	true（默认值）：在你自己的 Apify 账号中的命名键值存储中，保留此搜索的首次发现和最后发现时间，以便后续运行标记新增和过期的房源。
draftMessages	boolean	否	true：使用你自己的模型密钥和 applicantProfile，为每位房东撰写首条消息。此选项会启用 includeDetails。需要 llmApiKey；未提供时，运行将失败并显示普通错误。
llmProvider	string	否	openai（默认值）、anthropic、gemini 或 groq。仅在启用 draftMessages 时使用。
llmApiKey	string	否	你为上述提供商准备的密钥。密钥只会发送给该提供商，不会被存储或记录，也不会发送给模型。
llmModel	string	否	你所用提供商的模型名称。留空时使用 gpt-4o-mini、claude-haiku-4-5-20251001、gemini-2.5-flash 或 llama-3.3-70b-versatile。
applicantProfile	string	否	用于撰写草稿的个人信息，可采用 JSON 格式，例如 {"name": "Sam", "age": 29, "work": "software engineer", "move_in": "2026-12-01", "contact": "[email protected]"}，也可使用纯文本行。模型只会转述这些信息。
maxDrafts	number	否	单次运行最多撰写的消息数。默认值为 20。
max_charge_usd	string	否	可选。运行会在即将产生的费用超过此金额前停止。始终返回免费行。

定价

在 Apify 上按事件付费，费用计入你的 Apify 账户。价格以美元计。

事件	免费计划	Bronze	Silver	Gold
listing-row，一个房源	$0.0011	$0.001045	$0.00099	$0.000935
detail-page，读取一个详情页，启用 includeDetails 时	$0.002	$0.0019	$0.0018	$0.0017
message-draft，使用你自己的密钥起草一条消息，启用 draftMessages 时	$0.003	$0.00285	$0.0027	$0.00255
apify-actor-start，每次运行启动	$0.012	$0.012	$0.012	$0.012

隐藏的房源、来源状态行、起草失败以及被拒绝的输入均免费。Mamba Labs 承担运行的平台费用。Mamba Labs 承担运行的平台费用，包括 Apify 代理流量。

Actor 完整文档

apify.com/mambalabs/dutch-rental-listings

许可证

MIT。请参阅 LICENSE。