SuperAPI AI 工具集

baoyu-url-to-markdown

通用与其它

查看项目

更新于 10-16 09:57

技能介绍

用途:通过 Chrome CDP 获取任意 URL,将 HTML 转换为干净的 Markdown,适合把网页内容转成可保存的文档。

主要能力:使用 Chrome CDP 实现完整 JavaScript 渲染;提供两种捕获模式——自动模式(页面网络空闲时捕获,适合公开页面和静态内容)与等待模式(--wait,由用户确认页面就绪后触发捕获,适合需登录、懒加载或付费墙页面);输出带 YAML front matter 的 Markdown,包含 url、title、description、author、published、captured_at 字段。

使用方式:脚本位于该技能的 scripts/ 子目录,入口为 ${SKILL_DIR}/scripts/main.ts。常用命令: 自动模式:npx -y bun ${SKILL_DIR}/scripts/main.ts <url> 等待模式:npx -y bun ${SKILL_DIR}/scripts/main.ts <url> --wait 指定输出:npx -y bun ${SKILL_DIR}/scripts/main.ts <url> -o output.md 选项包括 <url>、-o <path>(默认自动生成)、--wait、--timeout <ms>(默认 30000)。等待模式流程:运行后脚本提示“Press Enter when ready”,用户确认页面就绪后向 stdin 发送换行触发捕获。

输出目录:url-to-markdown/<domain>/<slug>.md,slug 来自页面标题或 URL 路径(kebab-case,2-6 个词),冲突时追加时间戳 <slug>-YYYYMMDD-HHMMSS.md。

配置:可用 EXTEND.md 设置默认输出目录、默认捕获模式、超时;优先项目级 .baoyu-skills/baoyu-url-to-markdown/EXTEND.md,其次用户级 $HOME/.baoyu-skills/baoyu-url-to-markdown/EXTEND.md。环境变量支持 URL_CHROME_PATH、URL_DATA_DIR、URL_CHROME_PROFILE_DIR。

限制与排查:Chrome 未找到时设置 URL_CHROME_PATH;超时则增大 --timeout;复杂页面可尝试 --wait 模式。其余细节资料未提供。