mcpField
R
real-estate-autos-research

real-estate-autos-research

github.com/crawlora-org其他141 次安装1 天前更新
代码仓库

关于 real-estate-autos-research

通过 Crawlora API 查询房屋和二手车信息的技能，汇总 Zillow、Redfin、CarMax、Autotrader 和 Cars.com 的规范化 JSON。支持房源与车辆搜索、详情查询，以及市场趋势和可比房产研究。

主要功能

  1. 01在 Zillow 和 Redfin 搜索房屋
  2. 02获取房产详情和 Redfin 估值
  3. 03查询可比房产和区域趋势
  4. 04在三个平台搜索二手车
  5. 05获取车辆和经销商详情

适用场景

  1. 01比较房源和区域房价趋势
  2. 02将估值与可比房产进行核对
  3. 03跨平台比较二手车价格和里程

MCP 相关

这是一个技能，而非 MCP 服务。它通过 `scripts/crawlora.sh` 辅助脚本调用 Crawlora API。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill real-estate-autos-research

安装后在 Claude Code 中输入/real-estate-autos-research确认已加载。

附带文件reference/endpoints.mdscripts/crawlora.sh

详细介绍

房地产与汽车研究

搜索房屋和二手车，并从五个平台获取房产／车辆详情，以标准化 JSON 形式返回，数据来自 Crawlora API——无需抓取房源页面。

何时使用此技能

  • “查找 的待售房屋”／“这处房产值多少钱？”（Zillow、Redfin）
  • “这个地区的房价走势如何？”（Redfin 市场趋势）
  • 查找“类似房产”进行比较。
  • “查找 附近待售的 <make/model>”（CarMax、Autotrader、Cars.com）
  • “查询这个车辆房源／经销商。”

设置（一次性）

  • 在 https://crawlora.net 获取免费的 Crawlora API 密钥（每月 2,000 个积分，无需信用卡）。
  • 运行辅助脚本前，在环境中设置 CRAWLORA_API_KEY。
  • 辅助脚本会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。缺少密钥或密钥无效时会返回 401。

工作原理

  1. Zillow — /zillow/search 除了 location 字符串外还需要其他参数：**先调用 /zillow/autocomplete（传入 query）**以获取 region_id（以及在可用时获取地图边界 north／south／east／west），然后将 location+region_id（以及在返回时提供的 region_type）传给 /zillow/search；通过 /zillow/property/{zpid} 获取详情。
  2. Redfin — 使用 /redfin/search（传入 location 或 region_id+region_type，以及 min_beds／max_price 等筛选条件）搜索房源；使用 /redfin/property（通过 property_id 或 url）获取详情；使用 /redfin/estimate（传入 property_id）获取 Redfin 估价；使用 /redfin/similar 查找可比房产；使用 /redfin/region-trends（传入 region_id+region_type）查询市场历史趋势。
  3. CarMax — 使用 /carmax/search（筛选条件：make、model、zip、min_price／max_price、min_year／max_year）；使用 /carmax/vehicle/{stock_number} 获取详情（以及 /recommendations）；使用 /carmax/stores／/carmax/store/{id} 查询经销商地点。
  4. Autotrader — 使用 /autotrader/search（筛选条件：make、model、zip、radius、价格／年份／里程范围、condition）；使用 /autotrader/vehicle/{id} 获取详情；使用 /autotrader/dealer/{id} 查询卖家。
  5. Cars.com — 使用 /carsdotcom/search（传入 zip、radius、stock_type）；使用 /carsdotcom/vehicle/{listing_id} 获取详情。

完整端点列表、方法和参数见：reference/endpoints.md。

调用 API

# Homes (resolve region_id first, Zillow search needs more than a location string):
scripts/crawlora.sh /zillow/autocomplete query="Austin, TX" | jq '.data'
scripts/crawlora.sh /zillow/search location="Austin, TX" region_id=10221 | jq '.'
scripts/crawlora.sh /redfin/region-trends region_id=30818 region_type=city | jq '.'

# Cars:
scripts/crawlora.sh /carmax/search make=Toyota model=RAV4 zip=94103 | jq '.'
scripts/crawlora.sh /autotrader/search make=Honda model=Civic zip=94103 radius=50 | jq '.'

所有请求都使用 scripts/crawlora.sh；它可确保 API 密钥不会出现在命令行参数中。

端点参考

请参阅 reference/endpoints.md，查看此技能使用的所有 Zillow、 Redfin、CarMax、Autotrader 和 Cars.com 端点。

示例

  • 购房研究： 对同一地区使用 /zillow/search 和 /redfin/search，交叉核对价格／每平方英尺价格，然后使用 /redfin/region-trends 查看市场是在升温还是降温。
  • 房产估值合理性核查： 对同一地址结合使用 /redfin/estimate 和 /redfin/similar（可比房产）。
  • 购车比较： 对同一品牌／车型／邮编使用 /carmax/search、/autotrader/search 和 /carsdotcom/search，比较三个平台的价格和里程差异。

注意事项与限制

  • 积分／成功后付费： 仅在请求返回 2xx 时计费；免费套餐每月 2,000 个积分。密钥可在 https://crawlora.net 获取。
  • 仅限公开数据 — 公开房源／估价页面；不构成房地产或财务建议。
  • 安全性： 密钥仅保存在 CRAWLORA_API_KEY 中——切勿硬编码、放入查询参数或提交到版本库。
  • Redfin 的区域 ID 仅适用于该平台 — 首次调用 /redfin/region-trends 前，先通过 /redfin/search 的结果解析区域 ID（结果中包含 region_id）。
  • Zillow 搜索必须提供 region_id（来自 /zillow/autocomplete），不能只提供 location 字符串 — 仅提供 location 会返回 400。
  • 搜索端点支持分页（page）——遍历各页以获取完整结果。

评论

支持 Markdown