# Hackernews API Ingest

> Incubating Butler wrapper spec for upstream 'Hacker News API'.

- Skill: `ocean326/hackernews-api-ingest` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add ocean326/hackernews-api-ingest`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ocean326/hackernews-api-ingest/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: ocean326 (https://skillmd.com/u/ocean326)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ocean326/hackernews-api-ingest

---

# Hacker News API

## Status

- `incubating`
- 这不是生产可执行 skill，而是 Butler 对外部上游的包装草案。
- 默认不得加入 `chat_default` / `codex_default` / `automation_safe`。

## Proposed Butler Shape

- HN top/new/best story ingestion, comment-tree fetch, launch sentiment snapshots

## Upstream

- repo_or_entry: https://github.com/HackerNews/API
- docs: https://github.com/HackerNews/API
- upstream_type: official_api
- maturity: high

## Why This Matters

- Official and lightweight. Easy to operationalize without complex auth.
- Excellent source for engineering, startup, and tool ecosystem signals.

## Risks

- Thread trees can be large and noisy.
- Needs rank-window and keyword filters to stay useful.

## Suggested Future Exposure

- automation_safe
- skill_ops

## Implementation Checklist

- 明确 Butler 输入输出 contract，不直接复刻上游 API。
- 确认认证、限流、缓存和错误恢复策略。
- 补执行脚本或 tool bridge，而不是只停留在说明文档。
- 补测试与 `skill-pool-verify` / `skill-pool-maintain` 校验。
- 审阅后再决定是否加入 collection registry。