MCP HubMCP Hub
SKILL·E7DC9B

hn-summarize

ykdojo
Mis à jour 6 days ago
8,994
690
8,994
Voir sur GitHub
Designgeneral

À propos

Cette Compétence Claude récupère et résume les principales actualités et fils de commentaires de Hacker News en utilisant les API officielles. Utilisez-la lorsqu'on vous demande de résumer la page d'accueil, la discussion d'un article spécifique ou les meilleurs éléments de hckrnews. Elle extrait des données structurées (points, nombre de commentaires, fils complets) sans recourir au scraping, en s'appuyant sur les endpoints Firebase et Algolia.

Installation rapide

Claude Code

Recommandé
Principal
npx skills add ykdojo/claude-code-tips -a claude-code
Commande PluginAlternatif
/plugin add https://github.com/ykdojo/claude-code-tips
Git CloneAlternatif
git clone https://github.com/ykdojo/claude-code-tips.git ~/.claude/skills/hn-summarize

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation

HN Summarize

hckrnews.com is a JavaScript-rendered front end - curling it returns an empty shell, so do not scrape it. Instead use the official Hacker News APIs (Firebase + Algolia), which give the same stories with points, comment counts, and full comment trees. These APIs return plain JSON, so plain curl works fine.

1. Current top stories (the "top 10")

topstories.json returns 500 story IDs in front-page rank order. Take the first N and look up each item.

curl -sL 'https://hacker-news.firebaseio.com/v0/topstories.json' -o /tmp/top.json
python3 -c "
import json,urllib.request
ids=json.load(open('/tmp/top.json'))[:10]
for i,sid in enumerate(ids,1):
    d=json.load(urllib.request.urlopen(f'https://hacker-news.firebaseio.com/v0/item/{sid}.json'))
    print(f\"{i}. {d.get('title')} | {d.get('score')} pts | {d.get('descendants',0)} comments | id {sid}\")
    print(f\"   {d.get('url','(text post)')}\")
"

2. Find a specific story by topic (Algolia search)

curl -sL 'https://hn.algolia.com/api/v1/search?query=YOUR+QUERY&tags=story' -o /tmp/s.json
python3 -c "
import json
for h in json.load(open('/tmp/s.json'))['hits'][:8]:
    print(h['objectID'], '|', h.get('points'), 'pts |', h.get('num_comments'), 'comments |', h['title'])
    print('   ', h.get('url'))
"
  • Add &numericFilters=created_at_i>UNIXTS to restrict to recent stories (avoids matching an old duplicate of the same headline).
  • search ranks by relevance; search_by_date ranks by recency.
  • Pick the objectID with the highest points/comments - that's the live front-page discussion.

3. Fetch a story + its comment tree

curl -sL 'https://hn.algolia.com/api/v1/items/OBJECT_ID' -o /tmp/hn.json

The response is a nested tree: top-level children are root comments, each with their own children. Flatten and print root comments in thread order (HN's default ranking ≈ this order):

python3 -c "
import json,re
d=json.load(open('/tmp/hn.json'))
def clean(t):
    t=re.sub('<[^>]+>',' ',t)
    for a,b in [('&#x27;',chr(39)),('&gt;','>'),('&lt;','<'),('&amp;','&'),('&quot;','\"')]:
        t=t.replace(a,b)
    return re.sub(' +',' ',t).strip()
for c in d.get('children',[])[:15]:
    if c.get('text'):
        print(f\"{c.get('author')}: {clean(c['text'])[:550]}\")
        print('---')
"

Note: Algolia's per-comment points field is now always null, so sort by thread order (already roughly HN's ranking) rather than by points. For deeper threads, recurse into children and track depth.

4. Fetch the linked article

Fetch the story's article with curl -sL <url>, then strip tags with sed 's/<[^>]*>//g' to extract readable text, or grep for the key sentences. If the page is JS-heavy or paywalled, try a Wayback Machine snapshot:

curl -sL 'http://archive.org/wayback/available?url=ARTICLE_URL' -o /tmp/wb.json
python3 -c "import json;print(json.load(open('/tmp/wb.json'))['archived_snapshots'].get('closest',{}).get('url'))"

Then fetch the snapshot URL the same way. If the host blocks outbound curl requests, fetch through a container or proxy you have available.

Summary format

For each story give: title, points, comment count, source, a few sentences on what the article says, then comment themes - group the discussion into 3-6 recurring threads (agreement, rebuttals, tangents) rather than listing comments one by one. Note when the top thread is a critical/contrarian take, since that's common on HN.

Dépôt GitHub

ykdojo/claude-code-tips
Chemin: skills/hn-summarize
0
agenticagentic-aiagentic-codingagentic-workflowaiclaude
FAQ

Frequently asked questions

What is the hn-summarize skill?

hn-summarize is a Claude Skill by ykdojo. Skills package instructions and resources that Claude loads on demand, so Claude can perform hn-summarize-related tasks without extra prompting.

How do I install hn-summarize?

Use the install commands on this page: add hn-summarize to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.

What category does hn-summarize belong to?

hn-summarize is in the Design category, tagged general.

Is hn-summarize free to use?

Yes. hn-summarize is listed on AIMCP and free to install. It runs inside Claude, so no separate service account is required to use the skill itself.

Compétences associées

executing-plans
Design

Utilisez la compétence executing-plans lorsque vous disposez d'un plan de mise en œuvre complet à exécuter par lots contrôlés avec des points de contrôle de revue. Elle charge et examine le plan de manière critique, puis exécute les tâches par petits lots (3 tâches par défaut) tout en rapportant la progression entre chaque lot pour une revue par l'architecte. Cela garantit une mise en œuvre systématique avec des points de contrôle de qualité intégrés.

Voir la compétence
requesting-code-review
Design

Cette compétence délègue un sous-agent réviseur de code pour analyser les modifications apportées au code par rapport aux exigences avant de poursuivre. Elle doit être utilisée après avoir terminé des tâches, implémenté des fonctionnalités majeures, ou avant une fusion vers la branche principale. La revue aide à détecter précocement les problèmes en comparant l'implémentation actuelle avec le plan initial.

Voir la compétence
connect-mcp-server
Design

Cette compétence fournit un guide complet permettant aux développeurs de connecter des serveurs MCP à Claude Code via les transports HTTP, stdio ou SSE. Elle couvre l'installation, la configuration, l'authentification et la sécurité pour intégrer des services externes tels que GitHub, Notion et des API personnalisées. Utilisez-la lors de la configuration d'intégrations MCP, de la configuration d'outils externes ou du travail avec le Protocole de Contexte de Modèle de Claude.

Voir la compétence
web-cli-teleport
Design

Cette compétence aide les développeurs à choisir entre les interfaces Web et CLI de Claude Code en fonction de l'analyse des tâches, puis permet une téléportation transparente des sessions entre ces environnements. Elle optimise le flux de travail en gérant l'état et le contexte de la session lors du passage entre le web, la CLI ou le mobile. Utilisez-la pour des projets complexes nécessitant différents outils à diverses étapes.

Voir la compétence