mcpField
R
Realty_in_us

Realty_in_us

本地服务
github.com/BACH-AI-Tools商业与营销047 周前更新

关于 Realty_in_us

Realty_in_us 是用于访问 Realty In Us API 的 MCP 服务,为客户端提供房源、经纪人、地点、金融利率和抵押贷款相关工具,采用 stdio 传输并通过 API 密钥认证。

主要功能

  1. 01搜索房源列表
  2. 02查找经纪人及其资料
  3. 03搜索地点信息
  4. 04获取金融与抵押贷款利率
  5. 05stdio 传输与 API 密钥认证

适用场景

  1. 01筛选出售或出租的房源
  2. 02按地点或姓名查找经纪人
  3. 03查询当地金融与抵押贷款利率

MCP 相关

该服务通过 stdio 将 Realty In Us API 操作作为 MCP 工具提供。API 认证需要设置 API_KEY 环境变量。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"realty_in_us": {
"command": "uvx",
"args": [
"bach-realty_in_us"
],
"env": {
"API_KEY": "<API_KEY>"
}
}
}
}
启动命令uvx bach-realty_in_us
需要配置的环境变量
API_KEY密钥

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypibach-realty_in_us

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Realty In Us MCP 服务

English | 简体中文 | 繁體中文

🚀 使用 EMCP 平台快速体验

EMCP 是一个强大的 MCP 服务器管理平台,让您无需手动配置即可快速使用各种 MCP 服务器!

快速开始:
  1. 🌐 访问 EMCP 平台
  2. 📝 注册并登录账号
  3. 🎯 进入 MCP 广场,浏览所有可用的 MCP 服务器
  4. 🔍 搜索或找到本服务器(bach-realty_in_us)
  5. 🎉 点击 "安装 MCP" 按钮
  6. ✅ 完成!即可在您的应用中使用
EMCP 平台优势:
  • ✨ 零配置:无需手动编辑配置文件
  • 🎨 可视化管理:图形界面轻松管理所有 MCP 服务器
  • 🔐 安全可靠:统一管理 API 密钥和认证信息
  • 🚀 一键安装:MCP 广场提供丰富的服务器选择
  • 📊 使用统计:实时查看服务调用情况

立即访问 EMCP 平台 开始您的 MCP 之旅!


简介

这是一个用于访问 Realty In Us API 的 MCP 服务。

  • PyPI 包名: bach-realty_in_us
  • 版本: 2.0.0
  • 传输协议: stdio

安装

从 PyPI 安装:
pip install bach-realty_in_us
从源码安装:
pip install -e .

运行

方式 1: 使用 uvx(推荐,无需安装)
# 运行(uvx 会自动安装并运行)
uvx --from bach-realty_in_us bach_realty_in_us

# 或指定版本
uvx --from bach-realty_in_us@latest bach_realty_in_us
方式 2: 直接运行(开发模式)
python server.py
方式 3: 安装后作为命令运行
# 安装
pip install bach-realty_in_us

# 运行(命令名使用下划线)
bach_realty_in_us

配置

API 认证

此 API 需要认证。请设置环境变量:

export API_KEY="your_api_key_here"
环境变量
变量名说明必需
API_KEYAPI 密钥是
在 Claude Desktop 中使用

编辑 Claude Desktop 配置文件 claude_desktop_config.json:

{
  "mcpServers": {
    "realty_in_us": {
      "command": "uvx",
      "args": ["--from", "bach-realty_in_us", "bach_realty_in_us"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

注意: 请将 E:\path\to\realty_in_us\server.py 替换为实际的服务器文件路径。

可用工具

此服务器提供以下工具:

propertiesv3list

按选项和筛选条件列出待售、出租和已售房产

端点: POST /properties/v3/list


agentsv2search_location

搜索位置信息

端点: GET /agents/v2/search-location

参数:

  • area_types (string): 以下选项之一:neighborhood|city|county|postal_code|building|street

  • limit (string): 用于分页(最多 20 条)

  • input (string) 必需: 您熟悉的任意词语或短语。例如:California


agentsget_listings_deprecated

获取经纪人的房源

端点: GET /agents/get-listings

参数:

  • fulfillment_id (string) 必需: .../agents/list 端点返回的 advertiser_id 字段的值

  • id (string) 必需: .../agents/list 端点返回的 abbreviation 字段的值

  • agent_id (string) 必需: .../agents/list 端点返回的 ...member/id JSON 对象的值

  • type (string): 以下选项之一:all|forSale|forSold|forRent|openHouses

  • page (string): 用于分页


agentsget_recommendations_deprecated

获取经纪人的推荐

端点: GET /agents/get-recommendations

参数:

  • advertiser_id (string) 必需: .../agents/list 端点返回的 advertiser_id 字段的值

agentsget_profile_deprecated

获取经纪人资料

端点: GET /agents/get-profile

参数:

  • advertiser_id (string) 必需: .../agents/list 端点返回的 advertiser_id 字段的值

  • nrds_id (string) 必需: .../agents/list 端点返回的 nrds_id 字段的值


agentslist_deprecated

按筛选条件和选项列出经纪人

端点: GET /agents/list

参数:

  • postal_code (string) 必需: 邮政编码

  • offset (string): 分页时响应中要忽略的条目偏移量

  • limit (string): 用于分页(最多 20 条)

  • sort (string): 以下选项之一:recent_activity_high|recently_sold_high|for_sale_count_high|recommendations_count_high|agent_rating_high

  • name (string): 按名称搜索经纪人、团队或公司

  • types (string): 以下选项之一:agent | team | office

  • agent_type (string): 以下选项之一,或留空:buyer | seller

  • recommendations_count_min (string): 推荐数量(最多 10 条)

  • agent_rating_min (string): 评分(最高 5 分)

  • price_min (string): 可选筛选条件,设置最低价格

  • price_max (string): 可选筛选条件,设置最高价格


agentsv2get_listings

获取经纪人的房源

端点: GET /agents/v2/get-listings

参数:

  • fulfillment_id (string) 必需: .../agents/v2/list 端点返回的 fulfillment_id 字段的值

agentsv2get_recommendations

获取 Agent 推荐

端点:GET /agents/v2/get-recommendations

参数:

  • fulfillment_id (string) 必需:.../agents/v2/list 端点返回的 fulfillment_id 字段的值

agentsv2get_reviews

获取 Agent 评价

端点:GET /agents/v2/get-reviews

参数:

  • fulfillment_id (string) 必需:.../agents/v2/list 端点返回的 fulfillment_id 字段的值

agentsv2get_profile

获取 Agent 个人资料

端点:GET /agents/v2/get-profile

参数:

  • profile_id (string) 必需:.../agents/v2/list 端点返回的 id 字段的值

  • fulfillment_id (string):.../agents/v2/list 端点返回的 fulfillment_id 字段的值


agentsv2list

根据筛选条件和选项列出 Agent

端点:GET /agents/v2/list

参数:

  • postal_code (string) 必需:邮政编码。marketing_area_city、name、postal_code 中必须提供一项

  • offset (string):分页时要在响应中忽略的项目偏移量

  • limit (string):用于分页(最多 20 项)

  • sort (string):以下选项之一:RATINGS_REVIEWS|RELEVANT_AGENTS|MOST_SALES|TESTIMONIALS_RECOMMENDATIONS|MOST_RECENT_ACTIVITY

  • name (string):按名称搜索 Agent、团队或公司。marketing_area_city、name、postal_code 中必须提供一项

  • agent_type (string):以下选项之一,或留空:BUYER|SELLER

  • agent_filter_criteria (string):以下选项之一:NRDS_AND_FULFILLMENT_ID_EXISTS|NRDS_ID_EXISTS|FULFILLMENT_ID_EXISTS

  • marketing_area_city (string):.../agents/v2/search-location 端点返回的 id 值。例如:md_california。marketing_area_city、name、postal_code 中必须提供一项

  • languages (string):以下选项之一:spanish|chinese|french|amharic|arabic|aramaic|portuguese|hindi|russian|afrikaans|albanian|asl|armenian|bengali|bosnian|bulgarian|croatian|czech|danish|dutch|english|estonian|farsi|filipino|finnish|gaelic|georgian|german|greek|gujarati|hawaiian|hebrew|hmong|hungarian|indonesian|italian|japanese|khmer|korean|lao|latvian|lithuanian|malay|malayalam|mandarin|nepali|norwegian|pashto|polish|punjabi|romanian|serbian|sindhi|singhalese|slovenian|somali|swahili|swedish|tagalog|taiwa


financerates

获取融资利率

端点:GET /finance/rates

参数:

  • loc (string) 必需:邮政编码

mortgagecheck_equity_rates_deprecated

查询房屋净值抵押贷款利率

端点:GET /mortgage/check-equity-rates

参数:

  • creditScore (string) 必需:以下选项之一:excellent|good|fair|poor

  • loanProduct (string) 必需:以下选项之一:HELOC,HELOAN_FIXED_5YEARS,HELOAN_FIXED_10YEARS,HELOAN_FIXED_15YEARS,HELOAN_FIXED_20YEARS,HELOAN_FIXED_30YEARS。多个值之间用逗号分隔

  • loanAmount (string) 必需:示例值:70000

  • propertyValue (string) 必需:示例值:300000

  • mortgageBalance (string) 必需:示例值:150000

  • zip (string) 必需:邮政编码

  • state (string) 必需:州代码


mortgagecalculate_deprecated

计算抵押贷款

端点:GET /mortgage/calculate

参数:

  • hoi (string) 必需:房屋保险

  • tax_rate (string) 必需:房产税

  • downpayment (string) 必需:首付款

  • price (string) 必需:房屋价格

  • term (string) 必需:抵押贷款类型

  • rate (string) 必需:利率


mortgagecheck_rates_deprecated

查询抵押贷款利率

端点:GET /mortgage/check-rates

参数:

  • creditScore (string) 必需:以下选项之一:excellent|good|fair|poor

  • points (string) 必需:以下选项之一:all|zero|zero_to_one|one_to_two

  • loanPurpose (string) 必需:purchase|refinance

  • loanTypes (string) 必需:以下选项之一:ALL|30YrFixed|30YrFixed_FHA|30YrFixed_VA|20YrFixed|15YrFixed|10YrFixed|5Arm|7Arm

  • loanPercent (string) 必需:示例值:85.2

  • propertyPrice (string) 必需:示例值:250000

  • zip (string) 必需:邮政编码


mortgagev2check_rates

查询抵押贷款利率

端点:GET /mortgage/v2/check-rates

参数:

  • postal_code (string) 必需:邮政编码

mortgagecalculate_affordability_deprecated

计算可负担能力

端点:GET /mortgage/calculate-affordability

参数:

  • annual_income (string) 必需:示例值:250000

  • debt_to_income_ratio (string) 必需:示例值:0.43

  • down_payment (string) 必需:示例值:172000

  • hoa_fees (string):示例值:0

  • homeowner_insurance_rate (string) 必需:示例值:0.012

  • interest_rate (string) 必需:示例值:0.03119

  • is_pmi_included (string):示例值:

  • loan_term (string) 必需:示例值:30

  • monthly_debt (string) 必需:示例值:1500

  • tax_rate (string) 必需:示例值:0.01


propertiesv2list_for_sale_deprecated

列出待售房产

端点: GET /properties/v2/list-for-sale

参数:

  • city (string) 必需: locations/auto-complete API 返回的 city 字段值(不要与 postal_code 参数同时使用)

  • state_code (string) 必需: locations/auto-complete API 返回的 state_code 字段值(不要与 postal_code 参数同时使用)

  • postal_code (string): 邮政编码(不要与 city 和 state_code 参数同时使用)

  • offset (string) 必需: 分页时要在响应中忽略的条目偏移量

  • limit (string) 必需: 每次请求要返回的条目数

  • sort (string): 可选值如下(多个值以逗号分隔):relevance|newest|price_low|price_high|photos|open_house_date|sqft_high|price_reduced_date

  • prop_type (string): 可选值如下(多个值以逗号分隔):single_family,multi_family,condo,mobile,land,farm,other

  • prop_sub_type (string): 可选值如下(多个值以逗号分隔):condo,cond_op,townhouse,co_op

  • features (string): 可选值如下(多个值以逗号分隔):garage_2_or_more,view,waterfront,golf_course_view,swimming_pool,cul_de_sac,hardwood_floors,basement,fireplace,energy_efficient,disability_features,dining_room,washer_dryer,family_room,den_or_office,game_room,central_air,central_heat,forced_air,single_story,two_or_more_stories,corner_lot,water_view,golf_course_lot_or_frontage,hill_or_mountain_view,ocean_view,city_view,lake_view,river_view,community_security_features,community_swimmin

  • radius (string): 搜索房产的半径,单位为英里(1 到 20)

  • age_min (string): 房产的最小房龄

  • age_max (string): 房产的最大房龄

  • sqft_min (string): 房产的最小面积

  • sqft_max (string): 房产的最大面积

  • baths_min (string): 房产的最少浴室数

  • beds_min (string): 房产的最少卧室数

  • price_min (string): 可选筛选条件,设置最低价格

  • price_max (string): 可选筛选条件,设置最高价格

  • lot_sqft_min (string): 地块/土地面积下限

  • lot_sqft_max (string): 地块/土地面积上限

  • is_matterports (string): 示例值:

  • is_foreclosure (string): 示例值:

  • has_open_house (string): 示例值:

  • is_new_construction (string): 示例值:

  • is_contingent (string): 示例值:

  • is_pending (string): 示例值:

  • is_new_plan (string): 示例值:

  • lat_max (string): 在边界框内搜索房产,这是坐标的最大纬度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。

  • lat_min (string): 在边界框内搜索房产,这是坐标的最小纬度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。

  • lng_max (string): 在边界框内搜索房产,这是坐标的最大经度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。

  • lng_min (string): 在边界框内搜索房产,这是坐标的最小经度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。


propertiesv2list_by_mls_deprecated

按 MLS ID 列出房产

端点: GET /properties/v2/list-by-mls

参数:

  • mls_id (string) 必需: MLS ID

  • prop_status (string): 可选值:for_sale|for_rent|recently_sold

  • offset (string): 分页时要在响应中忽略的条目偏移量

  • limit (string): 每次响应的条目数


propertiesv2detail_deprecated

获取房产详细信息

端点: GET /properties/v2/detail

参数:

  • property_id (string) 必需: .../properties/list-... 或 .../properties/v2/list-... 端点返回的 property_id 字段值。

propertieslist_for_rent_deprecated

列出租赁房产

端点:GET /properties/list-for-rent

参数:

  • state_code (string) 必需:locations/auto-complete API 返回的 state_code 字段值(请勿与 postal_code 参数同时使用)

  • city (string) 必需:locations/auto-complete API 返回的 city 字段值(请勿与 postal_code 参数同时使用)

  • postal_code (string):邮政编码(请勿与 city 和 state_code 参数同时使用)

  • limit (string) 必需:每次请求返回的项目数

  • offset (string) 必需:分页时响应中忽略的项目偏移量

  • sort (string):可选值:completeness、photos、freshest|price_low|price_high|photos|newest

  • radius (string):查找房产的半径,单位为英里

  • baths_min (string):可选筛选条件,设置最低浴室数量

  • beds_min (string):可选筛选条件,设置最低卧室数量

  • price_min (string):可选筛选条件,设置最低价格

  • price_max (string):可选筛选条件,设置最高价格

  • sqft_min (string):房产的最小面积

  • sqft_max (string):房产的最大面积

  • prop_type (string):可选值(多个值以逗号分隔):apartment,single_family,mapi_condo_townhome,other

  • mapi_community_features (string):可选值(多个值以逗号分隔):community_washer_dryer,community_parking,central_air,community_pool,community_gym

  • listed_date_min (string):日期字符串格式为 yyyy-MM-dd'T'HH:mm:ss'Z',例如:2019-08-01T16:24:40Z。房产在 realtor.com 上架的起始日期

  • allows_dogs (string):示例值:

  • allows_cats (string):示例值:

  • no_pets_allowed (string):示例值:

  • lat_max (string):在边界框内查找房产,这是坐标的最大纬度。如果 postal_code、city 或 state_code 参数有值,则此项无效。

  • lat_min (string):在边界框内查找房产,这是坐标的最小纬度。如果 postal_code、city 或 state_code 参数有值,则此项无效。

  • lng_max (string):在边界框内查找房产,这是坐标的最大经度。如果 postal_code、city 或 state_code 参数有值,则此项无效。

  • lng_min (string):在边界框内查找房产,这是坐标的最小经度。如果 postal_code、city 或 state_code 参数有值,则此项无效。


propertiesv2list_for_rent_deprecated

列出租赁房源

端点: GET /properties/v2/list-for-rent

参数:

  • city (string) 必需: locations/auto-complete API 返回的 city 字段值(请勿与 postal_code 参数同时使用)

  • state_code (string) 必需: locations/auto-complete API 返回的 state_code 字段值(请勿与 postal_code 参数同时使用)

  • postal_code (string): 邮政编码(请勿与 city 和 state_code 参数同时使用)

  • limit (string) 必需: 每次请求返回的项目数

  • offset (string) 必需: 分页时响应中要忽略的项目偏移量

  • sort (string): 可选值:relevance|newest|price_low|price_high|photos|open_house_date|sqft_high|price_reduced_date

  • prop_type (string): 可选值(多个值以逗号分隔):single_family,multi_family,condo,mobile,land,farm,other

  • prop_sub_type (string): 可选值(多个值以逗号分隔):condo,cond_op,townhouse,co_op

  • features (string): 可选值(多个值以逗号分隔):recreation_facilities,swimming_pool,washer_dryer,garage_1_or_more,central_air,fireplace,spa_or_hot_tub,dishwasher,community_doorman,community_elevator,furnished,laundry_room,community_no_fee,community_outdoor_space,pets_allowed

  • radius (string): 搜索房源的半径,单位为英里(1 到 20)

  • beds_min (string): 房源的最少卧室数

  • baths_min (string): 房源的最少浴室数

  • price_min (string): 设置最低价格的可选筛选条件

  • price_max (string): 设置最高价格的可选筛选条件

  • lot_sqft_min (string): 最小地块/土地面积

  • lot_sqft_max (string): 最大地块/土地面积

  • sqft_min (string): 房源的最小面积

  • sqft_max (string): 房源的最大面积

  • allows_dogs (string): 示例值:

  • allows_cats (string): 示例值:

  • lat_max (string): 在边界框内搜索房源,这是坐标的最大纬度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。

  • lat_min (string): 在边界框内搜索房源,这是坐标的最小纬度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。

  • lng_max (string): 在边界框内搜索房源,这是坐标的最大经度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。

  • lng_min (string): 在边界框内搜索房源,这是坐标的最小经度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。


locationsauto_complete_deprecated

按城市、行政区或街道名称获取自动补全建议,以便在其他端点中使用。此端点还可根据地址获取特定房源 ID。

端点: GET /locations/auto-complete

参数:

  • input (string) 必需: 城市、区或地点的名称

propertieslist_sold_deprecated

列出已售房产

端点: GET /properties/list-sold

参数:

  • city (string) 必需: locations/auto-complete API 返回的 city 字段值(请勿与 postal_code 参数同时使用)

  • state_code (string) 必需: locations/auto-complete API 返回的 state_code 字段值(请勿与 postal_code 参数同时使用)

  • postal_code (string): 邮政编码(请勿与 city 和 state_code 参数同时使用)

  • offset (string) 必需: 分页时响应中要忽略的条目偏移量

  • limit (string) 必需: 每次请求要返回的条目数

  • sort (string): 以下选项之一:price_low|price_high

  • prop_type (string): 以下选项之一(多个值以逗号分隔):single_family, condo, mobile, multi_family, farm, land

  • radius (string): 搜索房产的半径,单位为英里

  • age_min (string): 房屋最低房龄

  • age_max (string): 房屋最高房龄

  • sqft_min (string): 房产的最小面积

  • sqft_max (string): 房产的最大面积

  • lot_sqft_min (string): 最小地块/土地面积

  • lot_sqft_max (string): 最大地块/土地面积

  • price_min (string): 可选筛选条件,设置最低价格

  • price_max (string): 可选筛选条件,设置最高价格

  • lat_max (string): 在边界框内搜索房产,这是坐标的最大纬度。如果 postal_code、city 或 state_code 参数有值,则此参数不起作用。

  • lat_min (string): 在边界框内搜索房产,这是坐标的最小纬度。如果 postal_code、city 或 state_code 参数有值,则此参数不起作用。

  • lng_max (string): 在边界框内搜索房产,这是坐标的最大经度。如果 postal_code、city 或 state_code 参数有值,则此参数不起作用。

  • lng_min (string): 在边界框内搜索房产,这是坐标的最小经度。如果 postal_code、city 或 state_code 参数有值,则此参数不起作用。


locationsv2auto_complete

根据城市、行政区、街道名称获取自动补全建议,以便传入其他端点。此端点还可根据地址获取特定房产 ID。

端点: GET /locations/v2/auto-complete

参数:

  • input (string) 必需: 州、城市、地区、地址、邮政编码。例如:California Los Angeles 2425 Sahalee Dr W Sammamish, WA

  • limit (string): 每次响应的条目数,用于分页


mortgagev2calculate

计算抵押贷款

端点: GET /mortgage/v2/calculate

参数:

  • home_insurance (string) 必需: 房屋保险

  • property_tax_rate (string) 必需: 房产税

  • down_payment (string) 必需: 首付款

  • price (string) 必需: 房屋价格

  • term (string) 必需: 抵押贷款类型

  • rate (string) 必需: 利率

  • hoa_fees (string) 必需: 业主协会费用

  • apply_veterans_benefits (string): 示例值:


schoolsdetail

获取学校详细信息

端点: GET /schools/detail

参数:

  • id (string) 必需: .../schools/list 端点返回的 schools -> id 字段值

schoolslist

列出学校,并提供选项和筛选条件

端点: GET /schools/list

参数:

  • limit (string): 每次响应返回的项目数,用于分页

  • offset (string): 要忽略的记录偏移量,用于分页

  • state_code (string) 必需: 按州筛选学校(你需要至少指定以下一项:state_code|city|county|neighborhood|postal_code|school_district_id)

  • city (string): 按城市筛选学校(你需要至少指定以下一项:state_code|city|county|neighborhood|postal_code|school_district_id)

  • county (string): 按县筛选学校(你需要至少指定以下一项:state_code|city|county|neighborhood|postal_code|school_district_id)

  • neighborhood (string): 按街区筛选学校(你需要至少指定以下一项:state_code|city|county|neighborhood|postal_code|school_district_id)

  • postal_code (string): 按邮政编码筛选学校(你需要至少指定以下一项:state_code|city|county|neighborhood|postal_code|school_district_id)

  • school_district_id (string): 按学区 ID 筛选学校(你需要至少指定以下一项:state_code|city|county|neighborhood|postal_code|school_district_id)

  • education_level (string): 以下选项之一:elementary|high|middle|private


schoolsget_school_district

获取学区的详细信息

端点: GET /schools/get-school-district

参数:

  • id (string) 必需: .../schools/list 端点返回的 districts -> id 字段的值

propertieslist_for_sale_deprecated

列出待售房产

端点: GET /properties/list-for-sale

参数:

  • state_code (string) 必需: locations/auto-complete API 返回的 state_code 字段值(请勿与 postal_code 参数同时使用)

  • city (string) 必需: locations/auto-complete API 返回的 city 字段值(请勿与 postal_code 参数同时使用)

  • postal_code (string): 邮政编码(请勿与 city 和 state_code 参数同时使用)

  • offset (string) 必需: 分页时响应中要忽略的条目偏移量

  • limit (string) 必需: 每次请求返回的条目数

  • sort (string): 以下选项之一(relevance | price_low | price_high | photos | newest | open_house_date | sqft_high | price_reduced_date)

  • radius (string): 搜索房产的半径,单位为英里

  • prop_type (string): 以下选项之一(多个值以逗号分隔):single_family,condo,mobile,multi_family,farm,land

  • listed_date_min (string): 日期字符串格式为 yyyy-MM-dd'T'HH:mm:ss'Z',例如:2019-08-01T16:24:40Z。房产在 realtor.com 上架的起始日期

  • baths_min (string): 可选筛选条件,设置最少浴室数量

  • beds_min (string): 可选筛选条件,设置最少卧室数量

  • reduced (string): true/false - 仅显示降价房产

  • price_min (string): 可选筛选条件,设置最低价格

  • price_max (string): 可选筛选条件,设置最高价格

  • features (string): 以下选项之一(多个值以逗号分隔):basement,den_or_office,dining_room,family_room,game_room,washer_dryer,energy_efficient_home,central_air,central_heat,forced_air,carport,garage_1_or_more,garage_2_or_more,garage_3_or_more,rv_or_boat_parking,disability_features,fireplace,hardwood_floors,horse_facilities,spa_or_hot_tub,swimming_pool,tennis_court,single_story,two_or_more_stories,lease_option,pets_allowed,corner_lot,cul_de_sac,golf_course_lot_or_frontage,waterfront,city_

  • age_min (string): 房屋最低房龄

  • age_max (string): 房屋最高房龄

  • lot_sqft_min (string): 最小地块/土地面积

  • lot_sqft_max (string): 最大地块/土地面积

  • sqft_min (string): 房产最小面积

  • sqft_max (string): 房产最大面积

  • is_foreclosure (string): 示例值:

  • is_matterports (string): 示例值:

  • is_new_construction (string): 示例值:

  • is_pending (string): 示例值:

  • is_contingent (string): 示例值:

  • lat_max (string): 在边界框内搜索房产,这是坐标的最大纬度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。

  • lat_min (string): 在边界框内搜索房产,这是坐标的最小纬度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。

  • lng_max (string): 在边界框内搜索房产,这是坐标的最大经度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。

  • lng_min (string): 在边界框内搜索房产,这是坐标的最小经度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。


propertiesv3detail

获取房产详细信息(包括新的房屋价值功能)

端点: GET /properties/v3/detail

参数:

  • listing_id (string): 在 .../properties/.../list 端点返回的 listing_id 字段值

  • property_id (string) 必需: 在 .../properties/.../list 端点返回的 property_id 字段值


propertiesv3get_surroundings

获取房产周边数据

端点: GET /properties/v3/get-surroundings

参数:

  • property_id (string) 必需: 在 .../properties/.../list 端点返回的 property_id 字段值

  • enable_flood (string): 示例值:


propertiesv3list_similar_homes

列出相似房源

端点: GET /properties/v3/list-similar-homes

参数:

  • property_id (string) 必需: 在 .../properties/.../list 端点返回的 property_id 字段值

  • limit (string): 每次响应返回的条目数,用于分页

  • status (string): 以下选项之一:for_sale|ready_to_build|for_rent|sold|off_market|other|new_community


propertiesv2list_similar_homes_deprecated

列出待售的相似房源 * 此端点即将弃用,官方已改用 .../properties/v2/list... 端点列出相似房源。

端点: GET /properties/v2/list-similar-homes

参数:

  • property_id (string) 必需: 在 .../properties/list-... 或 .../properties/v2/list-... 端点返回的 property_id 字段值。

propertiesv3get_photos

获取房源照片

端点: GET /properties/v3/get-photos

参数:

  • property_id (string) 必需: 在 .../properties/.../list 端点返回的 property_id 字段值

propertiesdetail_deprecated

获取房源详细信息

端点: GET /properties/detail

参数:

  • listing_id (string) 必需: 在 .../properties/list-... 或 .../properties/v2/list-... 端点返回的 listing_id 字段值。

  • prop_status (string) 必需: 以下选项之一:for_sale|for_rent

  • property_id (string) 必需: 在 .../properties/list-... 或 .../properties/v2/list-... 端点返回的 property_id 字段值。


propertiesv3get_commute_time

获取前往某地点的通勤时间

端点: GET /properties/v3/get-commute-time

参数:

  • destination_address (string) 必需: 地址,应使用 .../locations/v2/auto-complete 获取完整且准确的地址。例如:7830 Poppy Blvd

  • property_id (string) 必需: 在 .../properties/.../list 端点返回的 property_id 字段值

  • transportation_type (string): 以下选项之一:bicycling|driving|transit|walking

  • with_traffic (string): 示例值:


propertiesv2list_sold_deprecated

列出已售房产

端点: GET /properties/v2/list-sold

参数:

  • offset (string) 必需: 分页时响应中要忽略的项目偏移量

  • limit (string) 必需: 每次请求要返回的项目数

  • city (string) 必需: locations/auto-complete API 响应中 city 字段的值(不要与 postal_code 参数同时使用)

  • state_code (string) 必需: locations/auto-complete API 响应中 state_code 字段的值(不要与 postal_code 参数同时使用)

  • postal_code (string): 邮政编码(不要与 city 和 state_code 参数同时使用)

  • sort (string): 可选值:sold_date|beds_high|price_low|price_high|lot_sqft_high

  • prop_type (string): 可选值(多个值以逗号分隔):single_family,multi_family,condo,mobile,land,farm,other

  • radius (string): 搜索房产的半径,单位为英里(1 到 20)

  • baths_min (string): 房产的最低浴室数

  • beds_min (string): 房产的最低卧室数

  • price_min (string): 可选筛选条件,设置最低价格

  • price_max (string): 可选筛选条件,设置最高价格

  • lot_sqft_min (string): 地块/土地面积下限

  • lot_sqft_max (string): 地块/土地面积上限

  • age_min (string): 房屋最低房龄

  • age_max (string): 房屋最高房龄

  • sqft_min (string): 房产面积下限

  • sqft_max (string): 房产面积上限

  • lat_max (string): 在边界框内搜索房产,这是坐标的最大纬度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。

  • lat_min (string): 在边界框内搜索房产,这是坐标的最小纬度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。

  • lng_max (string): 在边界框内搜索房产,这是坐标的最大经度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。

  • lng_min (string): 在边界框内搜索房产,这是坐标的最小经度。如果 postal_code、city 或 state_code 参数有值,则此参数无效。


agentsget_reviews_deprecated

获取经纪人评价

端点: GET /agents/get-reviews

参数:

  • advertiser_id (string) 必需: .../agents/list 端点返回的 advertiser_id 字段值

schoolslist_nearby_deprecated

列出房产附近的学校

端点: GET /schools/list-nearby

参数:

  • lon (string) 必需: 经度坐标

  • lat (string) 必需: 纬度坐标


propertiesv2list_similar_rental_homes_deprecated

列出租赁相似房产 * 此端点即将弃用,官方已改为使用 .../properties/v2/list.... 端点列出相似房产。

端点: GET /properties/v2/list-similar-rental-homes

参数:

  • postal_code (string) 必需: 所有列表端点返回的 postal_code 字段值

  • property_id (string) 必需: .../properties/list-.... 或 .../properties/v2/list-... 端点返回的 property_id 字段值。


propertieslist_similarities_deprecated

列出相似房产

端点: GET /properties/list-similarities

参数:

  • property_id (string) 必需: .../properties/list-.... 或 .../properties/v2/list-... 端点返回的 property_id 字段值。

  • limit (string) 必需: 返回的项目数

  • prop_status (string) 必需: 可选值:for_sale|for_rent


propertieslist_by_mls_deprecated

按 MLS ID 列出房产

端点: GET /properties/list-by-mls

参数:

  • mls_id (string) 必需: MLS ID

  • limit (string): 每次响应的项目数

  • offset (string): 分页时响应中要忽略的项目偏移量

  • sort (string): 可选值:price_low|price_high|photos|newest|open_house_date


技术栈

  • 传输协议: stdio
  • HTTP 客户端: httpx

开发

此服务器由 API-to-MCP 工具自动生成。

版本: 2.0.0

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。