topics-hn

name	topics-hn
description	Fetch top stories from Hacker News (filtered to actual stories) for LinkedIn topic ideation. Use when the user wants "top HN stories", "what's on HN", "fetch Hacker News", or fresh tech signals for a post. Returns JSON entries with title, url, score, comments, author.

topics-hn

Pulls the current HN top stories via the public Firebase API and returns clean JSON suitable for LinkedIn post ideation.

Run

bun src/briefing/cli/hn.ts --limit 30

--limit is items returned after filtering to type === "story" (default 30). Only stories with type === "story" come back — no jobs, polls, or comments.

Output shape

[
  {
    "source": "hackernews",
    "title": "Show HN: ...",
    "url": "https://example.com/post",
    "score": 142,
    "commentCount": 87,
    "author": "username",
    "publishedAt": "2026-05-18T08:30:00.000Z",
    "body": "self-post HTML (optional)",
    "extra": {
      "hnId": 38123456,
      "permalink": "https://news.ycombinator.com/item?id=38123456"
    }
  }
]

When to use

• "Give me HN top stories" / "what's hot on HN today"
• Topic mining for a LinkedIn post
• Cross-reference with Lobsters via topics-lobsters

For a multi-source briefing in one go, prefer topics-briefing instead.