search_hackernews
Search Hacker News stories by keyword and get title, URL, points, author, and comment count. Returns an empty list if no results.
Instructions
Search Hacker News stories and return a list of matching story dicts, each with title, url, points, author (username), and num_comments (comment count).
Queries the public Hacker News search index (Algolia HN API) over the network; makes no local changes. Returns an empty list when nothing matches or the query is empty.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| by | No | Result ordering; type: string; one of "relevance" or "date" ("date" sorts most recent first); example: "date"; default: "relevance". | relevance |
| tags | No | Algolia HN tag filter; type: string; common values "story", "comment", "show_hn", "ask_hn", "poll", "job"; example: "show_hn"; default: "story". | story |
| query | Yes | Search terms to match against story titles and text; type: string; example: "rust async runtime"; no default (required). | |
| max_results | No | Maximum number of stories to return; type: integer; example: 10; default: 20. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| count | No | ||
| errors | No | ||
| scraper | No | ||
| source_urls | No |