hackernews-frontpage

Hacker News のフロントページスクレーパー

Hacker News（news.ycombinator.com）のフロントページをスクレイピングし、上位 30 件の記事を JSON として返します。各記事には、順位、タイトル、リンク URL、ポイント数、コメント数が含まれます。

使用方法

$ $B skill run hackernews-frontpage
{
  "stories": [
    { "rank": 1, "title": "...", "url": "...", "points": 412, "comments": 87 },
    ...
  ],
  "count": 30
}

仕組み

1. デーモン経由で https://news.ycombinator.com に移動します。
2. ページの HTML を読み取ります。
3. 各記事の行（HN の安定した tr.athing 構造）を、型付きの Story レコードに解析します。
4. 単一の JSON ドキュメントを stdout に出力します。

リファレンススキルである理由

hackernews-frontpage は、興味深いブラウザースキルの中で最小のものです。認証不要で、HTML は安定しており、出力は決定的で、ファイルのフィクスチャにも対応しやすい設計です。$B skill run hackernews-frontpage と同梱の script.test.ts により、フェーズ 1 のすべてのコンポーネント（SDK、スコープ付きトークン、3 階層の検索、プロセスの起動とライフサイクル）が実行されます。

HN の HTML が変更されてセレクターが機能しなくなると、ユーザーが気づく前に、キャプチャ済みのフィクスチャを使ったテストが失敗します。それが狙いです。