关于 Realty_in_us
Realty_in_us 是用于访问 Realty In Us API 的 MCP 服务,为客户端提供房源、经纪人、地点、金融利率和抵押贷款相关工具,采用 stdio 传输并通过 API 密钥认证。
主要功能
- 01搜索房源列表
- 02查找经纪人及其资料
- 03搜索地点信息
- 04获取金融与抵押贷款利率
- 05stdio 传输与 API 密钥认证
适用场景
- 01筛选出售或出租的房源
- 02按地点或姓名查找经纪人
- 03查询当地金融与抵押贷款利率
MCP 相关
该服务通过 stdio 将 Realty In Us API 操作作为 MCP 工具提供。API 认证需要设置 API_KEY 环境变量。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Realty In Us MCP 服务
🚀 使用 EMCP 平台快速体验
EMCP 是一个强大的 MCP 服务器管理平台,让您无需手动配置即可快速使用各种 MCP 服务器!
快速开始:
- 🌐 访问 EMCP 平台
- 📝 注册并登录账号
- 🎯 进入 MCP 广场,浏览所有可用的 MCP 服务器
- 🔍 搜索或找到本服务器(
bach-realty_in_us) - 🎉 点击 "安装 MCP" 按钮
- ✅ 完成!即可在您的应用中使用
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_KEY | API 密钥 | 是 |
在 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-completeAPI 返回的city字段值(请勿与postal_code参数同时使用) -
state_code(string) 必需:locations/auto-completeAPI 返回的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
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。