{"ok":true,"site":"yle","host":"yle.fi","about":"Yle (Finnish public broadcaster) News in English: search articles and Areena programs, read articles, browse latest, front-page and topic news lists, and look up video metadata.","commands":[{"command":"search","summary":"Keyword search across Yle articles and Areena programs, with filters for type, service, language and author","params":[{"name":"query","type":"string","required":true,"description":"Search keywords"},{"name":"type","type":"string","description":"Restrict to one content type. Leave it out to search all types.","oneOf":["article","areena"]},{"name":"service","type":"string","description":"Restrict to one Yle service, e.g. 'uutiset' (news)"},{"name":"language","type":"string","description":"Content language","oneOf":["en","fi"],"default":"en"},{"name":"author","type":"string","description":"Exact author name, e.g. 'Wif Stenger'"},{"name":"api_limit","type":"number","description":"Results per page (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":20},{"name":"offset","type":"number","description":"Number of results to skip, used for paging","default":0}],"exampleUrl":"https://clify-dev.netlify.app/yle/search?query=helsinki&type=article&service=uutiset&author=Wif+Stenger"},{"command":"get-article","summary":"Get an article's metadata (headline, description, publish and modify dates, keywords, author, images) from its JSON-LD","params":[{"name":"id","type":"string","required":true,"description":"Article id from the yle.fi/a/<id> URL, e.g. 74-20250494"}],"exampleUrl":"https://clify-dev.netlify.app/yle/get-article"},{"command":"get-article-text","summary":"Get an article's body text as an ordered list of paragraphs and subheadings","params":[{"name":"id","type":"string","required":true,"description":"Article id from the yle.fi/a/<id> URL, e.g. 74-20215566"}],"exampleUrl":"https://clify-dev.netlify.app/yle/get-article-text"},{"command":"list-latest","summary":"List the latest Yle News (English) articles, newest first","params":[],"exampleUrl":"https://clify-dev.netlify.app/yle/list-latest"},{"command":"list-front-page","summary":"List the stories currently on the Yle News (English) front page, with leads","params":[],"exampleUrl":"https://clify-dev.netlify.app/yle/list-front-page"},{"command":"list-topic","summary":"List recent English articles for a topic (e.g. 18-220306 Politics, 18-34837 Domestic news, 18-204933 Economy)","params":[{"name":"topic_id","type":"string","required":true,"description":"Topic id from the yle.fi/t/<id>/en URL, e.g. 18-220306 (Politics)"}],"exampleUrl":"https://clify-dev.netlify.app/yle/list-topic"},{"command":"get-video-preview","summary":"Get metadata for a Yle/Areena video program (title, series, duration, start time, HLS manifest URL)","params":[{"name":"id","type":"string","required":true,"description":"Areena program id, e.g. 1-78744762 (from areena.yle.fi/1-<id> links in search results)"}],"exampleUrl":"https://clify-dev.netlify.app/yle/get-video-preview"}]}