hn-digest

# HN Digest One request, one and a half screens, answering one question: **what is HN talking about right now, and what industries is it coming from.** This skill never reads comment text. That is a deliberate trade: scanning does not require mining, and mining is a different job (one extra request per story). So every judgement here rests on titles, scores, and comment counts only — and the writing must never pretend otherwise. See [Honesty discipline](#honesty-discipline). ## Fetching ```bash curl -s "https://hn.algolia.com/api/v1/search?tags=front_page&hitsPerPage=30&attributesToRetrieve=title,points,num_comments,url,objectID,created_at" ``` One request returns all 30 front-page stories with scores and comment counts. **Do not use Firebase's `topstories.json`** — it needs 1 + 30 requests for the same data. Fields: | Field | Meaning | |-------|---------| | `title` | Story title | | `points` | Score | | `num_comments` | Comment count | | `url` | Article link; `null` for self-posts (Ask HN / Show HN) | | `objectID` | HN item id — discussion page is `https://news.ycombinator.com/item?id=<objectID>` | | `created_at` | Post time, UTC | `attributesToHighlight=` does not suppress `_highlightResult`. That field is search-highlight noise — ignore it. The whole response is ~17KB for 30 stories: read it directly, do not write a script to trim it. **What `front_page` means.** It returns the front page **as it looks right now**, not "posted today." Long-running stories stay up ...