{"ok":true,"site":"news-ycombinator","host":"news.ycombinator.com","about":"Hacker News (news.ycombinator.com): read front page, new, past, Ask, Show and jobs listings, stories with comment trees, comment feeds, user profiles, submissions, comments and favorites, and post comments. Every command parses the server-rendered HTML.","commands":[{"command":"list-stories","summary":"List ranked stories from a Hacker News feed: front page (news), Ask HN, Show HN, best, or most active. Page-numbered.","params":[{"name":"feed","type":"string","description":"Which feed to list: news = front page, ask = Ask HN, show = Show HN, best = highest-voted recent stories, active = most active discussions","oneOf":["news","ask","show","best","active"],"default":"news"},{"name":"p","type":"number","description":"Page number, 1-based, 30 stories per page"},{"name":"h","type":"number","description":"Only for feed=best: look-back window in hours"}],"exampleUrl":"https://clify-dev.netlify.app/news-ycombinator/list-stories?p=2&h=24"},{"command":"list-new-stories","summary":"List the newest submissions, newest Ask HN, newest Show HN, or job postings, in chronological order.","params":[{"name":"feed","type":"string","description":"newest = all new links, asknew = new Ask HN, shownew = new Show HN, jobs = job postings","oneOf":["newest","asknew","shownew","jobs"],"default":"newest"},{"name":"next","type":"string","description":"Pagination cursor: the item id from the page's 'More' link (normally the id of the last item shown). Omit for the first page."},{"name":"n","type":"number","description":"Rank number for the first item on the next page (e.g. 31). Use together with next."}],"exampleUrl":"https://clify-dev.netlify.app/news-ycombinator/list-new-stories?next=50138000&n=31"},{"command":"list-front-page-by-day","summary":"List the stories that were on the Hacker News front page on a given past day.","params":[{"name":"day","type":"string","required":true,"description":"Day in YYYY-MM-DD format, e.g. 2026-10-15"},{"name":"p","type":"number","description":"Page number, 1-based"}],"exampleUrl":"https://clify-dev.netlify.app/news-ycombinator/list-front-page-by-day?day=2026-10-15&p=2"},{"command":"list-site-stories","summary":"List Hacker News submissions from a given domain or site path (e.g. github.com/antirez).","params":[{"name":"site","type":"string","required":true,"description":"Domain or site path as HN shows it next to titles, e.g. nytimes.com or github.com/antirez"},{"name":"next","type":"string","description":"Pagination cursor: the item id from the 'More' link"},{"name":"n","type":"number","description":"Rank number of the first item on the next page, e.g. 31"}],"exampleUrl":"https://clify-dev.netlify.app/news-ycombinator/list-site-stories?site=github.com%2Fantirez&next=50000000&n=31"},{"command":"get-item","summary":"Get one story, Ask/Show post or comment by id: title, link, points, author, age, comment count and body text.","params":[{"name":"id","type":"string","required":true,"description":"Hacker News item id (story or comment)"}],"exampleUrl":"https://clify-dev.netlify.app/news-ycombinator/get-item?id=50138531"},{"command":"list-item-comments","summary":"List the comment tree of a story or comment (flattened in thread order, with indent depth).","params":[{"name":"id","type":"string","required":true,"description":"Hacker News item id whose comments to list"},{"name":"p","type":"number","description":"Page of comments, for very large threads"}],"exampleUrl":"https://clify-dev.netlify.app/news-ycombinator/list-item-comments?id=50138531&p=2"},{"command":"list-new-comments","summary":"List the newest comments across Hacker News, with the story each one is on.","params":[{"name":"next","type":"string","description":"Pagination cursor: the comment id from the page's 'More' link"}],"exampleUrl":"https://clify-dev.netlify.app/news-ycombinator/list-new-comments?next=50138000"},{"command":"list-best-comments","summary":"List the most-upvoted comments of the last N hours (48 by default).","params":[{"name":"h","type":"number","description":"Look-back window in hours. The site uses 48 when this is omitted."},{"name":"p","type":"number","description":"Page number"}],"exampleUrl":"https://clify-dev.netlify.app/news-ycombinator/list-best-comments?h=24&p=2"},{"command":"get-user","summary":"Get a Hacker News user's profile: username, account creation date, karma and about text, as label/value rows.","params":[{"name":"id","type":"string","required":true,"description":"HN username (case-sensitive)"}],"exampleUrl":"https://clify-dev.netlify.app/news-ycombinator/get-user?id=fagnerbrack"},{"command":"list-user-submissions","summary":"List the stories a user has submitted, newest first.","params":[{"name":"id","type":"string","required":true,"description":"HN username"},{"name":"next","type":"string","description":"Pagination cursor: the item id from the 'More' link"},{"name":"n","type":"number","description":"Rank number of the first item on the next page, e.g. 31"}],"exampleUrl":"https://clify-dev.netlify.app/news-ycombinator/list-user-submissions?id=fagnerbrack&next=50000000&n=31"},{"command":"list-user-comments","summary":"List a user's recent comments, with the story each one is on.","params":[{"name":"id","type":"string","required":true,"description":"HN username"},{"name":"next","type":"string","description":"Pagination cursor: the comment id from the page's 'More' link"}],"exampleUrl":"https://clify-dev.netlify.app/news-ycombinator/list-user-comments?id=fagnerbrack&next=50000000"},{"command":"list-leaders","summary":"List the top 100 Hacker News users by karma, in rank order.","params":[],"exampleUrl":"https://clify-dev.netlify.app/news-ycombinator/list-leaders"},{"command":"list-lists","summary":"List Hacker News's special listing pages (front, best, active, leaders, etc.) with descriptions.","params":[],"exampleUrl":"https://clify-dev.netlify.app/news-ycombinator/list-lists"}]}