redfin-mcp

redfin-mcp

将 Redfin 房地产信息接入 Claude 的 MCP 服务——通过自然语言搜索房源、获取房产详情和市场报告，以及查看你保存的房屋和搜索。

⚠️ Redfin 不提供面向公众的消费者 API。此服务使用与 redfin.com 网页应用相同的私有 /stingray/... 端点，并通过 ContextMint Bridge 扩展，经由你已登录的浏览器标签页调用（由 fetchproxy 驱动）。每个请求都通过你现有的会话执行——使用你的 Cookie、TLS 和 JS 上下文——就像你亲自在浏览器中点击一样。请将此视为非正式使用 Redfin 网站。使用风险自负。

工具

工具	用途	按身份验证范围
redfin_search_properties	按位置、价格区间、卧室数／浴室数和房屋类型搜索房源。通过 Redfin 的自动补全解析自由文本，然后查询 gis API。可选的 bounds 会改为搜索地图绘制框内的房源。
redfin_sweep_area	全面枚举经纬度框内的房源：递归划分多边形，直到每个区块的命中数都不再触及 gis 的 350 套上限；在本地去重和筛选，并提供完整性摘要和数据漂移警告。zips 模式则改为扫描 ZIP 区域列表（适用于 Redfin 忽略地图绘制多边形的区域）。房源会直接返回；可选的 output_path 会将其写入 REDFIN_OUTPUT_DIR 内的新 .json 文件（默认为 ~/Downloads/redfin-mcp；绝不覆盖现有文件）
redfin_get_property	按 URL、单独的 property_id，或 property_id+listing_id 获取房屋的完整记录。包括地址、卧室数／浴室数、平方英尺、建成年份、价格、状态、上市天数和主图。
redfin_get_property_photos	获取房屋的完整照片库——包括 CDN 上每张图片的全屏／大／中尺寸版本、缩略图和说明。
redfin_get_market_report	获取区域的成交价／挂牌价中位数、ZHVI 同比变化、平均上市天数和房源库存。
redfin_get_price_history	获取房屋的挂牌历史和税务记录事件——包括挂牌／售出／待成交记录，以及年度评估价值和已缴税款。
redfin_compare_properties	并排比较 2–25 套房屋：地址、价格、卧室数／浴室数、平方英尺、每平方英尺价格、建成年份、状态和上市天数。可选的对齐摘要表。
redfin_bulk_get	单次结构化获取最多 200 套房屋的数据——逐行报告错误、超时后重试一次，并设置整体截止时间（未完成的行会以 pending 返回）。
redfin_get_climate_risk	获取房屋的 First Street Foundation 洪水／火灾／高温风险因素——包括 FEMA 区域、30 年洪水概率序列、保险等级和累积高温预测。
redfin_get_climate_risk_bulk	单次获取最多 100 套房屋的气候风险，保留输入顺序，并提供共享相同评分房屋的 cluster_summary。
redfin_get_area_climate_baseline	根据某区域内 2–10 套样本房屋计算平均气候风险基线；若评分一致，还会返回共享的 cluster_id。
redfin_get_comparable_rentals	获取房屋附近的可比租赁房源——包括月租金、卧室数／浴室数、平方英尺和距离。用于估算租金。
redfin_calculate_affordability	本地负担能力计算器——根据收入、DTI 和利率粗略估算最高购房价格（不联网）。
redfin_get_saved_homes	获取你收藏的房屋——合并所有收藏集，并根据每套房屋的 CDN 标识构建主图 URL。	✓
redfin_get_saved_searches	获取你保存的搜索及其区域 URL 和显示文本。	✓
redfin_calculate_mortgage	本地 PITI 计算器——计算本金和利息、房产税、保险、HOA、PMI（不联网）。
redfin_get_by_address	将自由文本地址解析为 Redfin 的规范 URL 和 home_id。若找不到匹配房源，则返回 resolved: false。依次尝试自动补全、后缀变体，最后进行有界搜索。
redfin_resolve_addresses	批量将最多 100 个地址解析为 Redfin URL 和 home_id，每个输入对应一行。
redfin_healthcheck	端到端桥接检查——往返请求 /robots.txt，并报告失败环节（桥接服务已关闭、扩展程序未关联／配对码待处理，或 Redfin 端问题），同时报告扩展程序关联状态（bridge.session_state、pending_pair_code、extension_connected）。其他工具超时时请调用此工具。
redfin_register_session / redfin_set_active_session / redfin_get_session_context	共享会话注册表——记录桥接标签页登录的 Redfin 账户、在已注册会话间切换，并显示当前活动会话（本地操作；不联网）。

条款确认

使用此 MCP 服务即表示你确认并同意以下内容：

1. 此服务访问的是你自己的 Redfin 会话。 每个请求都会通过 ContextMint Bridge 扩展，经由你自己的浏览器标签页发送——使用你的 Cookie、你的 TLS 和你的会话。此服务不会也无法访问他人的账户。

2. Redfin 的使用条款适用于你对本服务的使用，就像这些条款适用于你直接使用 redfin.com 一样。以下条款与此处最相关：

除非已事先获得适用的 Redfin 公司明确书面许可，否则你不得出于任何目的或以任何方式自动抓取或查询服务（包括但不限于屏幕和数据库抓取、蜘蛛程序、机器人、爬虫，以及任何旨在从服务中获取信息的其他自动化活动）。

以及：“你同意对密码保密，不使用他人的账户，也不允许他人使用你的账户。”

每次调用此服务中的工具，即表示你同意这些条款——维护者于 2026-05-23 阅读了这些条款。Redfin 的条款禁止未经书面许可进行自动抓取，IDX 房源数据仅授权用于个人非商业用途。

3. 仅限个人非商业用途。 本项目与 Redfin Corporation 无关联，未获其认可或赞助，也未与其建立合作关系。它是一个个人自动化工具，会调用与 redfin.com 上点击操作时相同的 /stingray/... 端点。请勿用它批量提取房源、重新分发 IDX 数据、训练 AI 模型、填充竞争性房地产产品，或用于任何商业目的。

4. 不保证稳定性。 此服务会读取 Redfin 的私有内部端点（/stingray/api/gis、/stingray/api/home/details/*、/stingray/api/region/.../market-trends、/myredfin/*），Redfin 可能会在不另行通知的情况下更改这些端点。服务可能会出故障，也可能停止运行。这是有意为之——这些端点并非由 Redfin 委托我们维护。

5. 你须对使用此服务访问 Redfin 所产生的任何后果承担全部责任，包括速率限制、账户停用、IP 封锁、AWS WAF 验证，或 Redfin 采取的任何执法措施。如果 Redfin 对你的使用提出异议，请停止使用此服务。

本节是维护者本着诚信对相关条款所作的摘要，不构成法律建议，也不会修改或取代 Redfin 的实际使用条款（ToU）。

安装

选项 A — npx（首次发布后）

添加到 .mcp.json：

{
  "mcpServers": {
    "redfin": {
      "command": "npx",
      "args": ["-y", "redfin-mcp"]
    }
  }
}

选项 B — 从源代码安装

git clone https://github.com/chrischall/redfin-mcp
cd redfin-mcp
npm install
npm run build

{
  "mcpServers": {
    "redfin": {
      "command": "node",
      "args": ["/path/to/redfin-mcp/dist/bundle.js"]
    }
  }
}

一次性浏览器设置

redfin-mcp 通过 ContextMint Bridge 扩展与浏览器通信。此扩展可供所有基于 fetchproxy 的 MCP（zillow-mcp、opentable-mcp、resy-mcp 等）共用。请从 ContextMint Bridge 发布页安装一次：

• Chrome： 下载 Chrome 压缩包并解压，然后打开 chrome://extensions → 切换至开发者模式 → 加载已解压的扩展程序 → 选择解压后的文件夹。
• Safari： 暂不可用——它将随 ContextMint 应用一同发布，但该应用目前没有公开下载渠道。暂时请使用 Chrome。

ContextMint Bridge 是 fetchproxy 浏览器扩展的新名称，出自同一位维护者——fetchproxy 自己的 README（fetchproxy#extension）指向了该扩展。其源代码公开于 nullnet-app/contextmint-bridge：你可以自行构建，也可以使用发布包旁附带的 .sha256 文件校验发布包（shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256）。

打开 redfin.com 并登录即可。此服务所需的身份验证就这么简单。

工作原理

┌────────────────┐  stdio   ┌──────────────────┐   WS   ┌──────────────────┐    fetch()    ┌─────────────┐
│ MCP client     │◀────────▶│  dist/bundle.js  │◀──────▶│  ContextMint     │◀────────────▶│ redfin.com  │
│ (Claude, etc.) │          │  (Redfin MCP)    │ :37149 │  Bridge          │   (real TLS, │ (your tab)  │
└────────────────┘          └──────────────────┘        │  (separate)      │   cookies)    └─────────────┘

MCP 服务运行在 Node 中，但所有对 redfin.com 的 HTTP 调用都会通过 ContextMint Bridge 扩展，发送到你正在使用的浏览器标签页中。每个请求都使用你现有的会话——TLS 指纹、Cookie 和 JS 执行上下文都与当前屏幕上显示的页面一致。没有无头浏览器替代品，没有单独的身份，也没有第三方代理：只有你的真实浏览器以自身名义执行操作，由 MCP 服务决定请求什么。

Redfin 的 /stingray/... JSON 端点会在 JSON 正文前返回 {}&& 反 CSRF 前缀；客户端会自动将其移除。

命令

npm test               # vitest, mocked transport, no network
npm run test:watch
npm run test:coverage
npm run build          # tsc --noEmit + esbuild bundle → dist/bundle.js
npm run dev            # node dist/bundle.js (after build)

许可证

MIT