Hacker News Data Skill

La vía de lectura determinista para datos públicos de Hacker News a través de UnifAPI. Esta es una Data Skill: no ejecuta un trabajo de marketing por sí sola — nombra las operaciones hacker-news/... concretas, las formas de respuesta y las trampas para que cualquier workflow de recepción de lanzamientos o de listening para las categorías dev/infra/startup lea de una receta conocida en lugar de redescubrir la superficie cada vez.

Solo lectura — ojos, no manos. Investiga datos públicos de HN y devuelve registros citados; nunca publica historias ni comentarios, y UnifAPI nunca guarda credenciales de HN.

Usa la skill unifapi para obtener evidencia en vivo

Conecta una vez a través de la skill compartida unifapi (OAuth MCP), luego llama a las operaciones de abajo. Los feeds de historias toman un {feed} de top, new, best, ask, show o jobs. Conserva cualquier metadato de billing para que el output pueda indicar el coste por registro.

Contrato de respuesta

Los endpoints de entidad única devuelven el objeto en data:

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

Los endpoints de lista devuelven un array en data más pagination:

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

Cuando pagination.has_more es true, pasa pagination.next_cursor como el cursor de la siguiente petición (limit fija el tamaño de página). Conserva siempre billing.

Operaciones core

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

¿Necesitas un campo que no esté listado aquí? Usa get_operation de la skill unifapi para leer el esquema exacto antes de llamar — pero elige la operación de esta tabla, no descubras a ciegas.

Workflow

Las recetas deterministas. Elige la que coincida con el trabajo; cada una nombra exactamente qué llamar.

1. Encuadra la vigilancia. Elige los feeds: show y ask para lanzamientos y preguntas, top y best para lo que está aterrizando, new para lo más fresco.
2. Escanea un feed. Llama a hacker-news/stories/{feed}/items (items hidratados en una sola llamada — más barato que ids-luego-fetch) e identifica las historias por title o url que coincidan con tu producto o categoría. Pagina vía next_cursor.
3. Lee el hilo. En un item coincidente, lee score (puntos) y descendants (número de comentarios), luego recorre los ids de kids con hacker-news/items/{id} para leer la crítica franca del árbol de comentarios.
4. Pondera a un crítico. Llama a hacker-news/users/{id} para karma y submitted para juzgar cuánto peso tiene la opinión de un comentarista.
5. Vigila los cambios. Llama a hacker-news/updates para los items y perfiles cambiados recientemente, o hacker-news/max-item para acotar un escaneo fresco.
6. Cita todo. Cada cifra se ata al item de HN del que provino; reporta billing.records_charged (o estima cuando falte el metadato de billing).

Notas de forma

• HackerNewsItem — type (story · comment · job · poll · pollopt), by, time, title, url, text, score (puntos), descendants (número de comentarios), kids (ids de comentarios hijos, no objetos), parent.
• HackerNewsUser — id, created, karma, about, submitted (ids de items).
• HackerNewsUpdates — items y profiles que cambiaron recientemente.

Trampas

• Sin búsqueda por keyword. El descubrimiento es feed-driven — escanea top/new/best/ask/show/ jobs e identifica por title/url. Dilo en el brief.
• kids son ids de comentarios hijos, no objetos embebidos — recursa con hacker-news/items/{id} para leer el árbol de comentarios.
• descendants es el número de comentarios y score son los puntos — no los confundas.
• Prefiere hacker-news/stories/{feed}/items sobre hacker-news/stories/{feed} cuando quieras las historias hidratadas, no una lista de ids.
• Un saldo bajo puede truncar silenciosamente páginas de lista: comprueba billing.truncated_due_to_balance — cuando es true la página es parcial.

Output

Devuelve los registros que el workflow que llama necesita, cada uno citado a su item de HN, más una nota de coste de una línea (records_charged). Cuando esta skill se usa directamente, un brief de recepción compacto es el predeterminado:

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

Related skills

• competitor-launch-monitor (Competitive Intelligence), social-listening-brief (Social Listening) — trabajo de recepción de lanzamientos y de listening sobre esta vía de lectura.
• unifapi — la skill de datos compartida: conecta MCP y busca esquemas exactos con get_operation.