SuperAPI AI 工具集

baoyu-url-to-markdown

办公与效率

查看项目

更新于 10-16 08:09

技能介绍

用途:通过 Chrome CDP 抓取任意 URL,将 HTML 转换为整洁的 Markdown,适用于公开页面抓取以及需要登录、懒加载或付费墙的页面。

主要能力:使用 Chrome CDP 实现完整 JavaScript 渲染;提供两种捕获模式——自动模式(默认,在网络空闲时捕获)和等待模式(--wait,由用户发出信号后捕获);输出包含 YAML front matter(url、title、description、author、published、captured_at)及转换后的 Markdown 内容。

使用方式:脚本位于技能的 scripts/ 子目录,需将 SKILL_DIR 替换为 SKILL.md 实际目录路径。命令示例: 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)。

等待模式流程:以 --wait 运行后脚本输出“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 自定义 Chrome 路径;URL_DATA_DIR 自定义数据目录;URL_CHROME_PROFILE_DIR 自定义 Chrome 配置目录。

限制与排错:Chrome 未找到时设置 URL_CHROME_PATH;超时可增大 --timeout;复杂页面可尝试 --wait 模式。收费、价格、平台等信息暂未提供。