Building AI agents, atomically
Hacker News Search Tool
Overview
Searches Hacker News stories, comments, Show HN, Ask HN, and polls via the free Algolia HN search API. Supports relevance and date sorting and arbitrary numeric filters (points>100, num_comments>50, etc.). No authentication required.
Prerequisites and Dependencies
- Python 3.12 or later
atomic-agentspydanticaiohttp
Installation
- Use the Atomic Assembler CLI: run
atomicand pickhackernews_search. - Or copy the
tool/folder directly into your project.
Input & Output Structure
Input Schema
queries(list[str]): one or more search queries.tags(str):story,comment,show_hn,ask_hn,poll, orfront_page(defaultstory).sort_by(str):relevanceordate(defaultrelevance).max_results_per_query(int): 1–50 (default 10).numeric_filters(str, optional): Algolia numeric filter expression (e.g.points>100).
Output Schema
A list of HackerNewsItem items, each with object_id, title, url, hn_url, author, points, num_comments, created_at, story_text, comment_text, parent_id, story_id.
Usage
from tool.hackernews_search import HackerNewsSearchTool, HackerNewsSearchToolInputSchema
tool = HackerNewsSearchTool()
output = tool.run(HackerNewsSearchToolInputSchema(
queries=["MCP server", "atomic agents"],
sort_by="date",
max_results_per_query=5,
numeric_filters="points>10",
))
for item in output.results:
print(item.title, "-", item.points, "points")
print(item.hn_url)
Contributing
PRs welcome — see the main repo CONTRIBUTING.md.
License
Same as the main Atomic Agents project.