{"ok":true,"site":"theguardian","host":"theguardian.com","about":"The Guardian (theguardian.com) news site. The CLI reads articles, edition and section fronts, tag and topic listings, writer pages, most-read lists, daily section archives, topic and contributor indexes, and reader comments as JSON. It uses the site's own `.json?dcr` page data, RSS feeds and the public discussion API.","commands":[{"command":"get-article","summary":"Get one full article (headline, standfirst, byline, date, body blocks, tags) as JSON from its URL parts","params":[{"name":"section","type":"string","required":true,"description":"First path segment of the article URL, e.g. world, us-news, sport, commentisfree"},{"name":"year","type":"string","required":true,"description":"4-digit year from the article URL"},{"name":"month","type":"string","required":true,"description":"3-letter lowercase month from the article URL","oneOf":["jan","feb","mar","apr","may","jun","jul","aug","sep","oct","nov","dec"]},{"name":"day","type":"string","required":true,"description":"2-digit day from the article URL"},{"name":"slug","type":"string","required":true,"description":"Article slug, the last URL segment"}],"exampleUrl":"https://clify-dev.netlify.app/theguardian/get-article"},{"command":"get-front","summary":"Get an edition or section front page (e.g. international, uk, us, sport) as its list of curated story collections","params":[{"name":"front","type":"string","required":true,"description":"Front path: an edition (international, uk, us, au) or a section (sport, culture, world, business). Section fronts may redirect to an edition-specific version (sport -> us/sport)."}],"exampleUrl":"https://clify-dev.netlify.app/theguardian/get-front"},{"command":"get-tag-feed","summary":"Get the RSS feed of the latest articles for a tag or topic, with title, link, date, byline and categories","params":[{"name":"section","type":"string","required":true,"description":"Part of the tag id before the slash, e.g. world, society, science"},{"name":"tag","type":"string","required":true,"description":"Part of the tag id after the slash, e.g. italy"}],"exampleUrl":"https://clify-dev.netlify.app/theguardian/get-tag-feed"},{"command":"list-contributor-articles","summary":"Get the RSS feed of a Guardian writer's latest articles (e.g. angela-giuffrida), with title, link, date, byline and categories","params":[{"name":"slug","type":"string","required":true,"description":"Contributor profile slug, e.g. angela-giuffrida (the profile/<slug> tag id)"}],"exampleUrl":"https://clify-dev.netlify.app/theguardian/list-contributor-articles"},{"command":"get-most-read","summary":"Get the site-wide most-viewed and deeply-read article lists with headline, url, byline and shortUrl","params":[],"exampleUrl":"https://clify-dev.netlify.app/theguardian/get-most-read"},{"command":"list-section-day","summary":"List all articles published in a section on one date (daily archive, e.g. world on 2026/oct/17)","params":[{"name":"section","type":"string","required":true,"description":"Section id, e.g. world, us-news, sport, business"},{"name":"year","type":"string","required":true,"description":"4-digit year"},{"name":"month","type":"string","required":true,"description":"3-letter lowercase month","oneOf":["jan","feb","mar","apr","may","jun","jul","aug","sep","oct","nov","dec"]},{"name":"day","type":"string","required":true,"description":"2-digit day"}],"exampleUrl":"https://clify-dev.netlify.app/theguardian/list-section-day"},{"command":"list-subjects","summary":"Browse the A-Z index of Guardian topics/subjects for one letter; links give tag ids","params":[{"name":"letter","type":"string","required":true,"description":"Single lowercase letter a-z"}],"exampleUrl":"https://clify-dev.netlify.app/theguardian/list-subjects"},{"command":"list-contributors","summary":"Browse the A-Z index of Guardian writers/contributors for one letter; links give profile slugs","params":[{"name":"letter","type":"string","required":true,"description":"Single lowercase letter a-z (surname initial)"}],"exampleUrl":"https://clify-dev.netlify.app/theguardian/list-contributors"},{"command":"list-comments","summary":"List reader comments on an article by its short id (e.g. x67fk6), sorted and paged","params":[{"name":"shortId","type":"string","required":true,"description":"Article short id without the /p/ prefix, e.g. x67fk6 (from get-article shortUrlId or a shortUrl like theguardian.com/p/x67fk6)"},{"name":"orderBy","type":"string","description":"Sort order","oneOf":["newest","oldest","recommendations"],"default":"newest"},{"name":"page","type":"number","description":"Page number, 1-based","default":1},{"name":"pageSize","type":"number","description":"Comments per page","oneOf":["20","50","100"],"default":20}],"exampleUrl":"https://clify-dev.netlify.app/theguardian/list-comments"},{"command":"get-comment-counts","summary":"Get comment counts for one or more articles by short URL (/p/xxxxx), comma-separated","params":[{"name":"shortUrls","type":"string","required":true,"description":"Comma-separated short URLs, each like /p/x46an8"}],"exampleUrl":"https://clify-dev.netlify.app/theguardian/get-comment-counts?shortUrls=%2Fp%2Fx46an8%2C%2Fp%2Fx65353%2C%2Fp%2Fx67fk6"}]}