RealtyAPI Skills 是房产研究技能集，把 RealtyAPI REST API 包装成 6 个 Claude Code 可加载技能——房源简报、listing 检索、租赁市场调研、CMA 可比市场分析、投资机会筛选、经纪人查找，覆盖 Redfin/Realtor/Zillow/Rightmove/zoopla/Idealista/Property Finder/Domain 等 30+ 全球房产门户。适合房产经纪人、投资人和研究者用 Agent 自动出房产研究产物。
RealtyAPI Skills（realtyapi/realtyapi-skills）是把房产研究流程打包成 6 个 Claude Code 可加载技能的合集：realtyapi-api（API 路由层）、property-research（单房源简报）、listing-search（按区域检索房源）、rental-market-research（租赁市场调研）、comparative-market-analysis（CMA 可比市场分析）、investment-deal-finder（止赎/折扣/出租收益机会筛选）、agent-finder（经纪人查找）。它覆盖全球 30+ 房产门户：美国 Redfin / Realtor / Zillow / Trulia / Homes.com / Apartments.com；英国 Rightmove / Zoopla；欧洲 Idealista / SeLoger / Funda；中东 Property Finder；澳洲 Domain；加 Airbnb / Vrbo。一个 API key 通吃。
RealtyAPI Skills 关键词自然分布：RealtyAPI、房产研究 skill、CMA 可比市场分析、Redfin 房产研究、Zillow 房源、Rightmove 房产、Idealista 房源、Property Finder、Domain 房产、投资机会筛选、经纪人查找、Claude Code 房产、MIT 协议房产研究。H2/H3 段落覆盖核心与长尾关键词。
RealtyAPI Skills 是"房产研究 workflow-first 工具"。它和"自己写 prompt 让 Agent 查 Zillow"的核心区别是：把"取数"统一走 RealtyAPI REST API（同一 schema 适配多门户），Agent 只负责"用这些数据做研究"。它强调 Workflow-first, API-second：用户问"做 CMA 报告"，不是"调用哪个 API"。
第一步：环境准备。Claude Code 2.0+ / Cursor / Codex / GitHub Copilot / Gemini CLI / Windsurf / VS Code 任一支持 Agent Skills 标准的 Agent，Node.js 18+，RealtyAPI key（从 realtyapi.io 注册获取）。
第二步：安装。
npx skills add realtyapi/realtyapi-skills
# 或手动：
git clone https://github.com/realtyapi/realtyapi-skills.git ~/.claude/skills/realtyapi第三步：配置环境变量。
export REALTYAPI_API_KEY=rt_...
# 加入 ~/.bashrc / ~/.zshrc 持久化第四步：第一次跑通。
# 在 Claude Code 里：
"用 property-research 给我看 ACME 在 Zillow 上的房源详情"
[Agent 自动加载 property-research skill → 调 RealtyAPI → 输出房源简报]验证标准：第一次触发应在 10 秒内出房源简报（address / price / details / history / value / comps / neighborhood）。
**场景 A：单房源 CMA 报告**。
"对 166 W 22nd St Unit 1D, New York, NY 10011 做 CMA，给出价值区间"
[Agent 加载 comparative-market-analysis skill]
> 输出: CMA 报告（comp 列表 / 价格区间 / 估值理由 / 信心度）**场景 B：投资机会筛选**。
"在 Cuyahoga County 找 25 万美元以下的止赎和降价房源，按 equity 排序"
[Agent 加载 investment-deal-finder skill → 查 Redfin + Zillow]
> 输出: 排序后的候选房源（地址 / 标价 / 估值 / equity / 风险）**场景 C：租赁市场调研（海外）**。
"里斯本中心 2 房长租每月多少钱？租金在涨吗？"
[Agent 加载 rental-market-research skill → 查 Idealista + Property Finder]
> 输出: 长租选项 / 价格区间 / 趋势（同比 / 环比）裸 prompt 让 Agent 查 Zillow 经常返回过时数据、错位结构、"该地址无 listing"的猜测。RealtyAPI 把"取数"统一走 REST API，Agent 只负责"用这些数据做研究"。
列表类是"工具目录"，告诉你哪个 API / 哪个数据源好用；RealtyAPI Skills 是"Agent 工作流"——SKILL.md 直接教 Claude Code "拿到一个 Redfin URL 应该做什么、输出格式是什么、引用来源怎么写"。
能（comparative-market-analysis），但产物是"估值区间 + 信心度"，不是"该地址值 100 万美元"的断言。所有产物都是"研究起点"——签约、估值、决策仍需人工本地经纪人 / 律师复核；公开数据不代表 MLS 私有字段。
适合：(a) 美国本地房产经纪人——快速出 CMA / 房源简报；(b) 海外房产投资人——跨门户对比做组合配置；(c) 房产科技创业者——给买家 / 卖家做自助研究；(d) 学术研究——做住房市场数据自动化分析。
故障排除：
1. **`REALTYAPI_API_KEY` 未设置**：Agent 提示"401 Unauthorized"——检查 env 变量是否在当前 shell 生效；Claude Code 用 `env REALTYAPI_API_KEY=...` 启动。
2. **某个门户无数据**：Zillow 在部分国家无服务，agent 自动跳到下一个门户；或手动指定 `--portal idealista`。
3. **CMA 估值偏差大**：检查 comp 数量（< 3 个会偏高估）；用 `--min-comps 5` 强制至少 5 个 comp。
4. **止赎数据滞后**：止赎有 24-48 小时延迟，按 `--freshness 7d` 限一周内数据。
5. **经纪人查找返回空**：经纪人门户覆盖有限，海外经纪人主要来自 Rightmove / Domain，US 主要来自 Zillow / Realtor.com。
MIT 协议，免费。注意：所有产物都是"研究起点"——最终决策需人工本地经纪人 / 律师复核。
> **michael 用户告知**: 本 Skill 在 AIMS 平台使用平台已支持的真实大模型（与原 README 推荐对照）
| 项 | 说明 |
|---|---|
| **原仓库 README 推荐** | Claude Code / GPT (REALTYAPI_API_KEY 数据查询) |
| **AIMS 平台实际使用** | **`gpt-4.1`** |
| **AIMS 平台可用替代** | claude-sonnet-4.6 / gpt-5 |
| **对齐度** | 高度一致 (Claude / GPT 都支持) |
> 💡 **如何切换模型**: 使用 AIMS `aims.update_skill` 传 `skill_id + model_name + call_price_fen` 即可在上述任意支持的模型间切换（短 id 直接传，无需前缀）。
裸 prompt 让 Agent 查 Zillow 经常返回过时数据、错位结构、"该地址无 listing"的猜测。RealtyAPI 把"取数"统一走 REST API，Agent 只负责"用这些数据做研究"。
列表类是"工具目录"，告诉你哪个 API / 哪个数据源好用；RealtyAPI Skills 是"Agent 工作流"——SKILL.md 直接教 Claude Code "拿到一个 Redfin URL 应该做什么、输出格式是什么、引用来源怎么写"。
能（comparative-market-analysis），但产物是"估值区间 + 信心度"，不是"该地址值 100 万美元"的断言。所有产物都是"研究起点"——签约、估值、决策仍需人工本地经纪人 / 律师复核；公开数据不代表 MLS 私有字段。