租房研究

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install rental-housing-research
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 rental-housing-research。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

租房研究使用 Crawlora StreetEasy 和 Greystar 数据，帮助整理有依据的租房候选清单。它支持 StreetEasy 的纽约市地区房源和市场序列，以及 Greystar 社区和已发现市场中可查询的单套房源，同时明确区分各来源的覆盖范围和位置标识符。
该技能会保留房源身份、价格口径、来源 URL 和采集时间，让比较过程透明。它会区分特定单元的要价与社区起租价、广告租金与市场序列，以及已知费用与未知费用。Openclaw Skills 可利用此工作流程整理研究，但不会申请住房、联系房东、预约看房或付款。

应用场景

根据位置、预算、卧室数量、日期以及必要的配套设施或单元面积要求，整理租房候选清单。
比较纽约市地区的 StreetEasy 租房房源，不要混淆同一栋楼里的不同单元。
浏览 Greystar 社区，并在支持的情况下查看可租单元价格、户型图和租约条款。
将挂牌租金与日期及口径适当匹配的 StreetEasy 市场序列进行比较。
评估广告所示费用时，分别记录总租金、净有效租金、优惠、押金、强制费用和租期。
找出可能改变候选清单排名的缺失或不确定信息，例如未披露的费用或当前空置情况。

工作原理

明确所需地理范围、预算和货币、相关日期、卧室数量，以及明确提出的配套设施或面积要求。
从相应来源发现有效的位置标识符：StreetEasy 区域 ID、Greystar 市场值，或 Greystar 单元位置 slug。不要互换这些标识符体系。
搜索相关来源。查询租金时使用 StreetEasy 租赁搜索；只有在用户要求比较购房或了解市场背景时才使用销售搜索。对于 Greystar，先发现社区并解析出数字格式的物业 ID，再获取物业详情；对于广告中的公寓房源，使用单元位置和单元搜索。
根据返回的房源、单元或楼宇身份查询详情，不要仅凭相似地址推断身份。将页面和 API 调用限制在请求范围及可用额度内。
规范化报价，同时保留不同的价格类型、租约条款以及已知或未知费用。将缺失的价格和空置情况视为未知，而非不存在报价的证明。
比较市场时，匹配数据集、地区、单元、频率、时间段和物业类型。将要价或租金序列与已记录的销售数据及模型指数分开。
提供候选清单，列明经核实的位置和单元身份、价格口径、配套设施、来源和采集时间，以及可能影响排名的问题。根据可比的带日期观测数据及其覆盖范围描述市场变化。

配置指南

设置 Crawlora API 密钥；连接后使用命名的 Crawlora MCP 工具。否则，使用内置 shell 脚本，该脚本会将密钥发送至 Crawlora API。具体工具名称、方法和参数请参阅 reference/endpoints.md。
export CRAWLORA_API_KEY="your-crawlora-api-key"
scripts/crawlora.sh /streeteasy/areas
scripts/crawlora.sh /streeteasy/market-data/catalog
scripts/crawlora.sh /greystar/markets
scripts/crawlora.sh /greystar/search query="New York" page=1 per_page=10
scripts/crawlora.sh /greystar/unit-locations query="austin"
scripts/crawlora.sh /greystar/units location="austin-tx" bedrooms=1 max_price=2500 page=1
搜索租房房源前，先查询 StreetEasy 区域 ID，并提供用户的实际预算及其他条件：
scripts/crawlora.sh /streeteasy/rentals/search area_id="$AREA_ID" max_price="$BUDGET" page=1
除了 HTTP 状态，还要检查应用程序 code；响应内容位于 data 中。遇到身份验证错误时停止；收到 429 响应时退避等待；上游发生暂时性故障时重试一次。将调用次数和页数限制在请求范围及可用额度内。

数据架构

来源和范围：StreetEasy 提供纽约市地区房源和市场序列。Greystar 提供其在已发现市场中的社区，并通过单元搜索提供可租单套房源。保持各来源的覆盖范围相互区分。
位置分类：StreetEasy 区域 ID；Greystar 市场、国家、州、城市和社区值；以及独立的 Greystar 单元位置 slug。这些标识符不可互换。
应保留的身份字段：房源 ID、物业或社区 ID、地址、单元号和来源 URL。根据返回的身份信息查询详情，并谨慎去除跨平台重复房源；同一栋楼里的不同单元仍是不同报价。
价格和报价字段：分别记录月总租金、净有效租金、优惠、社区起租价、特定单元要价、押金、强制费用、租期和售价。仅根据有来源依据的条款计算可比总额；明确标注未知费用。
市场序列元数据：匹配数据集、区域或分组、地区、单元、频率、时间段和物业类型。不要把要价或租金序列与已记录销售数据或模型指数混为同一种趋势。
解读限制：房源快照不能保证房屋空置、申请人符合资格或申请获批。社区起租价不代表某个具体可租单元的价格；按价格筛选的搜索可能遗漏未公布价格的社区。

高级特性

有可用工具时使用命名的 Crawlora MCP 工具，并提供内置的
scripts/crawlora.sh
作为备用方案。
支持 StreetEasy 区域发现、租房和售房搜索以及市场数据目录研究；支持 Greystar 市场和社区发现，以及单元位置和单套房源搜索。
根据端点约定，对数组查询参数重复传递，以支持多个区域或配套设施值。
谨慎执行 API 操作：同时检查 HTTP 状态和应用程序代码；身份验证失败时停止；遇到速率限制时退避等待；上游暂时性故障时重试一次。
区分跨来源标识符、覆盖范围和价格含义，避免误导性比较。
将分页、调用次数和额度使用限制在请求的研究范围内，同时保留来源 URL、标识符和时间戳。
提供有证据支持的候选清单和带日期的市场比较，不执行提交申请、联系房东、预约看房或付款等会产生重大后果的住房操作。

name: rental-housing-research description: Research public rental communities and NYC housing listings or market series through Crawlora StreetEasy and Greystar. Use to build a rental shortlist, inspect buildings or units, compare advertised housing offers, or put NYC asking prices in dated market context.

Rental housing and listing research

Access and contract

Set CRAWLORA_API_KEY to your Crawlora key. Prefer the named Crawlora MCP tools when connected; otherwise use the bundled scripts/crawlora.sh, which sends x-api-key to https://api.crawlora.net/api/v1. Read reference/endpoints.md for exact tool names, methods, and parameters. Check application code as well as HTTP status; payloads are inside data. Stop on authentication errors, back off on 429, and retry a transient upstream failure once. Bound pages and calls by the requested scope and credit budget. Preserve source URLs, identifiers, and collection times.

Build a housing shortlist with location, unit, advertised-price, and source context. StreetEasy supplies NYC-area listings and market series; Greystar supplies its own communities in discovered markets. Keep their scopes distinct.

Discover geography and listing identity

Establish location, budget/currency, dates where relevant, bedrooms, and explicit amenity/size needs. StreetEasy area IDs come from streeteasy_areas; Greystar market/country/state/city/neighborhood values come from greystar_markets. Their location IDs are unrelated. Do not infer resident demographics or neighbourhood suitability from directory content.
Use StreetEasy rental search for monthly asks, and sales search only for a requested purchase comparison or market context. Repeat array query parameters for multiple area/amenity values. Follow returned unit/building identity into detail, rather than guessing a building from a similar street address.
Greystar search returns communities; resolve its numeric property ID before property detail. A community's starting rent is not the price of a particular available unit. Price filters exclude communities without published prices, so an omitted community is not evidence of an absent local offer.
For advertised apartments rather than community summaries, discover the accepted listing locations with greystar_unit_locations, then use greystar_units for available unit-level prices, floor plans, and lease terms. Its location slugs are separate from greystar_markets values, and results are grouped by community.
StreetEasy market-data catalog discovers dataset and area/group choices. Match dataset, region, unit, frequency, period, and property type before comparing series. Asking-price/rent series differ from recorded sales and modelled indices; never merge those into one unlabeled trend. School/building metadata describes the source record, not guaranteed school admission or quality.
Bound pages and retain listing IDs, addresses, unit numbers, source URLs, publication/update times when present, and collection time. Deduplicate cross-posts cautiously; two units in one building remain separate offers.
scripts/crawlora.sh /streeteasy/areas
scripts/crawlora.sh /streeteasy/market-data/catalog
scripts/crawlora.sh /greystar/markets
scripts/crawlora.sh /greystar/search query="New York" page=1 per_page=10
scripts/crawlora.sh /greystar/unit-locations query="austin"
scripts/crawlora.sh /greystar/units location="austin-tx" bedrooms=1 max_price=2500 page=1

# Use discovered area IDs and a user's budget, for example:
# scripts/crawlora.sh /streeteasy/rentals/search area_id="$AREA_ID" max_price="$BUDGET" page=1

Normalize and deliver

Keep gross monthly rent, net-effective rent, concessions, starting prices, unit-specific asks, deposits, mandatory fees, lease duration, and sale prices separate. Compute comparable totals only from returned/sourced terms and show unknown costs explicitly. Missing availability or price is unknown; a listing snapshot does not guarantee vacancy, eligibility, or an accepted application. Return a shortlist with price basis, verified location/unit identity, amenities, source/time, and questions that could change the ranking. For market change claims show comparable dated observations and coverage rather than turning a single listing sample into a citywide trend. Do not submit an application, contact landlords, book tours, or make payments from a research request.

多项目体育赛事研究
足球比赛表现分析