用途:通过 Chrome CDP 抓取任意 URL,将 HTML 转换为干净的 Markdown,适合把网页内容整理为可读文本。
主要能力:使用 Chrome CDP 实现完整 JavaScript 渲染;提供两种捕获模式——自动模式(页面网络空闲时捕获,适合公开页面和静态内容)与等待模式(--wait,由用户确认页面就绪后触发捕获,适合需登录、懒加载或付费墙页面);输出带元数据的 Markdown,包含 url、title、description、author、published、captured_at 等 YAML front matter 字段。
使用方式:脚本位于技能的 scripts/ 子目录,入口为 scripts/main.ts。基本命令:npx -y bun ${SKILL_DIR}/scripts/main.ts <url>;等待模式加 --wait;用 -o <path> 指定输出文件;用 --timeout <ms> 设置页面加载超时(默认 30000)。等待模式流程为:运行 --wait 后脚本提示按回车,用户确认页面就绪后向 stdin 发送换行触发捕获。输出目录为 url-to-markdown/<domain>/<slug>.md,slug 取自页面标题或 URL 路径(kebab-case,2-6 个词),冲突时追加时间戳。
配置:可通过 EXTEND.md 自定义默认输出目录、默认捕获模式与超时设置,优先检查项目级 .read-buddy/read-url-markdown/EXTEND.md,其次用户级 $HOME/.read-buddy/read-url-markdown/EXTEND.md,未找到则使用默认值。环境变量支持 URL_CHROME_PATH、URL_DATA_DIR、URL_CHROME_PROFILE_DIR。
限制:需本地可用的 Chrome;找不到 Chrome 时需设置 URL_CHROME_PATH;超时可增大 --timeout;复杂页面建议使用 --wait 模式。其余细节暂未提供。