Official Verified

Hacker News

Search and browse Hacker News with API access to stories, comments, users, and hiring threads.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/ivangdavila/hacker-news

Download Source Code (.zip)

Quick Reference

Topic	File
API endpoints	`api.md`
Search patterns	`search.md`

Core Rules

1. Two APIs Available

API	Use Case	Base URL
Official HN API	Single items, real-time	`https://hacker-news.firebaseio.com/v0`
Algolia Search	Full-text search, filters	`https://hn.algolia.com/api/v1`

2. Official API Endpoints

/topstories.json — top 500 story IDs
/newstories.json — newest 500 story IDs
/beststories.json — best stories
/askstories.json — Ask HN
/showstories.json — Show HN
/jobstories.json — job postings
/item/{id}.json — story/comment details
/user/{username}.json — user profile

3. Algolia Search Syntax

/search?query=TERM&tags=TAG&numericFilters=FILTER

Tags (combinable with AND):

story, comment, poll, job, ask_hn, show_hn
author_USERNAME — posts by user
story_ID — comments on story

Numeric filters:

created_at_i>TIMESTAMP — after date
points>N — minimum points
num_comments>N — minimum comments

4. Common Patterns

Request	Endpoint
Frontpage	Official `/topstories.json` → fetch first 30 items
Search posts	Algolia `/search?query=X&tags=story`
User's posts	Algolia `/search?tags=author_USERNAME`
Who is hiring?	Algolia `/search?query=who is hiring&tags=story,author_whoishiring`
Comments on story	Algolia `/search?tags=comment,story_ID`
This week's top	Algolia `/search?tags=story&numericFilters=created_at_i>WEEK_TS`

5. Response Handling

Official API returns IDs → batch fetch items (parallelize)
Algolia returns full objects with hits[] array
Story object: id, title, url, score, by, time, descendants (comment count)
Comment object: id, text, by, parent, time

6. Rate Limits

Official API: No auth required, generous limits
Algolia: 10,000 requests/hour (no key needed)
Always paginate large results (page=N, hitsPerPage=N)

7. Gotchas

url is null for Ask HN/Show HN text posts — use text field instead
deleted and dead items exist — check before displaying
Timestamps are Unix seconds, not milliseconds
Algolia objectID = HN item id (as string)

Read Full Documentation on GitHub

Metadata

Author@ivangdavila

Stars2102

Updated2026-03-06

View Author Profile

AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill

Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-ivangdavila-hacker-news": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

Animations

Create performant web animations with proper accessibility and timing.

ivangdavila 2190

Arduino

Develop Arduino projects avoiding common wiring, power, and code pitfalls.

ivangdavila 2190

Bulgarian

Write Bulgarian that sounds human. Not formal, not robotic, not AI-generated.

ivangdavila 2190

Arabic

Write Arabic that sounds human. Not formal, not robotic, not AI-generated.

ivangdavila 2190

Assistant

Manage tasks, communications, and scheduling with proactive and organized support.

ivangdavila 2190