RIDB 搜索:查找露营地和设施 - Openclaw Skills

作者:互联网

2026-04-13

AI快讯

什么是 RIDB 搜索?

RIDB 搜索技能允许开发人员和 AI 代理以编程方式查询联邦娱乐信息数据库。通过集成 Openclaw Skills 库中的这项技能,用户可以找到任何地点特定半径范围内的露营地、公园和历史遗迹。它弥合了简单地名与结构化联邦数据之间的鸿沟,提供包括预订状态和直接预订 URL 在内的详细设施信息。

该工具专为精确性而设计,既支持通过地理编码进行自然语言位置查询,也支持基于精确坐标的搜索。无论您是在构建旅游机器人还是数据分析工具,此功能都能确保您直接访问美国最全面的联邦娱乐场所数据库。

下载入口:https://github.com/openclaw/skills/tree/main/skills/seanrea/ridb-search

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install ridb-search

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 ridb-search。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

RIDB 搜索 应用场景

  • 通过查找城市特定半径内的设施来规划露营旅行。
  • 使用 Openclaw Skills 将联邦娱乐数据集成到自定义旅游规划 AI 代理中。
  • 识别可预订的露营地,以便进行自动可用性监控。
  • 对城市名称进行地理编码,以高效查找附近的联邦娱乐资产。
RIDB 搜索 工作原理
  1. 用户提供位置名称(例如 "Bend, OR")或特定的经纬度坐标。
  2. 如果提供了位置名称,该技能将利用 OpenStreetMap/Nominatim 自动将字符串地理编码为坐标。
  3. 向 RIDB API 发送请求,包含指定的搜索半径和可选过滤器(如仅限露营或可预订状态)。
  4. 该技能处理原始 API 响应,并将其格式化为易于阅读的列表或结构化 JSON 对象,以便进一步编程使用。

RIDB 搜索 配置指南

要使用 Openclaw Skills 系列中的此工具,您必须首先获得免费的 RIDB API 密钥。

  1. 在 https://ridb.recreation.gov/profile 注册并生成 API 密钥。
  2. 设置环境变量:
export RIDB_API_KEY=your_key_here
  1. 使用位置名称运行测试搜索:
python scripts/search.py --location "Yosemite Valley" --radius 25 --camping-only

RIDB 搜索 数据架构与分类体系

该技能输出的数据结构旨在方便与其他 Openclaw Skills 集成。JSON 模式包含有关查询的元数据和设施结果数组。

字段 描述
query 包含处理后的纬度、经度和搜索半径。
total_count 在半径范围内找到的设施总数。
facilities 包含 idnamereservable 状态和 recreation.gov url 的对象数组。
id 用于在 recreation.gov 上检查可用性的唯一露营地 ID。
name: ridb-search
description: Search the Recreation Information Database (RIDB) for campgrounds and recreation facilities near a location. Use when finding campgrounds, recreation areas, or federal facilities by location/radius. Supports geocoding (city names) and lat/lon coordinates.

Search recreation.gov's database for campgrounds and facilities near a location.

Setup

Requires a free RIDB API key:

  1. Go to https://ridb.recreation.gov/profile
  2. Sign up and generate an API key
  3. Set environment variable: export RIDB_API_KEY=your_key_here

Usage

Search by location name (auto-geocodes):

python scripts/search.py --location "Bend, OR" --radius 50
python scripts/search.py -l "Yosemite Valley" -r 25 --camping-only

Search by coordinates:

python scripts/search.py --lat 44.0582 --lon -121.3153 --radius 50

Options

Flag Description
--location, -l Location name to geocode (e.g., "Bend, OR")
--lat Latitude (use with --lon)
--lon Longitude (use with --lat)
--radius, -r Search radius in miles (default: 50)
--limit Max results (default: 50)
--camping-only Filter to camping facilities
--reservable-only Filter to reservable facilities
--json Output JSON (for programmatic use)

Output

Human-readable (default):

?? Geocoded 'Bend, OR' to 44.0582, -121.3153

Found 23 facilities within 50 miles
------------------------------------------------------------

???  Tumalo State Park
   ID: 234567 | ? Reservable
   Org: Oregon State Parks
   URL: https://www.recreation.gov/camping/campgrounds/234567

JSON output (--json):

{
  "query": {"latitude": 44.0582, "longitude": -121.3153, "radius_miles": 50},
  "total_count": 23,
  "facilities": [
    {
      "id": "234567",
      "name": "Tumalo State Park",
      "reservable": true,
      "url": "https://www.recreation.gov/camping/campgrounds/234567"
    }
  ]
}

Notes

  • RIDB contains federal recreation data; some state/private campgrounds may not be listed
  • The id field is the campground ID used for availability checks on recreation.gov
  • Radius is in miles (RIDB native unit)
  • Geocoding uses OpenStreetMap/Nominatim (free, no key required)

相关推荐