readhn

AI-нативный MCP-сервер для Hacker News. Находите контент HN, который действительно важен, с помощью объяснимых сигналов качества.

Что он делает

Поиск — Фильтруйте истории по ключевым словам, баллам, времени. Получайте ранжированные результаты с сигналами качества.

Доверие — Находите экспертов в предметной области. Смотрите, кто говорит и почему это важно. Распространение доверия по алгоритму EigenTrust от seed-экспертов.

Понимание — Каждый результат объясняет, ПОЧЕМУ. 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 Code, Codex, Cursor, Claude Desktop, Cline, Windsurf и OpenCode и добавляет MCP-сервер readhn.

Полезные флаги настройки:

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-агента:

• "Покажи лучшие истории HN о Rust за эту неделю"

• "Найди экспертов, которые пишут о базах данных на HN"

• "Что практики говорят о Kubernetes networking?"

Агент вызывает инструменты 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

Как это работает

Когда вы задаёте вопросы вашему AI-агенту, он использует эти инструменты:

• discover_stories() — Лучшие истории, отфильтрованные по ключевым словам/баллам/времени, ранжированные по сигналам качества

• search() — Поиск Algolia с объяснимым ранжированием

• find_experts() — Поиск экспертов в предметной области с использованием EigenTrust на графе комментариев

• expert_brief() — Профиль пользователя + активность + оценка доверия

• story_brief() — История + лучшие комментарии + сигналы в одном вызове

• thread_analysis() — Полное дерево комментариев с сигналами качества для каждого комментария

Каждый ответ включает разбивку сигналов: почему был выбран именно этот результат.

Лицензия

MIT