Hacker News Data Skill

O caminho de leitura determinístico para dados públicos do Hacker News via UnifAPI. Este é um Data Skill: ele não executa um trabalho de marketing por conta própria — ele nomeia as operações hacker-news/... concretas, os formatos de resposta e as pegadinhas, para que qualquer fluxo de trabalho de recepção de lançamentos ou listening para as categorias de dev/infra/startup leia a partir de uma receita conhecida em vez de redescobrir a superfície a cada vez.

Somente leitura — olhos, não mãos. Ele pesquisa dados públicos do HN e retorna registros citados; ele nunca posta histórias ou comentários, e a UnifAPI nunca guarda credenciais do HN.

Use o skill unifapi para evidências ao vivo

Conecte-se uma vez através do skill compartilhado unifapi (OAuth MCP) e depois chame as operações abaixo. Os feeds de histórias aceitam um {feed} de top, new, best, ask, show ou jobs. Preserve qualquer metadado de billing para que a saída possa informar o custo por registro.

Contrato de resposta

Endpoints de entidade única retornam o objeto em data:

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

Endpoints de lista retornam um array em data mais pagination:

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

Quando pagination.has_more for verdadeiro, passe pagination.next_cursor como o cursor da próxima requisição (limit define o tamanho da página). Sempre preserve billing.

Operações principais

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

Precisa de um campo que não está listado aqui? Use o get_operation do skill unifapi para ler o schema exato antes de chamar — mas escolha a operação a partir desta tabela, não descubra às cegas.

Fluxo de trabalho

As receitas determinísticas. Escolha a que corresponde ao trabalho; cada uma nomeia exatamente o que chamar.

1. Enquadre o monitoramento. Escolha os feeds: show e ask para lançamentos e perguntas, top e best para o que está pegando, new para o mais fresco.
2. Varra um feed. Chame hacker-news/stories/{feed}/items (itens hidratados em uma única chamada — mais barato do que ids-e-depois-buscar) e faça o match das histórias por title ou url com o seu produto ou categoria. Pagine via next_cursor.
3. Leia a thread. Em um item correspondente, leia score (pontos) e descendants (contagem de comentários) e depois percorra os ids em kids com hacker-news/items/{id} para ler a crítica franca na árvore de comentários.
4. Pondere um crítico. Chame hacker-news/users/{id} para karma e submitted para avaliar quanto peso a opinião de um comentarista carrega.
5. Observe mudanças. Chame hacker-news/updates para itens e perfis recentemente alterados, ou hacker-news/max-item para limitar uma nova varredura.
6. Cite tudo. Cada número remete ao item do HN de onde veio; informe billing.records_charged (ou estime quando o metadado de billing estiver ausente).

Notas de formato

• HackerNewsItem — type (story · comment · job · poll · pollopt), by, time, title, url, text, score (pontos), descendants (contagem de comentários), kids (ids dos comentários filhos, não objetos), parent.
• HackerNewsUser — id, created, karma, about, submitted (ids de itens).
• HackerNewsUpdates — items e profiles que mudaram recentemente.

Pegadinhas

• Sem busca por keyword. O discovery é guiado por feed — varra top/new/best/ask/show/ jobs e faça o match por title/url. Diga isso no briefing.
• kids são ids de comentários filhos, não objetos embutidos — faça a recursão com hacker-news/items/{id} para ler a árvore de comentários.
• descendants é a contagem de comentários e score são os pontos — não os confunda.
• Prefira hacker-news/stories/{feed}/items em vez de hacker-news/stories/{feed} quando você quiser as histórias hidratadas, não uma lista de ids.
• Um saldo baixo pode truncar silenciosamente as páginas de lista: verifique billing.truncated_due_to_balance — quando verdadeiro, a página está parcial.

Saída

Retorne os registros de que o fluxo de trabalho chamador precisa, cada um citado ao seu item do HN, mais uma nota de custo de uma linha (records_charged). Quando este skill é usado diretamente, um resumo compacto de recepção é o padrão:

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

Skills relacionados

• competitor-launch-monitor (Competitive Intelligence), social-listening-brief (Social Listening) — trabalho de recepção de lançamentos e listening sobre este caminho de leitura.
• unifapi — o data skill compartilhado: conecte o MCP e consulte os schemas exatos com get_operation.