Realtor.com Property Data

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install realtor-com-property-data
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 realtor-com-property-data。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Realtor.com Property Data 将 AI Agent 连接到六个 Scavio API 端点，用于搜索美国房屋、土地、出租房和已售房源；获取详细的房产记录；解析位置；探索市场统计数据；以及查找经纪人及其评价。每个端点都返回结构化 JSON，使数据非常适合研究、线索获取、比较和自动化工作流。
在 Openclaw Skills 中，该 skill 专为需要可操作的房源筛选器和详细记录的房地产任务而设计——而不仅仅是基本的房产搜索。每页搜索最多可返回 200 个房源，以及价格和税收历史、估值、学校、风险指标和经纪人详情（如果可用）。每次 API 调用消耗一个 credit。

应用场景

按城市、县、邮政编码、社区、坐标或挂牌经纪人查找房屋、土地、出租房、待售房源或已售房产。
使用针对房产类型、占地面积、价格和出售日期的筛选器构建已售对比列表。
监控最近挂牌的房产，其挂牌文本中包含诸如“workshop”或“storefront”等关键字。
使用其 Realtor.com URL 或房产 ID 研究单一房产，包括价格和税收历史、可用估值、学校、风险数据和抵押贷款估计。
使用挂牌、已售和出租的中位数、在售天数、挂牌数量和市场变化来比较区域住房状况。
按位置、邮政编码或姓名查找经纪人，然后查看个人资料、销售统计数据、执照和评价。
从 Realtor.com 数据创建土地、出租或新建房屋的线索列表。
使用一致的 JSON 响应为房地产研究助手和其他 Openclaw Skills 工作流提供支持。

工作原理

在 SCAVIO_API_KEY 环境变量中配置 Scavio API key。
选择任务所需的端点：搜索房源、获取房产详情、解析位置、获取市场统计数据、搜索经纪人或获取经纪人个人资料。
向 https://api.scavio.dev/api/v1/realtor/{endpoint} 发送带有 Authorization: Bearer $SCAVIO_API_KEY 的 JSON POST 请求。
对于房产查询，使用 property_id 或 Realtor.com URL。对于市场数据，使用位置端点解析地点并使用其 slug_id，或者直接传递城市和州。
从 data 字段读取结构化响应。响应还会汇报响应时间、消耗的 credits 以及剩余 credits。
根据需要对房源或经纪人结果进行分页，每个页面预算一个 credit。搜索页面最多支持 200 个房源；经纪人页面最多支持 50 个经纪人。
根据返回的房源 URL 核实重要详情。将 null 或不可用的值视为缺失，而不是估计或伪造它们。

配置指南

通过在 Scavio 注册获取 API key；新账号赠送 50 个 credits，不需要支付卡。在使用 API 之前设置环境变量中的 key：
export SCAVIO_API_KEY=sk_live_your_key
所有六个端点每次调用消耗一个 credit。请求使用 JSON POST 请求体和 bearer-token 身份验证。如果 credit 余额用尽，API 将返回 402 和 billing_url；充值 credits 后现有 key 可以继续使用。
房源搜索示例：
curl -X POST https://api.scavio.dev/api/v1/realtor/search
-H "Authorization: Bearer $SCAVIO_API_KEY"
-H "Content-Type: application/json"
-d '{"location":"Austin, TX","listing_status":"for_sale","page_size":50}' 可选的 SDK 安装：
pip install scavio==0.20.0
npm install scavio@0.20.0
对于 MCP 集成，请配置 Scavio MCP 服务器，并通过在 SCAVIO_PLATFORMS 中包含 realtor 来启用 Realtor.com 工具：
{
"mcpServers": {
"scavio": {
"command": "npx",
"args": ["-y", "@scavio/mcp-server@0.18.1"],
"env": {
"SCAVIO_API_KEY": "sk_live_your_key",
"SCAVIO_PLATFORMS": "default,realtor"
}
}
}
}
请将 API key 保存在环境变量或密钥存储中，而不是提交到源代码控制系统中。
Realtor.com Property Data 数据架构与分类体系
响应使用共享的外层包裹格式：
Field Purpose
data 端点结果和特定领域记录
response_time 请求耗时信息
credits_used 本次调用扣除的 credits
credits_remaining 当前剩余余额
六个端点结果组的数据组织如下：
Search: total、count、分页字段和 listings[]。房源记录可包含 ID 和 URL、状态、价格、日期、房产类型、卧室和浴室数、平方英尺数、占地面积、建造年份、HOA、标志、坐标、MLS 详情、经纪人、办公室和照片。
Property: 房源字段加上描述、特征、价格和税收历史、估值估计和历史、学校、洪水/火灾/噪音风险、挂牌经纪人和办公室联系方式、抵押贷款估计、照片、看房、地块详情和费用。某些组可能为空或 null。
Locations: 匹配的地点建议，带有文本、区域类型、slug_id、适用时的地址级 property_id、地理信息和坐标。
Market: 地理信息和上级位置、挂牌/已售/出租中位数价格、每平方英尺价格、在售天数、挂牌数量、同比和环比变化，以及房产类型分类。
Agents: 分页的经纪人记录，带有 ID、评分、评价数量、房源、价格范围、销售活动、经纪公司和办公室信息以及服务。
Agent profile: 经纪人详情加上简介、联系方式、执照、语言、专业领域、服务区域、MLS 会员资格、销售统计数据、社交链接以及带有子评分和回复的评价。
搜索和经纪人结果均进行分页。搜索支持最大 200 的页面大小，并具有 10,000 个结果的 offset 保护限制；经纪人搜索支持最大 50 的页面大小。数据可用性因房产和地理位置而异。在非公开州，已售价格可能为 null，并且某些房产的估值、学校或风险数据可能不可用。

高级特性

使用完整的房源筛选集，包括状态、价格、卧室、浴室、室内和占地面积、建造年份、HOA、房产类型、新建房屋、止赎、开放日、降价和文本关键字。
按地理中心和半径（0.1 至 50 英里）进行搜索，或按
agent_id
筛选房源。
每页最多获取 200 行房源，并按相关性、日期、价格、面积、占地面积或其它支持的标准排序。
构建多查询搜索以实现广泛覆盖，方法是将区域拆分为邮政编码、价格带、房产类型或半径；按
property_id
对结果去重并遵守 10,000 个结果的限制。
将位置自动补全链接到市场查询，将房源搜索链接到房产详情，或将经纪人搜索链接到包含评价的完整个人资料。
通过 Python 或 Node.js Scavio SDK、直接 HTTP 请求或 Scavio MCP 服务器工具访问所有六个端点。
明确处理 API 错误：对
纠正无效请求，对
检查 key，对
补充 credits，并在
时退避。在短暂等待后重试临时的
故障。
保持数据准确性：关键字匹配搜索的是挂牌文本，而不是结构化特征；在房产详情中确认重要匹配。绝不虚构缺失的价格、估计、评分或评价。

name: realtor-com-property-data description: Realtor.com property data as structured JSON - listing search for sale, pending, for rent or sold with up to 200 rows per call, one property in full with price and tax history, home value estimates, schools and flood/fire risk, area market stats, location autocomplete, and agent search plus full agent profiles with every review. 6 endpoints, 1 credit each. version: 1.0.0
tags: realtor, realtor-com, realtor-api, realtor-com-api, real-estate, property-data, mls-listings, for-sale, for-rent, sold-homes, sold-comps, land-comps, home-prices, home-value-estimate, tax-history, housing-market, market-stats, real-estate-agents, agent-reviews, structured-data, json, ai-agents, mcp