用途:该技能用于构建可对比的短租(Airbnb)市场面板,比较供给、房源密度、房型/房产类型结构、价格分布及评论信号;实况房源示例与市场统计分开处理。
主要能力:通过 Crawlora API 调用聚合数据集。search 返回聚合单元格而非单条房源,group_by 支持 country、market、admin1、locality、room_type、property_type,且这些是互斥分组,不可相加;facets 用于发现国家/市场取值(国家为 ISO alpha-2 代码)。items/{country} 返回国家画像、都市背景及按币种的价格分位数;nearby 返回 geohash 单元格质心与被抑制的聚合计数。可选 /airbnb/search 做小规模、显式采样的实况示例。
使用方式:设置 CRAWLORA_API_KEY,从技能目录或绝对路径运行 scripts/crawlora.sh,请求发往 https://api.crawlora.net/api/v1 并带 x-api-key。示例: scripts/crawlora.sh /datasets/airbnb-markets/search group_by=country page_size=5 sort=listings_desc scripts/crawlora.sh /datasets/airbnb-markets/facets facet=market country=FR 分页 page_size<=100、page*page_size<=10000;遇到 401/403 停止,429 退避,5xx 重试一次。反复采集时保存查询、来源 ID、分页进度与时间戳,便于中断续跑,不要隐式创建监控。
限制与注意:空/被抑制单元格代表证据不可用而非零供给;active_since 是最后出现日期,不代表此后预订;Superhost 与 Guest Favorite 占比是观测下界;avg_person_capacity 仅描述样本;superhost_pct 等已是百分比(31.5 即 31.5%)。价格需保留原币种,price_usd 用近似历史汇率快照,不可对中位数求平均或将不同币种混合。邻近搜索半径与精度须一致,不可汇总重叠半径或把单元格质心当地址。评论片段是样本,日历的不可用日期不能证明预订、入住率、ADR 或收益。实况房源无法通过数据集 ID 与聚合单元格关联。交付物应说明地理范围、筛选口径、观测供给、密度背景、房型结构、价格口径与汇率时点、评论信号、采集日期及抑制/富集限制,并将示例房源单独列出;房源密度本身不能证明需求未被满足、投资回报或短租合法。