用途:用于确定性的 URL→Markdown 提取,把网页转成干净的 Markdown 而非原始 HTML,适合阅读、抽取与总结任务。
主要能力:脚本分两层处理。第一层抓取 HTML,经 Mozilla Readability 提取正文,再用 Turndown 转成 Markdown;第二层在提取内容过少时回退为纯文本 Markdown。带有 URL 安全检查,阻止 localhost 和私有 IPv4 字面量主机。
使用方式:运行 node scripts/fetch-markdown.mjs <url> [--max-chars N] [--timeout-ms N] [--json]。若退出码为 0,直接返回 Markdown 输出;若退出码为 3 或 4,或输出内容过少、仅为样板,则使用浏览器工具回退抓取渲染内容并返回 Markdown 摘要。输出仅返回 Markdown(不返回原始 HTML),保留来源 URL,截断时附截断说明,使用回退时说明所用方法(readability 或 fallback-text)。错误码:1 参数错误,2 URL 无效或被阻止,3 网络/抓取/内容类型失败,4 提取失败或内容过少。扩展说明与排障见 references/usage.md。限制:暂未提供其他平台、安装方式或非脚本用法。