Search Hacker News
hackernews_search_listSearch Hacker News by keyword, author, domain, URL, content type, date range, or score, and return a paginated list of matching stories and comments.
Instructions
Search Hacker News by keyword. Optional inputs: query, type, sort, dateRange, page and 11 more. Returns a list (use page/pageSize when paginated).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "hackernews_search_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Restrict search to story URLs matching this URL substring. Can omit `query`. | |
| page | No | Zero-based page index (maximum 50 pages, up to 1,000 hits). | |
| sort | No | Ranking mode. Default: `popularity`. | |
| type | No | Restrict search results to a Hacker News content type. `ask_hn`: Ask HN posts (questions to the community). `show_hn`: Show HN posts (projects/work being shared). `launch_hn`: Launch HN posts (YC-affiliated company launches). Default: `all`. | |
| limit | No | Hits per page. Must be one of 10, 20, 30, 50. Default: 20. Prefer this over `pageSize`. | |
| query | No | Full-text search query. Required unless `frontPageOnly`, `author`, `domain`, or `url` is set. | |
| author | No | Restrict results to items by this Hacker News username. | |
| domain | No | Restrict search to story URLs matching this domain (e.g. example.com). Can omit `query`. | |
| prefix | No | When true, enable prefix matching for query tokens. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| pageSize | No | Deprecated alias for `limit`. When both are set, `limit` wins. | |
| dateRange | No | Creation-time window. Default: `all`. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| minPoints | No | Minimum points/score filter. | |
| searchAuthor | No | When true, include author username in the searchable fields. | |
| frontPageOnly | No | When true, restrict results to current front-page items. Allows omitting `query`. | |
| typoTolerance | No | Enable typo tolerance. Default: true. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. | |
| searchStoryText | No | Include story/comment text in searchable fields. Default: true. Set false to search title/URL only. |