Hacker News 数据 Skill

通过 UnifAPI 读取公开 Hacker News 数据的确定性读取路径。这是一个 Data Skill：它本身不运行营销任务——它点明具体的 hacker-news/... 操作、响应 形态和坑点，让任何面向开发/基础设施/创业品类的发布反响或聆听工作流，都从一份 已知的配方读取，而不必每次都重新摸索这个面。

只读——眼睛，而非双手。它调研公开的 HN 数据并返回带引证的记录；它绝不发帖 或评论，且 UnifAPI 绝不持有 HN 凭据。

用 unifapi skill 获取实时证据

通过共享的 unifapi skill 连接一次（OAuth MCP），然后调用下面的操作。帖子 信息流接受一个 {feed}，取值为 top、new、best、ask、show 或 jobs。保留任何 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 为真时，把 pagination.next_cursor 作为下一次请求的 cursor 传入（limit 设置页大小）。始终保留 billing。

核心操作

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

需要这里未列出的字段？在调用前用 unifapi skill 的 get_operation 读取确切的 schema——但要从这张表里挑操作，别盲目摸索。

工作流

确定性的配方。挑选与任务匹配的那一个；每个都点明了究竟该调用什么。

1. **框定监测范围。**挑选信息流：show 和 ask 用于发布和提问，top 和 best 用于看什么正在登顶，new 用于最新鲜的。
2. **扫描一个信息流。**调用 hacker-news/stories/{feed}/items（一次调用返回已填充 的条目——比先取 id 再抓取更省），并按 title 或 url 把帖子匹配到你的产品或 品类。通过 next_cursor 翻页。
3. **读取帖子讨论。**在一个匹配的条目上，读取 score（分数）和 descendants （评论数），然后用 hacker-news/items/{id} 遍历 kids 的 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}/items 而非 hacker-news/stories/{feed}。
• 余额过低会悄无声息地截断列表页：检查 billing.truncated_due_to_balance——为真 时该页是不完整的。

输出

返回调用方工作流所需的记录，每条都引证到其 HN 条目，外加一行成本说明 （records_charged）。当本技能被直接使用时，默认是一份紧凑的反响简报：

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

相关 skills

• competitor-launch-monitor（Competitive Intelligence）、social-listening-brief（Social Listening）—— 在本读取路径之上的发布反响与聆听工作。
• unifapi —— 共享的数据技能：连接 MCP 并用 get_operation 查找确切的 schema。