用途:该技能驱动 apartments-pp-cli 二进制,用于获取结构化的 Apartments.com 租房数据,并完成网站本身不开放的工作流,如跨搜索的时间差对比、每平方英尺与总居住成本排序、多 slug 合并查询、并排比较和摘要汇总。适合搬迁跟踪、候选清单性价比筛选、租赁代理周报等需要 JSON 与离线组合的场景;一次性浏览不建议使用,网站本身即可。
主要能力:watch 对比某已存搜索的两次同步,输出新增、移除、价格变动;drops 列出租金降幅达阈值以上的房源;stale 标记 N 天价格与可租状态未变的房源;phantoms 通过三重信号(重取 404、从已存搜索消失、过期≥45 天)识别疑似失效房源;history 返回单个房源的时间序列;nearby 跨多个城市、邮编或社区合并为去重排序列表;value 按 12 个月总成本(租金+宠物租金+宠物押金+宠物费)排序;rank 按每平方英尺或每个卧室比率排序;floorplans 按户型排序;must-have 用 FTS5 筛选包含全部指定设施的房源;compare 将 2–8 个房源转为宽表并计算每平方英尺与设施重叠;digest 一次性汇总新增、移除、降价、性价比前五、过期与失效标记;shortlist 维护本地候选清单;market 给出租金与租金/平方英尺的中位数、p10、p90 及宠物友好比例。
使用方式:需先安装 CLI,可用 npx -y @mvanhorn/printing-press-library install apartments --cli-only,或回退 go install github.com/mvanhorn/printing-press-library/library/other/apartments/cmd/apartments-pp-cli@latest(需 Go 1.26.6 或更新),并用 apartments-pp-cli --version 验证。任意命令加 --agent 会展开为 --json --compact --no-input --no-color --yes;--select 可裁剪字段;--deliver 支持 stdout、file:<path>、webhook:<url>。可用 which 将自然语言能力查询映射到命令,用 doctor 检查配置。无需认证。
限制:该 CLI 为只读,不得用于创建、更新、删除、发布、评论、点赞、邀请、下单、发送消息、预订或购买等改动远程状态的操作。Apartments.com 存在机器人检测,stdlib HTTP 会返回 403,需用带 Chrome TLS 指纹的传输;未来可能升级为需要 Chrome 放行 Cookie 或整浏览器回退。Freshness 仅覆盖已注册的本地存储读取路径,--data-source local 不刷新,--data-source live 不写本地。Webhook 失败会返回非零并在 stderr 记录 URL 与 HTTP 状态。反馈默认仅本地保存于 ~/.apartments-pp-cli/feedback.jsonl。