hn_best
Fetch the best Hacker News stories. Configure the number of stories returned between 1 and 50.
Instructions
Get the best stories from Hacker News
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of stories to fetch (1-50, default: 10) |
Implementation Reference
- index.ts:178-193 (registration)Tool registration for 'hn_best' in the ListToolsRequestSchema handler. Defines the tool name, description, and input schema accepting an optional 'limit' parameter (1-50, default 10).
{ name: "hn_best", description: "Get the best stories from Hacker News", inputSchema: { type: "object", properties: { limit: { type: "number", description: "Number of stories to fetch (1-50, default: 10)", minimum: 1, maximum: 50, default: 10 } } } }, - index.ts:279-299 (handler)Handler for 'hn_best' tool in CallToolRequestSchema. Calls api.getBestStories() with the limit, formats the results, and returns them as text content.
if (name === "hn_best") { const limit = typeof args?.limit === 'number' ? args.limit : 10; const stories = await api.getBestStories(limit); const formattedStories = stories.map(story => ({ id: story.id, title: story.title, by: story.by, time: api.formatTime(story.time), url: story.url, score: story.score, commentsCount: story.kids?.length || 0 })); lastStoriesList = formattedStories; return { content: [ { type: "text", text: formatStoriesAsText(formattedStories) } ] }; - index.ts:74-85 (helper)HackerNewsAPI.getBestStories() helper method. Fetches best story IDs from the Firebase API, retrieves details for each, and filters for valid story type items.
async getBestStories(limit = 50): Promise<Story[]> { try { const response = await axios.get(`${baseUrl}/beststories.json`); const storyIds = response.data || []; const storyPromises = storyIds.slice(0, limit).map((id: number) => this.getItemDetails(id)); const stories = await Promise.all(storyPromises); return stories.filter((story): story is Story => story !== null && story.type === 'story'); } catch (error) { console.error('Error fetching best stories:', error); return []; } }