recgov-availability

核心用法

recgov-availability 是一款专门用于查询美国联邦露营地可用性的实用工具。用户通过 Python 脚本直接调用 recreation.gov 官方 API，输入营地 ID、入住日期和住宿天数，即可快速获取空位状态。支持批量查询多个营地，并可通过参数筛选帐篷位、房车位、带电位等特定类型，还能按宠物友好、遮阴、篝火坑等设施条件过滤结果。数据来源权威，覆盖国家公园管理局、林务局、土地管理局等联邦机构管理的营地。

显著优点

该技能最大优势在于零门槛使用——无需申请 API Key，仅需 Python 3.8+ 环境即可运行，且仅依赖标准库，无第三方包安装负担。覆盖范围广泛，涵盖国家公园管理局（NPS）、林务局（USFS）、土地管理局（BLM）及陆军工程兵团管理的所有联邦营地。筛选功能细致入微，支持按车辆长度、电源需求、遮阴条件等实用维度过滤，JSON 输出模式便于二次开发集成。命令行界面简洁高效，适合批量操作和自动化脚本集成。

潜在局限

首先，仅支持联邦营地，州立公园需使用 reserveamerica 等其他工具查询，适用范围存在边界。其次，启用宠物友好、遮阴等高级筛选时会触发额外 API 请求，响应速度明显变慢，影响查询效率。再者，该工具仅提供查询功能，无法直接完成预订操作，用户仍需前往官网手动下单，存在"查到但抢不到"的时间差风险。最后，由于营地热度极高，热门假期空位可能在查询后瞬间被抢订，数据实时性存在局限。

目标群体

适合计划前往美国西部/西北部国家公园（如黄石、优胜美地、冰川公园）进行自驾露营的户外爱好者；需要同时为多人/多车规划行程、批量比对多个营地空位的旅行组织者；以及熟悉命令行操作、希望自动化监控特定日期空位释放的技术型用户。特别适合提前 6 个月预订窗口期开放时，需要快速筛查多个备选营地的重度露营规划者。

使用风险

主要风险包括：网络依赖风险——必须保持与 recreation.gov 的连接，且 API 可能因维护或限流暂时不可用；数据时效性风险——"可预订"状态不代表最终能成功支付锁定，热门营地竞争激烈，查询与预订之间存在时间窗口；查询频率限制——过于频繁的自动化查询可能触发平台反爬机制，建议控制每秒 1-2 次的合理频率；来源维护风险——作为 T3 社区项目，长期更新维护存在不确定性，API 接口变更时可能需等待社区修复。