Hacker News Data Skill

UnifAPI を通じて公開 Hacker News データを読み取るための、決定論的な読み取りパス。これは Data Skill です。それ自体でマーケティングジョブを実行することはありません。具体的な hacker-news/... のオペレーション、レスポンス形状、そして落とし穴を明示するので、dev/infra/startup カテゴリのあらゆるローンチ反応やリスニングのワークフローが、毎回サーフェスを再発見する代わりに 1 つの既知のレシピから読み取れます。

読み取り専用 — 手ではなく目。公開 HN データをリサーチし、引用付きのレコードを返します。 ストーリーやコメントの投稿はせず、UnifAPI は HN の認証情報を一切保持しません。

ライブの根拠には unifapi スキルを使う

共有の unifapi スキル（OAuth MCP）を通じて一度接続し、続いて以下の オペレーションを呼び出します。ストーリーフィードは、top、new、best、ask、show、jobs のいずれかの {feed} を取ります。出力がレコードコストを記載できるよう、billing メタデータは保持してください。

レスポンス契約

単一エンティティのエンドポイントは、オブジェクトを data に返します。

{
  "request_id": "unif_...",
  "data": {},
  "billing": { "records_charged": 1, "balance_remaining": 99 }
}

リストエンドポイントは、配列を data に加えて pagination を返します。

{
  "request_id": "unif_...",
  "data": [],
  "pagination": { "has_more": false, "next_cursor": null },
  "billing": { "records_charged": 1 }
}

pagination.has_more が true のときは、pagination.next_cursor を次の リクエストの cursor として渡します（limit でページサイズを設定）。常に billing を保持してください。

コアオペレーション

{feed} ∈ top · new · best · ask · show · jobs。

ここに載っていないフィールドが必要ですか？ 呼び出す前に unifapi スキルの get_operation を使って 正確なスキーマを読みます — ただしオペレーションはこの表から選び、当てずっぽうで 探さないでください。

ワークフロー

決定論的なレシピ。ジョブに合うものを選びます。各レシピは、呼び出すべきものを 正確に明示します。

1. ウォッチを枠付けする。 フィードを選びます: ローンチや質問には show と ask、 今着地しているものには top と best、最新には new。
2. フィードをスキャンする。 hacker-news/stories/{feed}/items を呼び出し （1 回の呼び出しでハイドレート済みアイテム — id を取得してから取得するより安価）、 title または url であなたの製品やカテゴリに一致するストーリーを残します。 next_cursor でページングします。
3. スレッドを読む。 一致したアイテムでは、score（ポイント）と descendants （コメント数）を読み、続いて kids の id を hacker-news/items/{id} で辿り、 コメントツリー内の率直な批評を読みます。
4. 批評者を重み付けする。 hacker-news/users/{id} を呼び出して karma と submitted を取得し、コメント投稿者の見解がどれだけの重みを持つかを判断します。
5. 変化を見張る。 最近変更されたアイテムとプロフィールには hacker-news/updates を、 新しいスキャンの範囲を区切るには hacker-news/max-item を呼び出します。
6. すべてを引用する。 すべての数値は、それが由来する HN アイテムに結びつきます。 billing.records_charged を報告します（billing メタデータがないときは見積もります）。

形状ノート

• HackerNewsItem — type（story · comment · job · poll · pollopt）、by、time、title、url、text、score（ポイント）、 descendants（コメント数）、kids（子コメントの id、オブジェクトではない）、 parent。
• HackerNewsUser — id、created、karma、about、submitted（アイテム id）。
• HackerNewsUpdates — 最近変更された items と profiles。

落とし穴

• キーワード検索なし。 発見はフィード駆動です — top/new/best/ask/show/jobs をスキャンし、title/url で一致させます。ブリーフにそう明記してください。
• kids は子コメントの id であり、埋め込みオブジェクトではありません — hacker-news/items/{id} で再帰してコメントツリーを読みます。
• descendants はコメント数で、score はポイントです — 混同しないでください。
• ハイドレート済みのストーリーが欲しい場合は、id のリストではなく hacker-news/stories/{feed} より hacker-news/stories/{feed}/items を優先します。
• 残高が少ないと、リストページが静かに切り捨てられることがあります: billing.truncated_due_to_balance を確認します — true のときページは部分的です。

出力

呼び出し元のワークフローが必要とするレコードを、それぞれの HN アイテムに引用して返し、加えて 1 行のコストノート（records_charged）を付けます。このスキルが直接使われる場合は、 コンパクトな反応ブリーフがデフォルトです。

**{Story title}** ({feed}) — {score} points, {descendants} comments. Landed: {yes/no}. Candid takes: "{quote}" (by {user}, {karma} karma). Evidence: {item URLs}. Records: ~{N}.

関連スキル

• competitor-launch-monitor（Competitive Intelligence）、social-listening-brief（Social Listening） — この読み取りパスの上に構築するローンチ反応とリスニングの作業。
• unifapi — 共有データスキル: MCP を接続し、get_operation で正確なスキーマを調べる。