--- name: hackernews-x402.vercel.app description: hackernews-x402.vercel.app provides three read-only Hacker News feed endpoints: top stories, newest submissions, and Ask HN stories. Each endpoint returns structured JSON with story metadata including title, URL, score, author, timestamp, and comment count. No authentication or input parameters are required. host: hackernews-x402.vercel.app --- # hackernews-x402.vercel.app This host is a lightweight proxy over the Hacker News public feed, serving agents that need structured snapshots of HN content without directly integrating the official HN Firebase API or Algolia search. It covers three distinct feed types — top, new, and Ask HN — and is suited for content aggregation, trend monitoring, and surfacing community discussions. It does not support story search, comment retrieval, individual story lookup, Show HN, Jobs, or Best story feeds. ## When to use this host Use this host when an agent needs a quick, structured snapshot of Hacker News top, new, or Ask HN feeds without setting up direct Firebase or Algolia integrations. Do not use it for: fetching a specific story by ID, retrieving comment threads, searching historical stories, accessing Show HN or Jobs feeds, or fetching more than the default story count per feed — for those use cases, use the official HN Firebase API (hacker-news.firebaseio.com) or Algolia HN Search (hn.algolia.com/api) directly. All three skills are zero-input polling endpoints, so this host is not appropriate for any query-driven or parameterized HN lookups. ## Capabilities ### Hacker News Feed Retrieval Fetches current snapshots of Hacker News story feeds across three categories: top-ranked stories, newest submissions, and Ask HN community questions. Together these cover the primary discovery surfaces on HN. - **`fetch-hackernews-top-stories`** — Returns the current top 10 Hacker News stories as structured JSON, each with id, title, URL, score, author, timestamp, comment count, and type. - **`fetch-hackernews-new-stories`** — Returns the latest Hacker News new stories as a JSON feed, including title, URL, score, author, timestamp, comment count, and story type. - **`fetch-hn-ask-stories`** — Returns the latest Hacker News Ask HN stories as a JSON feed, including story ID, title, score, author, timestamp, comment count, and type. ## Workflows ### Comprehensive HN Snapshot *Use when an agent needs to build a broad, multi-feed view of current Hacker News activity — combining trending, fresh, and community-question content in a single pass.* 1. **`fetch-hackernews-top-stories`** — Retrieve the current top 10 ranked stories to establish what is trending by score. 2. **`fetch-hackernews-new-stories`** — Retrieve the newest submissions to surface recently posted links not yet ranked highly. 3. **`fetch-hn-ask-stories`** — Retrieve current Ask HN stories to capture active community discussion threads and questions. ## Skill reference ### `fetch-hackernews-new-stories` **Hacker News New Stories Feed** — Returns the latest Hacker News new stories as a JSON feed, including title, URL, score, author, timestamp, comment count, and story type. *Use when:* Use when an agent needs a real-time snapshot of the newest Hacker News submissions, such as for trend monitoring, content aggregation, or surfacing recently posted links and discussions. *Not for:* Do not use for top/best/ask/show story rankings — this endpoint returns only the newest submissions. Not suitable for fetching a specific story by ID or for comment thread retrieval. **Returns:** Returns a feed object with feed='newstories', a count integer, and a stories array of up to 10 items each containing id, title, url, score, author, ISO timestamp, comment count, and type. **Example:** `GET https://hackernews-x402.vercel.app/hn/new` --- ### `fetch-hn-ask-stories` **Hacker News Ask Stories** — Returns the latest Hacker News Ask HN stories as a JSON feed, including story ID, title, score, author, timestamp, comment count, and type. *Use when:* Use when an agent needs a current snapshot of top Ask HN stories from Hacker News, such as for surfacing community questions, monitoring discussion trends, or aggregating user-submitted topics. *Not for:* Do not use for fetching regular HN top/new/best stories, job postings, or show HN stories; those require different feed endpoints. **Returns:** Returns a JSON object with feed='askstories', a count integer, and a stories array of up to 10 Ask HN items each containing id, title, url (nullable), score, author, ISO timestamp, comment count, and type. **Example:** `GET https://hackernews-x402.vercel.app/hn/ask` --- ### `fetch-hackernews-top-stories` **Hacker News Top Stories** — Returns the current top 10 Hacker News stories as structured JSON, each with id, title, URL, score, author, timestamp, comment count, and type. *Use when:* Use when an agent needs a snapshot of the current top Hacker News stories, including metadata such as score, author, and comment count, to summarize, filter, or display trending tech news. *Not for:* Do not use for fetching a specific story by ID, searching past stories, or retrieving more than 10 stories; use the official HN API or Algolia HN Search instead. **Returns:** Returns a JSON object with feed='topstories', count=10, and a stories array of 10 objects each containing id, title, url, score, by, time, descendants, and type. **Example:** `GET https://hackernews-x402.vercel.app/hn/top` ---