url2pdf

📄 一键生成移动端友好 PDF

基于 Playwright 浏览器引擎,将任意网页快速转换为移动端优化的 PDF 文档,便于离线阅读与资料归档。

收藏
5.9k
安装
1.9k
版本
v0.0.2
CLS 安全性认证2026-05-09
点击查看完整报告 >

使用说明

url2pdf 是一款轻量级的网页转 PDF 工具,专为需要将在线内容保存为离线文档的用户设计。该技能基于 Python 脚本开发,利用 Microsoft Playwright 浏览器自动化技术,通过命令行方式将指定 URL 的网页内容渲染并导出为适合移动设备阅读的 PDF 格式。

核心用法极为简洁。用户只需通过 /url2pdf <url> 命令或自然语言触发,系统便会调用预装的 Playwright 引擎启动 Chromium 浏览器,访问目标网页,等待页面渲染完成后生成 PDF 文件。整个过程通过 uv 包管理器自动处理依赖,生成的 PDF 默认保存在用户文档目录,也可通过环境变量自定义输出路径。脚本支持 Darwin、Linux 和 Windows 三大操作系统平台。

显著优点体现在多个方面。首先,它完全本地运行,所有数据处理都在用户设备上完成,不会将网页内容或生成的 PDF 上传至云端,充分保护用户隐私。其次,生成的 PDF 经过移动优化,页面布局自适应手机屏幕,便于在手机或平板上阅读。再者,作为开源工具,它免费且无广告,依赖的 Playwright 是微软官方维护的成熟项目,稳定性有保障。此外,脚本具备完善的异常处理机制,设置 30 秒页面加载超时,避免因网络问题导致程序卡死。

潜在缺点与局限性同样需要关注。该技能需要预先安装 uv 包管理器和 Playwright 浏览器(Chromium),首次配置较为繁琐,且 Chromium 二进制文件体积较大,会占用可观的磁盘空间。功能方面,它仅支持单个 URL 转换,缺乏批量处理能力;页面渲染等待时间固定为 3 秒,对于重度依赖 JavaScript 的动态网页可能抓取不完整。此外,它无法处理需要登录认证的私密页面,也不支持自定义 PDF 样式或页眉页脚设置。

适合的目标群体主要包括:经常需要保存技术博客、新闻文章或文档资料供离线阅读的互联网用户;需要在移动设备上阅读长篇网页内容的通勤族;以及需要归档网页证据或资料的研究人员、学生群体。对于需要将网页内容纳入个人知识管理系统的用户,这也是一款实用的辅助工具。

使用风险方面,虽然代码本身安全规范,但访问用户提供的 URL 时会向目标服务器暴露用户的真实 IP 地址,在访问敏感网站时需注意隐私保护。生成的 PDF 文件会直接占用本地存储空间,大量转换可能导致磁盘容量紧张。另外,由于依赖 Playwright 和 Chromium,如果上游依赖出现安全漏洞,可能会影响本工具的安全性,建议保持依赖更新。

安全解读

核心用法

url2pdf 是一款轻量级工具类 Skill,核心功能是将任意网页 URL 转换为针对移动设备优化的 PDF 文件。用户通过 /url2pdf <url> 指令或自然语言触发,Skill 自动调用 Playwright 驱动 Chromium 浏览器访问目标页面,渲染完整页面后生成 PDF。输出路径通过 PDF_OUT_DIR 环境变量可配置,默认为当前目录。

使用方法极为简单:安装 uv 后执行 uvx playwright install chromium 安装浏览器依赖,随后直接运行脚本即可。Agent 会将生成的 PDF 作为文档消息发送给用户,实现「保存网页、离线阅读」的无缝体验。

显著优点

  • 移动优先:生成的 PDF 针对手机屏幕排版优化,阅读体验优于直接打印网页
  • 技术栈现代:采用 Playwright 而非传统 wkhtmltopdf,能正确渲染现代 JavaScript 动态页面
  • 依赖纯净:仅依赖 playwright 和 python-slugify 两个知名开源库,无隐藏第三方 API 调用
  • 隐私友好:除访问用户指定的 URL 外,无外部数据传输,不收集敏感信息
  • 代码透明:175 行代码结构清晰,无混淆,易于审计和二次开发

潜在缺点与局限性

  • 个人维护风险:作者为独立开发者(T3 来源),长期维护承诺和更新频率存疑
  • 无输入校验:当前版本未对输入 URL 进行格式验证或域名白名单限制,可能意外访问内网地址
  • 路径安全风险:输出目录依赖环境变量,缺少路径遍历防护
  • 异常处理简略:浏览器启动失败、PDF 生成超时等场景缺乏详细错误提示
  • 系统依赖重:需预装 Chromium 浏览器,首次配置约需数百 MB 下载

适合人群

  • 需要批量保存网页资料、构建个人知识库的 researchers 和 writers
  • 通勤场景需离线阅读长文的移动端用户
  • 希望将在线文档转为 PDF 存档的办公人士
  • 对浏览器自动化有基础了解、能自行排查配置问题的技术用户

常规风险

1. 供应链风险:Playwright 和 Chromium 若存在未修复的 CVE,可能影响本 Skill(需持续关注依赖更新)
2. 恶意 URL 风险:用户若误输入钓鱼站点或恶意脚本页面,浏览器渲染过程存在潜在威胁

3. 资源消耗:Chromium 内存占用较高,低配置设备或批量转换时可能引发性能问题

4. 内容版权:自动下载网页内容需遵守目标网站的 robots.txt 和使用条款,商用需谨慎

url2pdf 内容

手动下载zip · 2.5 kB
SKILL.mdtext/markdown
请选择文件