用途:研究公开租赁社区与纽约市(NYC)房源或市场序列,帮助构建租房候选清单。数据来自 Crawlora 的 StreetEasy 与 Greystar 接口,两者范围需保持区分:StreetEasy 提供 NYC 地区房源与市场序列,Greystar 提供其自身在已发现市场中的社区。
接入方式:设置 CRAWLORA_API_KEY。已连接时优先使用 Crawlora MCP 工具;否则使用随附的 scripts/crawlora.sh,它向 https://api.crawlora.net/api/v1 发送 x-api-key。具体工具名、方法与参数见 reference/endpoints.md。需同时检查 HTTP 状态与应用代码,数据在 data 内。认证错误应停止,429 应退避,瞬时上游失败可重试一次。按请求范围与额度预算限制分页和调用次数,保留来源 URL、标识与采集时间。
主要能力:先确定地点、预算/币种、日期、卧室数与明确的设施/面积需求。StreetEasy 区域 ID 来自 streeteasy_areas;Greystar 的市场/国家/州/城市/社区值来自 greystar_markets,两者位置 ID 无关。StreetEasy 租赁搜索用于月租报价,销售搜索仅用于被请求的购买对比或市场背景。Greystar 搜索返回社区,需先解析数字物业 ID 再查详情;社区起始租金不等于具体可租房源价格,价格筛选会排除未公布价格的社区。要获取广告公寓而非社区摘要,先用 greystar_unit_locations 发现可接受的位置,再用 greystar_units 获取可租房源价格、户型与租约条款。
使用示例:scripts/crawlora.sh /streeteasy/areas;scripts/crawlora.sh /greystar/search query="New York" page=1 per_page=10;scripts/crawlora.sh /greystar/units location="austin-tx" bedrooms=1 max_price=2500 page=1。
限制:不得从目录内容推断居民人口特征或社区适宜性;学校/建筑元数据仅描述来源记录,不保证入学或质量。缺失的可租状态或价格为未知,房源快照不保证空置、资格或申请被接受。不得提交申请、联系房东、预约看房或付款。市场变化结论需基于可比的带日期观测与覆盖范围,不能由单个房源样本推断全市趋势。