{"ok":true,"site":"sunrise-sunset","host":"sunrise-sunset.org","about":"sunrise-sunset.org gives sunrise, sunset and twilight times for any city. This CLI searches cities, fetches today's times, browses countries, regions and cities, reads monthly calendars and queries the public sunrise/sunset JSON API.","commands":[{"command":"search-cities","summary":"Search cities by name. Returns numeric city ids and labels; use the id with get-today-times.","params":[{"name":"q","type":"string","required":true,"description":"City name or prefix to search for"}],"exampleUrl":"https://clify-dev.netlify.app/sunrise-sunset/search-cities?q=Paris"},{"command":"get-today-times","summary":"Get today's and tomorrow's sunrise/sunset widget for a city, selected by numeric id. Returns JSON with pre-rendered HTML fragments.","params":[{"name":"id","type":"number","required":true,"description":"Numeric city id from search-cities, e.g. 119890 = Paris, France"}],"exampleUrl":"https://clify-dev.netlify.app/sunrise-sunset/get-today-times?id=119890"},{"command":"list-popular-today","summary":"Get today's sunrise/sunset cards for the most-searched cities in the visitor's country (grid), or for the visitor's geolocated city (geo).","params":[{"name":"grid","type":"number","description":"1 = return the most-searched-cities grid","default":1},{"name":"geo","type":"number","description":"1 = return times for the city geolocated from the caller's IP"}],"exampleUrl":"https://clify-dev.netlify.app/sunrise-sunset/list-popular-today?grid=1&geo=1"},{"command":"get-sun-times","summary":"Public JSON API: sunrise, sunset, solar noon, day length and twilight times for a latitude/longitude on one date or across a date range.","params":[{"name":"lat","type":"number","required":true,"description":"Latitude in decimal degrees"},{"name":"lng","type":"number","required":true,"description":"Longitude in decimal degrees"},{"name":"date","type":"string","description":"Single date, YYYY-MM-DD (defaults to today). Do not combine with date_start/date_end."},{"name":"date_start","type":"string","description":"Range start date, YYYY-MM-DD (use together with date_end)"},{"name":"date_end","type":"string","description":"Range end date, YYYY-MM-DD (use together with date_start)"}],"exampleUrl":"https://clify-dev.netlify.app/sunrise-sunset/get-sun-times?lat=48.853409&lng=2.3488&date=2026-10-18&date_start=2026-10-18&date_end=2026-10-25"},{"command":"get-location-page","summary":"Open a city or region page by country code and slug (e.g. fr/paris, jp/tokyo, jp/tokyo-prefecture). Returns the page heading, title and meta description.","params":[{"name":"country_code","type":"string","required":true,"description":"Two-letter lowercase country code used in site URLs, e.g. fr, jp"},{"name":"slug","type":"string","required":true,"description":"City or region slug, e.g. paris, tokyo, tokyo-prefecture"}],"exampleUrl":"https://clify-dev.netlify.app/sunrise-sunset/get-location-page"},{"command":"list-countries","summary":"List all countries on the explore page. Each link leads to a country listing of regions and cities.","params":[],"exampleUrl":"https://clify-dev.netlify.app/sunrise-sunset/list-countries"},{"command":"list-country-locations","summary":"List the regions and cities for a country by its full-name slug (e.g. japan). Links point to /{cc}/{slug} pages usable with get-location-page.","params":[{"name":"country","type":"string","required":true,"description":"Country name slug as used on the explore page, e.g. japan, france"}],"exampleUrl":"https://clify-dev.netlify.app/sunrise-sunset/list-country-locations"},{"command":"get-monthly-calendar","summary":"Get the monthly sunrise/sunset calendar for a location by name. Returns one item per day with the date, sunrise and sunset text.","params":[{"name":"location","type":"string","required":true,"description":"Location name as typed in the calendar search box, e.g. Tokyo"},{"name":"month","type":"string","description":"Month in YYYY-MM format (defaults to the current month)"}],"exampleUrl":"https://clify-dev.netlify.app/sunrise-sunset/get-monthly-calendar?location=Tokyo&month=2026-11"}]}