propdata

Name: propdata
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords商业与营销01 周前更新

代码仓库

关于 propdata

propdata 是通过 APIllow API 获取 Zillow 房产数据的 MCP 服务和命令行工具。它支持房屋搜索、房产查询、挂牌状态检查及账户用量查看。

主要功能

01按城市或 ZIP code 搜索
02按 ID、URL 或地址查询房产
03批量查询多个地址
04检查当前挂牌状态
05查看 API 配额和套餐详情

适用场景

01搜索某城市或 ZIP code 的房产
02获取房产及销售历史
03检查地址是否有在售房源
04监控 API 用量和配额

MCP 相关

向 MCP 客户端提供九种工具，用于房产搜索、单项及批量查询、挂牌检查、注册和用量查询。房产数据由 APIllow 返回并直接传递。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y @reneturcios/propdata

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/propdata0.1.0stdio

ocighcr.io/cloudcorprecords/propdata:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
type	string	否	房源类型，例如 sale。
query	string	是	要搜索的城市或地区，例如 Austin TX。
max_items	integer	否	返回的最大结果数。

详细介绍

propdata

通过 APIllow API 获取 Zillow 房产数据：按城市或 ZIP 代码搜索房屋，使用 Zillow ID、房源 URL 或街道地址查询单处房产，在一次调用中查询多个地址，检查哪些地址当前有在售房源，创建免费账户，并查看每月配额的剩余量。

房产信息来自上游服务，并会原样传递，因此房产记录包含 APIllow 返回的内容——标识符、地址、状态和类型、卧室和浴室数量、居住面积和土地面积、建成年份、价格和估值、销售和税费历史、少量相似房屋、照片以及附近的学校。

此处提供九个工具。上游目录中还有第十个工具—— 一个唯一输出为付款链接的套餐升级助手——本软件包有意不包含该工具。

这九个工具：

search_properties — 按城市或地区搜索，可选择房源类型并限制返回结果的数量。
search_by_zip — 按一个或多个 ZIP 代码搜索。
get_property — 根据 Zillow 房产 ID 查询单处房产。
get_property_by_url — 根据 Zillow 房源 URL 查询单处房产。
get_property_by_address — 根据街道地址查询单处房产。
get_properties_by_addresses — 在一次请求中查询多个街道地址。
check_addresses — 检查一组地址中哪些有有效的 Zillow 房源，并返回房源 URL。
signup — 创建免费账户；验证后，API 密钥会通过电子邮件发送。
check_usage — 当前用量、配额和套餐详情。

配置

export APILLOW_API_KEY="..."   # required for every tool except signup
export APILLOW_BASE_URL="https://apillow.co/api"   # optional override

如果没有密钥，除 signup 以外的所有工具都会失败，并显示 APILLOW_API_KEY is not set，且不会进行任何参数检查。密钥会通过 X-API-Key 标头发送至 API。

CLI

每个工具都是一个子命令，接受一个 JSON 参数字符串：

npx @reneturcios/propdata search_properties '{"query":"Austin TX","type":"sale","max_items":10}'
npx @reneturcios/propdata search_by_zip '{"zip_codes":[90210]}'
npx @reneturcios/propdata get_property '{"zpid":12345678}'
npx @reneturcios/propdata check_usage '{}'
npx @reneturcios/propdata --version

输出为上游 JSON，并原样打印。退出代码：成功时为 0，运行时出错（包括验证失败或上游故障）时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/propdata mcp

MCP 客户端配置：

{
  "mcpServers": {
    "propdata": {
      "command": "npx",
      "args": ["-y", "@reneturcios/propdata", "mcp"],
      "env": {
        "APILLOW_API_KEY": "..."
      }
    }
  }
}

Docker

docker run -i -e APILLOW_API_KEY="..." ghcr.io/cloudcorprecords/propdata
docker run --rm -e APILLOW_API_KEY="..." ghcr.io/cloudcorprecords/propdata check_usage '{}'

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch, no network)
npm run dev     # run the CLI from source