用途:在可比时间段内比较多个美国住房市场,用于城市、都会区、县或 ZIP 邮编层面的价格、库存、成交量与在售天数对比。需将市场聚合数据与单套房产估值、个人融资决策分开处理。
主要能力:通过 Crawlora 历史住房数据集检索区域市场序列,并可选用 Redfin 实时区域趋势作为补充。数据集 region_type 支持 national、metro、county、city、zip。可比较中位成交价/挂牌价、库存、成交套数、中位在售天数;MoM/YoY 字段为小数,0.05 表示 +5%。可获取可负担性建模比较,保留 income_vintage、income_geo_id、mortgage_rate_pct。
使用方式:设置 CRAWLORA_API_KEY(来自 crawlora.net),在技能目录或绝对路径运行 scripts/crawlora.sh,脚本向 https://api.crawlora.net/api/v1 发送 x-api-key。先读 reference/endpoints.md。用 /datasets/housing-markets/facets 与 /search 解析精确区域和 table_id(名称与 ZIP 不是 table_id)。建议先 latest=true、单一区域层级、单一房产类型;latest 按序列计算,需同时比较返回的 period_begin 与 period_end。用 /datasets/housing-markets/items/{region_type}/{table_id} 配合 history=true 和相同 property_type 取历史序列。示例:scripts/crawlora.sh /datasets/housing-markets/search region_type=city state_code=TX latest=true 'property_type=Single Family Residential' page_size=5。可选 /redfin/search?location=... 使用实时搜索解析出的数值 region_type 与 region_id。
适用场景:多市场横向对比、同比分析、可负担性建模比较、生成对比表与时间序列图。
限制:分页 page_size<=100、结果上限 10000;404 可能表示区域/时段/房产类型组合缺失;429 退避,5xx 重试一次,401/403 停止。不得对 ZIP/城市中位数求平均得到都会区中位数,不得叠加重叠地理或重叠滚动窗口成交量。中位价变化可能反映成交结构,不等于固定房产升值率;成交少会削弱比较。数据集薪资估算假设 20% 首付、30 年固定利率、1.5% 年税费保险、28% 还款收入比,需披露假设与收入滞后。实时挂牌与历史聚合数据总体和日期不同,不可混为单一统计。缺失值保留为 null,不视为零。其他细节暂未提供。