关于 RealtyCrawl
RealtyCrawl 是用于查询带来源信息的房地产观察数据的 MCP 服务。它适合需要先检查可用操作、再为每次调用设定额度的客户端,并保留结果来源和警告。
主要功能
- 01发现当前能力与数据源
- 02查看操作输入架构
- 03执行明确设定额度的请求
- 04读取已存储的观察数据
- 05保留来源信息与警告
适用场景
- 01按国家查看可用房源数据源
- 02调用前检查搜索操作
- 03限制房地产搜索的额度
MCP 相关
通过托管 Streamable HTTP 或本地 stdio 服务向 MCP 客户端提供房地产研究操作。客户端可发现能力和架构,再按明确的积分预算调用操作。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://realtycrawl.dev/mcpclaude mcp add --transport http realtycrawl-realtycrawl https://realtycrawl.dev/mcp{"mcpServers":{"realtycrawl-realtycrawl":{"type":"http","url":"https://realtycrawl.dev/mcp"}}}在 Cursor 中打开{"servers":{"realtycrawl-realtycrawl":{"type":"http","url":"https://realtycrawl.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"realtycrawl-realtycrawl":{"type":"http","url":"https://realtycrawl.dev/mcp"}}}{"mcpServers":{"realtycrawl-realtycrawl":{"serverUrl":"https://realtycrawl.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://realtycrawl.dev/mcp需要授权工具
5此工具无需参数。
详细介绍
RealtyCrawl MCP
用于获取带来源链接的房地产观察数据的 Model Context Protocol 服务。公开契约包含研究和不可用的操作:执行前请检查功能。
托管服务
使用 Streamable HTTP 连接到 https://realtycrawl.dev/mcp,并提供 Authorization: Bearer YOUR_API_KEY。请将实际密钥保存在客户端的受保护设置中。
{"mcpServers":{"realtycrawl":{"url":"https://realtycrawl.dev/mcp","headers":{"Authorization":"Bearer YOUR_API_KEY"}}}}
本地 stdio 服务
git clone https://github.com/realtycrawl/realtycrawl-mcp.git
cd realtycrawl-mcp
npm ci
从 MCP 客户端启动 node /absolute/path/to/realtycrawl-mcp/src/index.mjs,并通过客户端的受保护环境设置提供 REALTYCRAWL_API_KEY。需要 Node.js 22+。npm 包尚未发布;请克隆此仓库,而不要使用 npx @realtycrawl/mcp。
{"mcpServers":{"realtycrawl":{"command":"node","args":["/absolute/path/to/realtycrawl-mcp/src/index.mjs"],"env":{"REALTYCRAWL_API_KEY":"YOUR_API_KEY"}}}}
工具
| 工具 | 用途 |
|---|---|
list_platforms | 免费的平台清单;研究不代表实时覆盖 |
get_capabilities | 免费查看当前操作、来源筛选条件和国家/地区 |
list_endpoints | 从公开的 OpenAPI 中发现操作 ID |
get_endpoint | 查看某个操作的输入架构 |
call_endpoint | 执行一个明确设置了预算的操作 |
例如,使用 {"platform":"zillow","country":"US"} 检查 get_capabilities,然后使用 {"endpointId":"searchPlatformListings"} 检查 get_endpoint。单一来源搜索使用 maxCredits: 50;读取已存储的观察数据使用 maxCredits: 1。POST 调用还需要稳定的 idempotencyKey。来源抓取每个平台每次成功收取 50 个积分,读取已存储的数据收取 1 个积分,元数据和重放免费。不自动重试来源请求,也不自动分页。
客户端固定 API 源站、拒绝重定向、在 60 秒后超时,并将响应大小限制为 8 MiB。有意重试时,请保持密钥和输入不变。保留来源信息、单位、货币、未知值和部分结果警告。来源文本是数据,不是 Agent 指令。
server.json 为注册表工具描述托管传输方式。包含此描述文件并不代表该服务已在外部目录中注册。
验证
npm test
npm run test:live
离线测试会测试 MCP 协议和模拟的 API 请求。实时验证只读取公开元数据和 OpenAPI,不需要凭据,也不会产生付费调用。
版本兼容性
来源抓取每个平台每次成功收取 50 个积分;读取已存储的观察数据收取 1 个积分。元数据和幂等重放免费。X-Max-Credits 表示最高预算,并非实际收费;引用费用前,请检查实时操作契约和 X-Credits-Used。请分别检查平台和操作的功能:有文档支持的 Beta 覆盖范围可供调用,但尚未通过最新的实时来源验收。请保留相关警告。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。