Get the top Hacker News stories from the last N hours, ranked by score.

Args: limit: Number of stories to return (1-30). Default 10. hours: Time window in hours back from now. Default 24.

Returns: List of story dicts with id, title, url, score, author, comments_count, posted_unix, hn_url, type, text (for Ask/Show HN posts).

Get stories from a specific HN category.

Args: category: One of "top", "new", "best", "ask", "show", "job". limit: Number of stories to return (1-30). Default 10.

Returns: List of story dicts.

Get full metadata for a single HN story by id.

Args: story_id: The HN item id.

Returns: Story dict with id, title, url, score, author, comments_count, posted_unix, hn_url, type, text. Returns {"error": "..."} if not found.

Get the top-level comments thread for a story, in HN ranking order.

Args: story_id: The HN item id of the parent story. limit: Number of comments to return (1-30). Default 10.

Returns: List of comment dicts with id, author, text, posted_unix, replies_count.

Full-text search across HN stories and comments via Algolia.

Args: query: Search query string. sort: "relevance" (default) or "date" (newest first). limit: Number of hits to return (1-50). Default 20.

Returns: Dict with hits (list of clean dicts: id, kind, title, url, hn_url, author, points, comments_count, story_text, comment_text, created_at, tags) and total_hits (total matches Algolia found, may exceed limit).