使用说明

一、采集 Zillow 搜索列表

第一步：在 Zillow 中选好房源

1. 打开小应用，选择 「搜索列表」。
2. 点击 「打开 Zillow」。
3. 在打开的 Zillow 窗口中搜索城市或区域。
4. 设置租售类型、价格、卧室数量等筛选条件。
5. 等待房源列表加载完成，确认结果符合你的需要。

请使用小应用通过「打开 Zillow」按钮打开的窗口。普通浏览器中的搜索条件不会自动同步到小应用。

第二步：回到小应用开始采集

1. 返回小应用。
2. 根据需要选择是否勾选 「同时采集完整详情」：
   • 不勾选：只采集列表信息，速度更快。
   • 勾选：先保存列表，再逐套补充详细资料，耗时更长。
3. 点击 「使用当前 Zillow 搜索」。

应用会新建一条采集记录，并使用当前网页的搜索条件开始采集，不会重新按关键词搜索。

---

二、采集单个住宅或公寓详情

1. 在 Zillow 中打开你需要的住宅或公寓详情页。
2. 复制浏览器地址栏中的完整网址。
3. 返回小应用，选择 「单个房源」。
4. 粘贴网址，点击 「采集房源详情」。

此模式会直接采集详情，无需先采集搜索列表，也无需额外勾选详情选项。

支持的常见页面

• 普通住宅详情：https://www.zillow.com/homedetails/…
• 公寓楼盘详情：https://www.zillow.com/apartments/…

其他入口或跳转链接会根据实际页面结构识别。搜索列表页、登录页、未解析的分享短链以及尚未支持的页面模板，可能无法用于单房源采集。

公寓资料如何保存？

公寓页面可能包含多个户型和可租单元。应用会分别保存：

• 楼盘概况：名称、地址、描述、设施、图片链接等。
• 户型资料：户型名称、床卫、面积、价格范围等。
• 单元资料：单元名称、对应价格、面积、可入住时间等。

楼盘显示的价格和面积范围是独立汇总值，不能组合成一套具体房源。查看具体租金和面积时，应以对应单元的数据为准。

---

三、暂停、继续和补充详情

暂停采集

在 「当前采集任务」 区域点击 「暂停采集」。已保存的房源和进度会保留。

继续采集

点击 「继续采集」，应用会使用当前任务保存的条件和进度继续处理。

「继续采集」用于恢复已有任务；「使用当前 Zillow 搜索」用于新建任务。想接着上次处理时，不需要重新新建采集。

补充详情

如果之前只采集了列表，可在任务暂停或列表处理结束后，点击 「补充本次采集详情」，为已保存房源补充资料。

详情中找到的有效信息会用于补齐基础表格和导出内容；源站未提供的信息不会被猜测或伪造。

---

四、查看采集结果

在 「我的房源」 区域：

• 选择 「全部记录」，查看全部已保存房源。
• 选择某条 「采集记录」，只查看该次采集的结果。
• 点击房源地址，查看已保存的详细资料。

应用不提供本地价格、户型等筛选控件。需要进一步筛选、排序或分析时，可先导出 CSV，再使用表格工具处理。

如何理解状态？

状态	含义
未采集／待采详情	尚未获取详情
尚未完成	详情处理尚未完成
采集失败／获取失败	请求或处理失败，可稍后重试
页面暂未支持	当前页面结构尚不能正确解析
等待验证或重试	遇到网站验证或访问限制，等待恢复
未发现提供	在已成功解析的内容中没有找到该信息，并不代表已检查网站所有栏目

如果重新采集失败，之前成功保存的详情会保留，并显示相应提示。

---

五、导出数据

1. 暂停正在进行的采集。
2. 在 「采集记录」 中选择要导出的记录，或选择 「全部记录」。
3. 点击 「导出 CSV」。
4. 按提示选择保存位置。

导出包含所选范围的全部已保存数据，不限当前显示的一页。

根据采集内容，导出结果可能包含：

文件	内容
房源.csv	房源基础信息、状态及已采集的详情
户型与单元.csv	公寓户型和具体单元明细，仅在存在相应数据时生成

英文界面对应的文件名为 Properties.csv 和 Floor plans and units.csv。

导出只使用已保存的数据，不会自动访问 Zillow 或补采缺失详情。

---

六、删除采集记录

1. 暂停正在进行的采集。
2. 在 「采集记录」 中选择一条具体记录。
3. 点击 「删除记录」。
4. 核对删除范围，并输入弹窗显示的确认文字。
5. 点击最终删除按钮。

删除后：

• 该记录、剩余进度及详情任务会被清理。
• 只属于该记录的房源及详情会被删除。
• 其他记录引用的共享房源会保留。
• 已经导出的文件不受影响。

删除不可撤销，建议先导出备份。 “全部记录”不能通过此按钮一次性删除。

---

七、遇到验证或访问限制怎么办？

Zillow 可能要求验证，或暂时限制请求频率。应用会按照有限重试策略尝试恢复，并显示当前状态。

需要人工处理时：

1. 点击 「打开 Zillow」。
2. 根据网页提示完成验证。
3. 返回小应用，点击 「检查并继续」。

等待期间可点击 「暂停采集」。不要反复新建任务或连续重复提交同一操作。

---

使用须知

• 图片仅保存 URL，不下载图片文件。
• 房源描述、地址、楼盘名称等保留源站原文，不会因界面语言变化而自动翻译。
• 网站报告的结果数不一定等于可采集的独立房源数，租房统计还可能包含楼盘内的多个单元。
• “已确认页数”与“累计请求次数”含义不同；重试和历史请求不会被当作新的有效页面。
• Zillow 的分页上限、访问限制、页面结构和实时数据变化都可能影响采集结果，不保证完整覆盖全部房源。
• 应用不会自动判定“短租一定带家具”，也不会自动执行尚未配置的公司公寓或低佣金房源排除规则。
• 使用时请遵守网站条款及适用法律，合理控制采集范围与频率。