{"ok":true,"site":"nps","host":"nps.gov","about":"National Park Service (nps.gov): find parks by state, activity, topic or location; read park details, alerts, parking and conditions; search articles and multimedia; get photo metadata, video captions and NWS weather for parks.","commands":[{"command":"search-parks","summary":"Find National Park Service units, filtered by state, activity or topic, or sorted by distance from a lat/lng point","params":[{"name":"states","type":"string","description":"Two-letter state code(s), comma-separated, e.g. CA or CA,NV (see list-park-filters)"},{"name":"activities","type":"string","description":"Activity id(s), comma-separated, e.g. 3 = Arts and Culture (ids from list-park-filters)"},{"name":"topics","type":"string","description":"Topic id(s), comma-separated (ids from list-park-filters)"},{"name":"lat","type":"number","description":"Latitude of a search point (use with lng and sort='distance asc')"},{"name":"lng","type":"number","description":"Longitude of a search point"},{"name":"sort","type":"string","description":"Sort order. Use 'distance asc' only when lat/lng are given","oneOf":["name asc","distance asc"],"default":"name asc"}],"exampleUrl":"https://clify-dev.netlify.app/nps/search-parks?states=CA&activities=3&topics=125&lat=37.84835&lng=-119.55696"},{"command":"search-parks-by-name","summary":"Search parks by name or keyword (e.g. 'Yosemite') and get park codes, descriptions and coordinates","params":[{"name":"q","type":"string","required":true,"description":"Park name or keyword"},{"name":"pageSize","type":"number","description":"Maximum number of results","default":4}],"exampleUrl":"https://clify-dev.netlify.app/nps/search-parks-by-name?q=Yosemite"},{"command":"list-park-filters","summary":"List all filter values for search-parks: topic ids, activity ids, state codes, and every park code with its name","params":[],"exampleUrl":"https://clify-dev.netlify.app/nps/list-park-filters"},{"command":"list-related-subjects","summary":"Get NPS subject/topic pages related to a set of activity and topic ids, with the park codes linked to each","params":[{"name":"activities","type":"string","description":"Activity id(s), comma-separated"},{"name":"topics","type":"string","description":"Topic id(s), comma-separated"},{"name":"randomcount","type":"number","description":"Number of subjects to return","default":4}],"exampleUrl":"https://clify-dev.netlify.app/nps/list-related-subjects?activities=3"},{"command":"get-park","summary":"Get a park's overview (schema.org linked data): description, phone, address, visitor centers and opening hours","params":[{"name":"code","type":"string","required":true,"description":"Lowercase 4-letter park code, e.g. jotr, yose"}],"exampleUrl":"https://clify-dev.netlify.app/nps/get-park"},{"command":"get-park-facilities","summary":"Get a park's structured operational data: addresses plus parking lots with capacity, live status, schedules and predicted occupancy","params":[{"name":"code","type":"string","required":true,"description":"Lowercase 4-letter park code"}],"exampleUrl":"https://clify-dev.netlify.app/nps/get-park-facilities"},{"command":"get-park-alerts","summary":"Get current alerts for one park: closures, road closures, cautions and information","params":[{"name":"code","type":"string","required":true,"description":"Lowercase 4-letter park code"}],"exampleUrl":"https://clify-dev.netlify.app/nps/get-park-alerts"},{"command":"list-nps-alerts","summary":"List the nationwide sitewide alerts for all parks (closures, dangers, information) with park and state","params":[],"exampleUrl":"https://clify-dev.netlify.app/nps/list-nps-alerts"},{"command":"get-park-banner-image","summary":"Get a park's banner photo: image path, credit, alt text and crops","params":[{"name":"sitecode","type":"string","required":true,"description":"Lowercase park code"}],"exampleUrl":"https://clify-dev.netlify.app/nps/get-park-banner-image?sitecode=jotr"},{"command":"search-multimedia","summary":"Search NPS photos, videos, audio and webcams by keyword, with optional Solr filter (type, park) and sort","params":[{"name":"q","type":"string","description":"Keywords; '*' matches everything","default":"*"},{"name":"fq","type":"string","description":"Extra Solr filter, e.g. Type:\"Video\", Type:\"Photo\", Parks_Item:\"Yellowstone National Park\" (full park name). Combine with AND"},{"name":"sort","type":"string","description":"Sort order","oneOf":["Date_Last_Modified desc","score desc","Date_Taken desc"],"default":"Date_Last_Modified desc"},{"name":"start","type":"number","description":"Result offset (20 per page)","default":0}],"exampleUrl":"https://clify-dev.netlify.app/nps/search-multimedia?q=grizzly+bear&fq=Parks_Item%3A%22Yellowstone+National+Park%22&sort=score+desc"},{"command":"search-articles","summary":"Search NPS articles, people and places pages by keyword (returns /articles/... URLs)","params":[{"name":"q","type":"string","required":true,"description":"Keywords or Solr query, e.g. campfire or \"National Park Week\""},{"name":"rows","type":"number","description":"Results per page","default":10},{"name":"start","type":"number","description":"Result offset","default":0}],"exampleUrl":"https://clify-dev.netlify.app/nps/search-articles"},{"command":"get-article","summary":"Read an NPS article page by slug (/articles/{slug}.htm)","params":[{"name":"slug","type":"string","required":true,"description":"Article slug from the PageURL, e.g. campfires"}],"exampleUrl":"https://clify-dev.netlify.app/nps/get-article"},{"command":"get-photo","summary":"Get NPGallery photo/asset metadata: title, description, credit/copyright, license, dimensions and EXIF","params":[{"name":"id","type":"string","required":true,"description":"Asset GUID (the id= value from /media/photo/view.htm?id=...)"}],"exampleUrl":"https://clify-dev.netlify.app/nps/get-photo"},{"command":"get-video-captions","summary":"Download the WebVTT closed-caption transcript of an NPS video","params":[{"name":"id","type":"string","required":true,"description":"Video media GUID"}],"exampleUrl":"https://clify-dev.netlify.app/nps/get-video-captions"},{"command":"geocode-suggest","summary":"Get place suggestions for a location string, with magicKeys to resolve into coordinates (US only)","params":[{"name":"text","type":"string","required":true,"description":"Place, city or address text"},{"name":"maxSuggestions","type":"number","description":"Max suggestions","default":4}],"exampleUrl":"https://clify-dev.netlify.app/nps/geocode-suggest?text=Yosemite"},{"command":"geocode-location","summary":"Resolve a geocode-suggest magicKey into lat/lng (location.y / location.x) for search-parks","params":[{"name":"magicKey","type":"string","required":true,"description":"magicKey from geocode-suggest"}],"exampleUrl":"https://clify-dev.netlify.app/nps/geocode-location?magicKey=dHA9MCN0dj02NWI4NWUyYyNsb2M9MjUzNjQ2NyNsbmc9NDEjcGw9MzIyNTc1NiNsYnM9MTQ6ODU1NjUxODIjbG49V29ybGQ%3D"},{"command":"get-weather-point","summary":"Look up the NWS forecast grid (office, gridX, gridY), nearest city, time zone and sunrise/sunset for a lat/lng","params":[{"name":"lat","type":"string","required":true,"description":"Latitude, max 4 decimals (more decimals cause a 301 redirect)"},{"name":"lng","type":"string","required":true,"description":"Longitude, max 4 decimals"}],"exampleUrl":"https://clify-dev.netlify.app/nps/get-weather-point"},{"command":"get-weather-forecast","summary":"Get the 7-day NWS forecast periods for a grid point (from get-weather-point)","params":[{"name":"office","type":"string","required":true,"description":"NWS gridId / office, e.g. PSR"},{"name":"gridX","type":"number","required":true,"description":"Grid X"},{"name":"gridY","type":"number","required":true,"description":"Grid Y"}],"exampleUrl":"https://clify-dev.netlify.app/nps/get-weather-forecast"},{"command":"get-weather-alerts","summary":"Get active NWS watches, warnings and advisories, optionally limited to a lat,lng point (e.g. a park location) or a state/area code","params":[{"name":"point","type":"string","description":"lat,lng with at most 4 decimals, e.g. 34.0114,-116.0975. Do not combine with area"},{"name":"area","type":"string","description":"Two-letter state or marine area code, e.g. CA or NC. Do not combine with point"},{"name":"severity","type":"string","description":"Filter by severity","oneOf":["Extreme","Severe","Moderate","Minor","Unknown"]},{"name":"api_limit","type":"number","description":"Maximum number of alerts to return (sent to the site as \"limit\"; clify's own --limit only shapes the output)"}],"exampleUrl":"https://clify-dev.netlify.app/nps/get-weather-alerts?point=34.0114%2C-116.0975&area=NC&api_limit=20"},{"command":"get-weather-observation","summary":"Get the latest observed conditions (temperature, wind, etc.) from an NWS weather station","params":[{"name":"station","type":"string","required":true,"description":"NWS station id, e.g. LTHC1 (Lost Horse, Joshua Tree)"}],"exampleUrl":"https://clify-dev.netlify.app/nps/get-weather-observation"}]}