airbnb-search

airbnb-search 是一个基于 Python 的命令行工具，允许用户通过简单的 CLI 指令搜索 Airbnb 房源信息。用户无需注册 Airbnb 开发者账号或获取 API 密钥，工具内置了 Airbnb 网站前端使用的公开 API 密钥，可直接查询房源价格、评分、卧室数量及预订链接。支持通过 uv 工具直接运行而无需安装，提供入住/退房日期、价格区间、卧室数量等多维度筛选，输出支持表格和 JSON 两种格式，便于脚本集成或人工阅读。

该工具最大优势在于零配置开箱即用，消除了获取 API 密钥的门槛，适合临时性查询需求。采用硬编码的公开 API Key 意味着与 airbnb.com 网站相同的数据源，数据实时性和准确性有保障。灵活的参数系统支持精准筛选，而双模式输出（表格/JSON）既满足终端用户的可视化需求，也方便开发者进行数据分析和自动化处理。MIT 许可证保证了代码的可审计性和二次开发自由度。

潜在缺点主要集中在稳定性和合规性层面。工具依赖 Airbnb 内部 GraphQL API，一旦 Airbnb 更改接口结构或密钥失效，工具将立即失效。硬编码 API Key 虽然公开，但可能违反 Airbnb 服务条款中的自动化抓取限制，存在法律合规风险。作为 T3 级别的个人项目，长期维护承诺和更新响应速度存在不确定性。此外，功能仅限于搜索展示，不支持预订、支付或查看房东联系方式等后续操作。

该工具主要面向频繁规划旅行的数字游民、背包客及旅行博主，以及需要批量比较多个目的地住宿选项的用户。CLI 爱好者和开发者可通过 JSON 输出将房源数据集成到自动化工作流或旅行规划脚本中。对于需要快速获取市场价格数据以进行分析的研究人员或小型旅行社也是实用工具。不适合普通消费者作为日常预订工具，因其缺乏图形界面和直接预订功能。

使用风险方面，过度频繁的查询可能触发 Airbnb 的速率限制（rate limiting），导致临时封禁。依赖风险体现在单一外部 API 依赖，无本地缓存或备用方案。合规风险包括可能违反 Airbnb 服务条款关于自动化访问的规定。虽然当前代码无恶意行为，但作为个人维护项目，需警惕未来更新中可能引入的安全风险。