readhn

AI 네이티브 HackerNews MCP 서버. 설명 가능한 품질 신호로 중요한 HN 콘텐츠를 찾아보세요.

기능

발견(Discover) — 키워드, 점수, 시간으로 스토리를 필터링하세요. 품질 신호로 정렬된 결과를 얻으세요.

신뢰(Trust) — 도메인 전문가를 찾아보세요. 누가 이야기하고 있는지, 왜 중요한지 확인하세요. 시드 전문가로부터의 EigenTrust 전파.

이해(Understand) — 모든 결과가 이유를 설명합니다. 5가지 신호: 실무자 깊이(30%), 스레드 깊이(20%), 전문가 참여(20%), 속도(15%), 참조(15%).

Related MCP server: Hacker News MCP Server

빠른 시작

# Install
pip install readhn

# Auto-configure supported AI agents
readhn setup

readhn setup은 Claude Desktop, Codex, Cursor, Claude Desktop, Cline, Windsurf, OpenCode 설정 경로를 감지하고 readhn MCP 서버를 추가합니다.

유용한 설정 플래그:

readhn setup --list              # Show detected agents
readhn setup --dry-run           # Preview config changes only
readhn setup --agents "Cursor"  # Configure only specific agents

설정 후, AI 에이전트가 readhn을 자동으로 발견하고 HN 관련 질문을 할 때 사용합니다.

사용법

AI 에이전트에게 물어보세요:

• "이번 주 Rust 관련 HN 상위 스토리를 보여줘"

• "HN에서 데이터베이스에 대해 글을 쓰는 전문가를 찾아줘"

• "Kubernetes 네트워킹에 대해 실무자들이 뭐라고 했는지 알려줘"

에이전트는 readhn 도구를 호출하고, 품질 신호가 포함된 결과를 얻은 뒤, 각 결과가 왜 중요한지 설명합니다.

설정 (선택 사항)

export HN_KEYWORDS="ai,llm,rust,distributed-systems,databases"  # Default filter keywords
export HN_MIN_SCORE="50"                                         # Minimum story score
export HN_EXPERTS="tptacek,simonw,antirez,ept,jepsen"           # Seed experts for trust
export HN_TIME_HOURS="24"                                        # Time window

작동 방식

HN 관련 질문을 하면 AI 에이전트는 다음 도구를 사용합니다:

• discover_stories() — 키워드/점수/시간으로 필터링된 상위 스토리, 품질 신호로 정렬

• search() — 설명 가능한 랭킹이 적용된 Algolia 검색

• find_experts() — 댓글 그래프에서 EigenTrust를 사용한 도메인 전문가 찾기

• expert_brief() — 사용자 프로필 + 활동 + 신뢰 점수

• story_brief() — 스토리 + 댓글 + 신호를 한 번에

• thread_analysis() — 댓글별 품질 신호가 포함된 전체 댓글 트리

모든 응답에는 신호 분석이 포함됩니다: 각 결과가 선택된 이유.

라이선스

MIT