名称： hn-extract
描述： 将 HackerNews 帖子（文章 + 评论）提取为一份简洁的 Markdown 文档，便于快速阅读或作为 LLM 输入。
元数据： {"openclaw":{"always":true,"emoji":"🦞","homepage":"https://github.com/guoqiao/skills/blob/main/hn-extract/hn-extract/SKILL.md","os":["darwin","linux","win32"],"tags":["hn","hackernews","comments","extract","markdown","python","uv","scraper","rss","reader","summarize"],"requires":{"bins":["uv"]}}}

HackerNews 内容提取

将 HackerNews 帖子（文章 + 评论）提取为一份简洁的 Markdown 文档，便于快速阅读或作为 LLM 输入。

查看示例

功能

• 接受 HackerNews 帖子 ID 或 URL。
• 下载链接文章的 HTML，进行清理和格式化。
• 获取 HackerNews 帖子的元数据和评论。
• 输出一份可读性强的合并 Markdown 文件，包含原文、层级化评论和关键元数据。

环境要求

• 已安装 uv 并已加入 PATH。

安装

除 uv 外无需额外安装。运行脚本时，uv 会自动将依赖项安装到独立的虚拟环境中。

使用流程（智能体必读）

当智能体被要求提取 HackerNews 帖子时：
1. 运行脚本并指定输出路径：uv run --script ${baseDir}/hn-extract.py <input> -o /tmp/hn-<id>.md。
2. 发送一条合并消息：在同一次工具调用中上传文件并提问。使用 message 工具（设置 action=send，filePath="/tmp/hn-<id>.md"，message="提取完成。需要我为您总结吗？"）。
3. 不要在聊天中直接输出全文或摘要，除非用户明确要求。

使用方法

# 作为 uv 脚本运行
uv run --script ${baseDir}/hn-extract.py <hn-id|hn-url|path/to/item.json> [-o path/to/output.md]

# 示例
uv run --script ${baseDir}/hn-extract.py 46861313 -o /tmp/output.md
uv run --script ${baseDir}/hn-extract.py "https://news.ycombinator.com/item?id=46861313"

• 省略 -o 选项将输出到标准输出。
• -o 指定的目录会自动创建。

注意事项

• HTTP 请求启用了重试机制。
• 评论根据对话深度进行缩进。
• 需要身份验证或阻止爬取的网站可能仍会失败。