SuperAPI AI 工具集

baoyu-url-to-markdown

办公与效率

查看项目

更新于 10-16 00:04

技能介绍

用途:通过 Chrome CDP 抓取任意 URL,将 HTML 转换为整洁的 Markdown。脚本位于技能的 scripts/ 子目录,需将文档中的 ${SKILL_DIR} 替换为实际路径。

主要能力:使用 Chrome CDP 完成完整 JavaScript 渲染;两种捕获模式;输出带元数据的整洁 Markdown;通过等待模式处理需登录页面。

使用方式: 自动模式(默认,页面加载后捕获): 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> 待抓取 URL;-o <path> 输出文件路径(默认自动生成);--wait 等待用户信号后捕获;--timeout <ms> 页面加载超时(默认 30000)。

捕获模式:自动(默认)在网络空闲时捕获,适用于公开页面、静态内容;等待(--wait)由用户确认就绪,适用于需登录、懒加载、付费墙页面。等待模式流程:以 --wait 运行后脚本输出“Press Enter when ready”,请用户确认页面就绪,再向 stdin 发送换行触发捕获。

输出格式:YAML front matter 包含 url、title、description、author、published、captured_at 字段,后接转换后的 Markdown 内容。输出目录:url-to-markdown/<domain>/<slug>.md,<slug> 取自页面标题或 URL 路径(kebab-case,2-6 词),冲突时追加时间戳 <slug>-YYYYMMDD-HHMMSS.md。

偏好设置:可用 Bash 检查 EXTEND.md,优先项目级 .baoyu-skills/baoyu-url-to-markdown/EXTEND.md,其次用户级 $HOME/.baoyu-skills/baoyu-url-to-markdown/EXTEND.md;找到则读取并应用设置,未找到则使用默认值。支持的配置包括默认输出目录、默认捕获模式、超时设置。

环境变量:URL_CHROME_PATH 自定义 Chrome 可执行文件路径;URL_DATA_DIR 自定义数据目录;URL_CHROME_PROFILE_DIR 自定义 Chrome 配置目录。

故障排查:Chrome 未找到时设置 URL_CHROME_PATH;超时时增大 --timeout;复杂页面可尝试 --wait 模式。其余平台、收费与效果信息暂未提供。