hackernews-frontpage

Scrape Hacker News front page into structured JSON story data.

Updated May 7, 2026
One-click install
npx skills add https://github.com/TumeloRamaphosa/StudEx-Valley-OS --skill hackernews-frontpage-tumeloramaphosa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hackernews-frontpage
Source: https://github.com/TumeloRamaphosa/StudEx-Valley-OS/tree/main/.claude/skills/gstack/browser-skills/hackernews-frontpage
Command: npx skills add https://github.com/TumeloRamaphosa/StudEx-Valley-OS --skill hackernews-frontpage-tumeloramaphosa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bun, and includes scripts (resource) components.

What problem does it solve?

It saves you from manually browsing Hacker News to find the newest trending articles by automatically collecting the front page into a structured dataset.

Core Features & Use Cases

  • Top-story scraping to JSON: Fetches the front page and returns the top 30 stories with rank, title, link URL, points, and comment counts.
  • Deterministic HTML parsing with tests: Parses stable Hacker News tr.athing rows and uses a bundled fixture-based test to catch selector breakage early.
  • Handles job-post rows safely: Produces null points/comments for hiring/job rows where those fields are absent.

Quick Start

Use the command: $B skill run hackernews-frontpage

Frequently Asked Questions about hackernews-frontpage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scrape Hacker News top stories into JSON format?

You can scrape Hacker News top stories into JSON by parsing the front page HTML rows and extracting rank, title, URL, points, and comment counts into a single structured stdout JSON document.

What is the best way to collect trending Hacker News links for content analytics?

Collecting trending Hacker News links for content analytics is best done by web parsing the front page to extract up to 30 top stories with their points and comment counts into a structured JSON dataset.

Do I need Bun to run the Hacker News web parsing script?

Yes, you need Bun installed as the runtime environment to execute the script that scrapes the Hacker News front page and outputs the structured story data.

How does web parsing handle Hacker News job posts with missing points or comments?

Web parsing handles Hacker News job posts by safely outputting null values for points and comments where those fields are absent, ensuring the JSON schema remains consistent without breaking.

Why does the Hacker News scraper use fixture-based tests for HTML parsing?

The Hacker News scraper uses fixture-based tests to catch selector breakage early by validating the stable HTML row parsing logic against known page structures before execution.