listingdata

listingdata

listingdata 是一个轻量的本地桥接服务，连接托管的 HasData Redfin MCP 服务，以 JSON 格式返回 Redfin 房产数据。它可以查询某个地点的待售、出租或已售房源，也可以通过 Redfin URL 获取某处房产的完整信息：地址、挂牌价和成交价及其历史记录、Redfin 估值、卧室和浴室数量、面积和地块面积、建成年份、税务和学校数据，以及页面上公布的挂牌经纪人姓名。

该桥接服务本身不持有任何房源。它在本地返回工具列表，内容与从实时端点捕获的内容完全一致，并将每次工具调用转发到上游，原样返回收到的结果。捕获的接口仅包含对公开房源数据的两项只读查询：不提供预约、报价、联系人信息提取或支付工具。

工具

• hasdata_redfin_listing_getRealEstateListings — 搜索 Redfin 房源。必填参数：keyword（邮政编码、城市、社区、学校、学区、公寓楼名称或完整街道地址）和 type（forSale、forRent 或 sold）。可选筛选条件包括价格和月付款范围、排序方式、房屋类型、卧室和浴室数量、建筑面积、地块面积、建成年份、房源类别和状态、在 Redfin 上的挂牌时长、房屋特征、出租设施和宠物条款、学校评分、步行 / 公交 / 骑行评分，以及用于分页的 page 页码。输入地址或楼宇名称时，返回单个房产卡片，而非列表。返回的房源信息包括地址、Redfin URL、挂牌价、卧室 / 浴室数量、建筑面积、建成年份、挂牌天数、状态、坐标、照片和 MLS 编号。
• hasdata_redfin_property_getPropertyDetails — 获取一处房产的完整信息。必填参数：url（Redfin 房产 URL）。返回地址、挂牌价 / 成交价、价格历史记录、Redfin 估值、卧室 / 浴室数量、建筑面积、地块面积、建成年份、房产类型、HOA、挂牌天数、学校评分、税务历史记录、挂牌经纪人、完整描述、照片和附近的可比房源。

配置

• HASDATA_REDFIN_MCP_URL（可选）— 覆盖上游端点。默认值为 https://mcp.hasdata.com/mcp?apis=redfin。（此覆盖钩子是本次重建自行标注的还原内容。）
• HASDATA_API_KEY（可选）— 设置后，每个上游请求都会携带 x-api-key: <key> 请求头，使用调用者自己的 HasData API 密钥。未设置时，不会发送密钥请求头。（请求头名称和环境变量名称由原始项目的注册记录确定；从此环境变量转发密钥是本次重建自行标注的还原内容——原始接口是在无密钥状态下捕获的。）

转发机制

首次调用工具时，客户端会在上游打开一个可流式传输的 HTTP 会话：发送 JSON-RPC initialize 请求（protocolVersion 为 2025-03-26，clientInfo 名称为 listingdata），然后发送 notifications/initialized 通知，再发送携带调用者原样参数的 tools/call 请求。如果上游在 initialize 响应中返回 Mcp-Session-Id 请求头，该值会随会话的后续每个请求一起发送；此会话会在进程的整个生命周期内重复使用。响应可能以纯 JSON 或服务器发送事件的形式到达，两种形式都会被读取。

上游的成功结果会原样传递，包括上游设置的任何 isError 标记。 故障——JSON-RPC 错误、非 2xx 状态、无法读取的响应，或无法完成的请求——会以 isError 结果返回，其文本以 listingdata error: 开头（此错误呈现方式是本次重建自行标注的还原内容）。

CLI

每个工具也可作为子命令使用，并接受一个 JSON 参数字符串：

npx @reneturcios/listingdata hasdata_redfin_listing_getRealEstateListings '{"keyword":"Austin, TX","type":"forSale"}'
npx @reneturcios/listingdata hasdata_redfin_property_getPropertyDetails '{"url":"https://www.redfin.com/example"}'
npx @reneturcios/listingdata --version

退出代码：成功时为 0，结果为 isError 时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/listingdata mcp

MCP 客户端配置：

{
  "mcpServers": {
    "listingdata": {
      "command": "npx",
      "args": ["-y", "@reneturcios/listingdata", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/listingdata
docker run --rm ghcr.io/cloudcorprecords/listingdata --version

容器的默认命令是 mcp，因此第一种形式会启动 stdio MCP 服务；其他参数则会照常传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全针对桩化的 JSON-RPC 上游运行，不会发起实时网络调用。

许可证

MIT — 详见 LICENSE。