SuperAPI AI 工具集

baoyu-url-to-markdown

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:抓取任意 URL,借助 Chrome CDP 完成 JavaScript 渲染,再将 HTML 转换为带元数据的整洁 Markdown。

主要能力:Chrome CDP 完整 JS 渲染;两种抓取模式——自动(默认,网络空闲时抓取,适合公开静态页)与等待模式(--wait,适合需登录、懒加载或付费墙页面);输出 YAML front matter,含 url、title、description、author、published、captured_at 字段;可用 --download-media 将图片、视频下载到本地 imgs/ 与 videos/ 并改写为相对路径。

用法:脚本位于技能目录的 scripts/ 子目录,主入口为 scripts/main.ts,需将 ${SKILL_DIR} 替换为实际路径。示例命令: 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 npx -y bun ${SKILL_DIR}/scripts/main.ts <url> --download-media 选项:-o 指定输出文件;--wait 等待用户信号;--timeout <ms> 页面加载超时(默认 30000);--download-media 下载媒体。等待模式流程为运行后脚本提示按 Enter,用户确认页面就绪后向 stdin 发送换行触发抓取。默认输出到 url-to-markdown/<domain>/<slug>.md,slug 取自标题或 URL 路径(kebab-case,2-6 词),冲突时追加时间戳。

偏好配置:通过 EXTEND.md 配置,优先读取项目级 .baoyu-skills/baoyu-url-to-markdown/EXTEND.md,其次用户级 $HOME/.baoyu-skills/baoyu-url-to-markdown/EXTEND.md。支持 download_media(ask/1/0)、default_output_dir 等键。若未找到 EXTEND.md,会阻塞并要求先完成首次设置,向用户询问媒体处理方式、默认输出目录及偏好保存位置后再创建,不会静默使用默认值。取值优先级为命令行参数、EXTEND.md、技能默认值。

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

限制:需本地可用的 Chrome;超时可调大 --timeout,复杂页面可尝试 --wait;首次设置未完成前不会执行转换。其余收费、平台等信息资料未提供。