← 返回 Skills 市场
2730
总下载
3
收藏
6
当前安装
6
版本数
在 OpenClaw 中安装
/install hn-extract
功能描述
Extract a HackerNews post (article + comments) into single clean Markdown for quick reading or LLM input.
使用说明 (SKILL.md)
HackerNews Extract
Extract a HackerNews post (article + comments) into single clean Markdown for quick reading or LLM input.
see Examples
What it does
- Accepts an HackerNews id or url
- Download the linked article HTML, cleans and formats it.
- Fetches the Hacknews post metadata and comments.
- Outputs a readable combined markdown file with original article, threaded comments, and key metadata.
Requirements
uvinstalled and in PATH.
Install
No install beyond having uv.
Dependencies will be installed automatically by uv into to a dedicated venv when run this script.
Usage Workflow (Mandatory for Agents)
When an agent is asked to extract a HackerNews post:
- Run the script with an output path:
uv run --script ${baseDir}/hn-extract.py \x3Cinput> -o /tmp/hn-\x3Cid>.md. - Send ONE combined message: Upload the file and ask the question in the same tool call. Use the
messagetool (action=send,filePath="/tmp/hn-\x3Cid>.md",message="Extraction complete. Do you want me to summarize it?"). - Do not output the full text or a summary directly in the chat unless specifically requested.
Usage
# run as uv script
uv run --script ${baseDir}/hn-extract.py \x3Chn-id|hn-url|path/to/item.json> [-o path/to/output.md]
# Examples
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"
- Omit
-oto print to stdout. - Directories for
-oare created automatically.
Notes
- Retries are enabled for HTTP fetches.
- Comments are indented by thread depth.
- Sites requires authentication or blocks scraping may still fail.
安全使用建议
This skill appears to do what it says: fetch HN metadata and the linked article, clean it, and produce markdown. It requires 'uv' and will make outbound HTTP requests to hn.algolia.com and whatever article URLs are linked (expected behavior). The main concern is the registry flag always: true — that makes the skill available in every agent run and increases exposure without an obvious reason. Before installing, consider: 1) Do you want this skill force-enabled for all agents? If not, ask the publisher to remove always:true or set it to user-invocable only. 2) Are you comfortable with the skill making outbound requests and writing files (temporary paths like /tmp)? 3) If you plan to pass local file paths, be aware the script will read those files. If anything about the always:true setting or network/file behavior worries you, do not install until the author justifies the permanent inclusion or you review/modify the code yourself.
功能分析
Type: OpenClaw Skill
Name: hn-extract
Version: 0.1.5
The skill bundle is benign. The `SKILL.md` provides clear instructions for the AI agent to run the Python script, save output to `/tmp`, and then upload the file with a follow-up question, all aligned with the stated purpose and lacking any prompt injection attempts for malicious actions. The `hn-extract.py` script uses standard Python libraries (`requests`, `trafilatura`) to fetch data from the HackerNews API and linked articles, clean HTML, and format it into Markdown. It performs network requests and file system writes (to the specified output path or `/tmp`), which are necessary for its functionality, without any evidence of data exfiltration to unauthorized endpoints, malicious execution, persistence, or obfuscation.
能力评估
Purpose & Capability
Name/description align with the code and instructions: the script fetches HN metadata from hn.algolia.com, downloads the linked article HTML, cleans it, and writes combined Markdown. The only required binary is 'uv', which the SKILL.md and shebang explain is used to run the script and manage Python deps.
Instruction Scope
SKILL.md gives explicit runtime steps: run the Python script via 'uv', then upload the generated file in a single message tool call and optionally ask whether to summarize. These instructions are scoped to delivering the extracted file to the user/agent. Note: the script fetches arbitrary article URLs (expected for this tool) and can read an input .json file if provided — both are consistent with the stated purpose but mean the skill performs outbound network requests and can read local JSON files passed as inputs.
Install Mechanism
No install spec is provided beyond requiring 'uv' on PATH. The script declares its Python dependencies in header comments (uv will install them into a venv at run time). This is low-risk compared to arbitrary remote installers or embedded binary downloads.
Credentials
The skill requests no environment variables, no credentials, and no config paths. That is appropriate for an extractor that operates with public HN APIs and by fetching public article URLs.
Persistence & Privilege
The registry flag always: true forces the skill to be included in every agent run. There is no justification in the SKILL.md for it to be always active — an extraction tool does not normally require permanent inclusion. always:true increases the attack surface and should be questioned or removed unless a clear reason is provided.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install hn-extract - 安装完成后，直接呼叫该 Skill 的名称或使用
/hn-extract触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v0.1.5
hn-extract 0.1.5
- Updated documentation to clarify accepted inputs: now specifies support for only HackerNews ID or URL, removing reference to saved Algolia JSON files.
- Examples and usage instructions streamlined to match supported input types.
- Notes section updated to remove mention of article retrieval using trafilatura and Algolia specifics.
v0.1.4
- No user-facing changes in this version.
- Internal code updates only; documentation remains unchanged.
v0.1.3
- No user-facing changes in this release; internal changes only.
- Documentation, usage, and workflow descriptions remain unchanged.
v0.1.2
- Clarified workflow instructions for agents: agents must upload the file and send the follow-up message in a single tool call.
- Updated example link from a single output file to an examples directory.
- Minor language updates for clarity and consistency in documentation.
v0.1.1
- Added a mandatory workflow section for agents, specifying script execution, file upload, and user confirmation steps.
- Clarified that agents should not output the full text or a summary in chat unless requested.
- Minor clarification to the notes on article fetching with `trafilatura`.
v0.1.0
Initial release of hn-extract.
- Extracts HackerNews articles and comments into clean Markdown for easy reading or LLM input.
- Accepts HackerNews post IDs, URLs, or saved Algolia JSON files as input.
- Scrapes and formats the main article and fetches complete comment threads, combining them with story metadata.
- Outputs as a readable Markdown file or to stdout.
- Handles dependencies automatically using `uv`; only `uv` needs to be pre-installed.
- Supports robust HTTP fetching with retries and creates output directories as needed.
元数据
常见问题
HackerNews Extract 是什么？
Extract a HackerNews post (article + comments) into single clean Markdown for quick reading or LLM input. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2730 次。
如何安装 HackerNews Extract？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install hn-extract」即可一键安装，无需额外配置。
HackerNews Extract 是免费的吗？
是的，HackerNews Extract 完全免费（开源免费），可自由下载、安装和使用。
HackerNews Extract 支持哪些平台？
HackerNews Extract 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（darwin, linux, win32）。
谁开发了 HackerNews Extract？
由 guoqiao（@guoqiao）开发并维护，当前版本 v0.1.5。
推荐 Skills