Hacker News
Shanone’s Hacker News integration gives your agent 7 tools for browsing every story feed Hacker News offers and drilling into a specific story’s comments — all against the free, public Hacker News API, so there’s nothing to authenticate.Getting Started
1
No connection needed
Hacker News’s API is free and keyless — there’s no account to connect or API key to configure.
2
Just ask
Ask your agent to do something with Hacker News (e.g. “what’s trending on HN right now?”) and it will call
hackernews_* tools directly.3
Optionally verify from Integrations
You can confirm the integration is listed as available under Integrations in the Shanone dashboard, though no setup step is required there.
Available Tools
Shanone provides 7 tools for Hacker News, organized into these categories:Story feeds
Story feeds
hackernews_top_stories, hackernews_new_stories, hackernews_best_stories — the front page, newest submissions, and all-time highly-rated storiesCommunity feeds
Community feeds
hackernews_ask_stories, hackernews_show_stories — Ask HN discussion threads and Show HN project/product launchesJobs
Jobs
hackernews_job_stories — YC and tech company job postingsStory detail
Story detail
hackernews_get_story — a specific story by ID, optionally with its top-level commentsCommon Use Cases
Daily tech digest
Summarize the current top stories into a short morning briefing
Launch research
Scan Show HN for recent launches in a specific space to track competitors
Discussion deep-dives
Pull a specific story’s comments to summarize community sentiment on a topic
Job market scan
Check job stories for hiring trends at YC-backed and tech companies
Troubleshooting
Story counts are lower than the count parameter I passed
Story counts are lower than the count parameter I passed
count is capped at 30 per call, and any item that fails to load (deleted, or a transient API error) is silently skipped rather than retried — expect slightly fewer results than requested on a flaky connection.hackernews_get_story returns comments but some are missing text
hackernews_get_story returns comments but some are missing text
Deleted or flagged comments are filtered out entirely, and comment text is truncated at 500 characters — request the story again with a smaller
max_comments if you want to reduce noise.A story's url field is empty
A story's url field is empty
Ask HN and some other self-post story types don’t have an external URL — use the
hn_url (or text field for Ask HN posts) instead of assuming every story links out.