Hacker News
Fetch top Hacker News stories and user details with HackerNewsTools' get_top_hackernews_stories and get_user_details functions.
HackerNewsTools enable an Agent to get top stories and user details from Hacker News.
Prerequisites
The following example requires the anthropic library.
uv pip install -U agno anthropicSet the agent model's API key in the same terminal:
export ANTHROPIC_API_KEY="your-api-key"Example
The following agent will write a report on trending startups and products from Hacker News.
from agno.agent import Agent
from agno.models.anthropic import Claude
from agno.tools.hackernews import HackerNewsTools
agent = Agent(
model=Claude(id="claude-sonnet-4-5"),
tools=[HackerNewsTools()],
markdown=True,
)
agent.print_response(
"Write a report on trending startups and products.", stream=True
)Toolkit Params
| Parameter | Type | Default | Description |
|---|---|---|---|
enable_get_top_stories | bool | True | Enables fetching top stories. |
enable_get_user_details | bool | True | Enables fetching user details. |
all | bool | False | Enables all functionality. |
timeout | int | 30 | Per-request HTTP timeout in seconds. |
Toolkit Functions
| Function | Description |
|---|---|
get_top_hackernews_stories | Retrieves the top stories from Hacker News. Parameters include num_stories to specify the number of stories to return (default is 10). Returns the top stories in JSON format. |
get_user_details | Retrieves the details of a Hacker News user by their username. Parameters include username to specify the user. Returns the user details in JSON format. |