Hacker News

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 anthropic

Example

The following agent will write a report on trending startups and products from Hacker News.

cookbook/91_tools/hackernews_tools.py

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.

Developer Resources

Tools

Exa Linkup

⌘I

Get Started

Basics

Advanced

Production

Providers

Other

Additional Resources

Hacker News

Prerequisites

Example

Toolkit Params

Toolkit Functions

Developer Resources

​Prerequisites

​Example

​Toolkit Params

​Toolkit Functions

​Developer Resources

Prerequisites

Example

Toolkit Params

Toolkit Functions

Developer Resources