name: hacker-news-surfer description: Surf Hacker News for AI and tech discussions. Get top stories, search for AI topics, and analyze trending tech news.

Hacker News Surfer

Hacker News（HN）冲浪技能，获取热门技术话题和 AI 相关讨论。

Features

• ✅ Top Stories - Get current top stories
• ✅ New Stories - Get latest submissions
• ✅ Best Stories - Get highest-rated stories
• ✅ Search AI Topics - Find AI-related discussions
• ✅ Story Details - Get comments and metadata

API

Base URL: https://hacker-news.firebaseio.com/v0/

Endpoints:

• /topstories.json - Top story IDs
• /newstories.json - New story IDs
• /beststories.json - Best story IDs
• /item/{id}.json - Story details
• /user/{id}.json - User profile

Usage

Get Top Stories

# Get top 10 story IDs
curl -s "https://hacker-news.firebaseio.com/v0/topstories.json" | jq -r '.[:10]'

# Get story details
curl -s "https://hacker-news.firebaseio.com/v0/item/47306655.json" | jq '{
  title: .title,
  url: .url,
  score: .score,
  by: .by,
  time: .time
}'

Search AI Topics

# Get top stories and filter for AI
curl -s "https://hacker-news.firebaseio.com/v0/topstories.json" | \
  jq -r '.[:50]' | \
  while read id; do
    curl -s "https://hacker-news.firebaseio.com/v0/item/$id.json" | \
      jq -r 'select(.title | test("AI|artificial intelligence|machine learning|ML|GPT|Claude"; "i"))'
  done

Quick Test

# Test API connection
curl -s "https://hacker-news.firebaseio.com/v0/topstories.json" | jq -r '.[0]'

Examples

See USAGE.md for detailed examples:

• Get top AI stories
• Search specific topics
• Analyze story trends
• Get user profiles

Installation

✅ No installation required - uses public API

Rate Limit

• No official rate limit
• Be respectful (1 request/second recommended)

Cost

• ✅ Free - No API key required