Hacker News Data Skill

Der deterministische Lesepfad für öffentliche Hacker News-Daten über UnifAPI. Dies ist ein Data Skill: Er führt für sich genommen keinen Marketing-Job aus — er benennt die konkreten hacker-news/...-Operationen, Antwortformen und Gotchas, sodass jeder Launch-Rezeptions- oder Listening-Workflow für Dev-/Infra-/Startup-Kategorien aus einem bekannten Rezept liest, anstatt die Oberfläche jedes Mal neu zu entdecken.

Schreibgeschützt — Augen, keine Hände. Er recherchiert öffentliche HN-Daten und gibt zitierte Datensätze zurück; er postet nie Stories oder Kommentare, und UnifAPI hält nie HN- Anmeldedaten.

Nutzen Sie den unifapi-Skill für Live-Evidenz

Verbinden Sie sich einmal über den gemeinsamen unifapi-Skill (OAuth MCP) und rufen Sie dann die Operationen unten auf. Story-Feeds nehmen einen {feed} von top, new, best, ask, show oder jobs. Bewahren Sie alle billing-Metadaten auf, damit die Ausgabe die Datensatzkosten angeben kann.

Antwort-Vertrag

Single-Entity-Endpunkte geben das Objekt in data zurück:

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

Listen-Endpunkte geben ein Array in data plus pagination zurück:

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

Wenn pagination.has_more true ist, übergeben Sie pagination.next_cursor als cursor der nächsten Anfrage (limit setzt die Seitengröße). Bewahren Sie billing immer auf.

Kernoperationen

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

Brauchen Sie ein hier nicht aufgeführtes Feld? Nutzen Sie das get_operation des unifapi-Skills, um das exakte Schema vor dem Aufruf zu lesen — wählen Sie die Operation aber aus dieser Tabelle, entdecken Sie nicht blind.

Workflow

Die deterministischen Rezepte. Wählen Sie das, das zum Job passt; jedes benennt genau, was aufzurufen ist.

1. Den Watch abstecken. Wählen Sie die Feeds: show und ask für Launches und Fragen, top und best für das, was landet, new für das Frischeste.
2. Einen Feed scannen. Rufen Sie hacker-news/stories/{feed}/items (hydratisierte Items in einem Aufruf — günstiger als IDs-dann-Abrufen) auf und matchen Sie Stories über title oder url zu Ihrem Produkt oder Ihrer Kategorie. Blättern Sie über next_cursor.
3. Den Thread lesen. Lesen Sie bei einem passenden Item score (Punkte) und descendants (Kommentaranzahl), dann durchlaufen Sie die kids-IDs mit hacker-news/items/{id}, um die offene Kritik im Kommentarbaum zu lesen.
4. Einen Kritiker gewichten. Rufen Sie hacker-news/users/{id} für karma und submitted auf, um zu beurteilen, wie viel die Einschätzung eines Kommentierenden trägt.
5. Auf Änderungen achten. Rufen Sie hacker-news/updates für kürzlich geänderte Items und Profile auf, oder hacker-news/max-item, um einen frischen Scan zu begrenzen.
6. Alles zitieren. Jede Zahl knüpft an das HN-Item an, aus dem sie stammt; berichten Sie billing.records_charged (oder schätzen Sie, wenn Billing-Metadaten fehlen).

Form-Notizen

• HackerNewsItem — type (story · comment · job · poll · pollopt), by, time, title, url, text, score (Punkte), descendants (Kommentaranzahl), kids (Kind-Kommentar-IDs, keine Objekte), parent.
• HackerNewsUser — id, created, karma, about, submitted (Item- IDs).
• HackerNewsUpdates — items und profiles, die sich kürzlich geändert haben.

Gotchas

• Keine Stichwortsuche. Discovery ist feed-getrieben — scannen Sie top/new/best/ask/show/ jobs und matchen Sie über title/url. Sagen Sie das im Briefing.
• kids sind Kind-Kommentar-IDs, keine eingebetteten Objekte — rekursieren Sie mit hacker-news/items/{id}, um den Kommentarbaum zu lesen.
• descendants ist die Kommentaranzahl und score sind die Punkte — verwechseln Sie sie nicht.
• Bevorzugen Sie hacker-news/stories/{feed}/items gegenüber hacker-news/stories/{feed}, wenn Sie die hydratisierten Stories wollen, nicht eine Liste von IDs.
• Ein niedriges Guthaben kann Listenseiten stillschweigend abschneiden: prüfen Sie billing.truncated_due_to_balance — wenn true, ist die Seite unvollständig.

Ausgabe

Geben Sie die Datensätze zurück, die der aufrufende Workflow braucht, jeweils zitiert zu seinem HN-Item, plus einer Einzeiler-Kostennotiz (records_charged). Wenn dieser Skill direkt genutzt wird, ist ein kompaktes Rezeptions-Briefing der Standard:

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

Verwandte Skills

• competitor-launch-monitor (Competitive Intelligence), social-listening-brief (Social Listening) — Launch-Rezeptions- und Listening-Arbeit auf Basis dieses Lesepfads.
• unifapi — der gemeinsame Daten-Skill: verbinden Sie MCP und schlagen Sie exakte Schemas mit get_operation nach.