url2png

📸 一键生成移动端网页截图

基于 shot-scraper 和 Playwright 的网页截图工具,可将任意 URL 转换为适合移动端阅读的 PNG 长图,本地处理无隐私泄露风险。

收藏
20.2k
安装
4.3k
版本
v0.0.2
CLS 安全性认证2026-04-30
点击查看完整报告 >

使用说明

url2png 是一款轻量级的网页截图工具,专注于将任意网页 URL 转换为适合移动端阅读的 PNG 长图。用户通过简单的命令行操作 /url2png <url> 即可快速生成截图,默认保存至 ~/Pictures 目录,也支持通过第二个参数自定义输出路径。该工具基于知名的开源截图工具 shot-scraper 构建,底层使用 Playwright 和 Chromium 浏览器引擎,能够完整渲染网页并生成长截图。

该技能的显著优势在于其简洁的工作流程和可靠的底层技术栈。shot-scraper 由知名开发者 Simon Willison 维护,在开源社区享有良好声誉;配合 Astral 公司开发的 uv 包管理器,确保了依赖安装的安全性和便捷性。所有数据处理均在本地完成,截图不会上传至任何远程服务器,有效保护用户隐私。生成的 PNG 文件针对移动端进行了优化,适合保存文章、文档类网页内容供离线阅读。

然而,作为 T3 级别的个人开源项目,url2png 在工程化方面存在一定局限性。首先,URL 输入参数缺乏格式验证和安全性检查,恶意构造的 URL 可能带来潜在风险;其次,依赖管理不够严格,通过 uvx 动态安装 shot-scraper 时未锁定具体版本,可能导致环境不一致;此外,脚本缺乏完善的错误处理机制,当 shot-scraper 执行失败或目录权限不足时,用户可能无法获得明确的错误提示。

该工具适合需要频繁保存网页内容的用户群体,包括研究者、内容创作者、产品经理以及希望离线阅读网页文章的普通用户。对于需要将网页存档为图像格式或制作移动端展示材料的场景尤为适用。

使用过程中需注意以下风险:由于需要访问外部 URL 并执行 Chromium 浏览器,该工具会消耗一定的网络资源和系统内存;首次安装时需要下载 Chromium 浏览器,对磁盘空间和网络稳定性有要求;输入 URL 时需谨慎,避免截图包含恶意内容的网页;建议通过文件形式(而非图片形式)发送生成的 PNG,以避免通讯软件对图片的压缩处理。

安全解读

核心用法

url2png 是一款将任意网页 URL 转换为 PNG 长截图的实用工具,专为移动阅读场景优化。用户通过简单的命令行指令 /url2png <url> 即可触发,支持自定义输出路径,默认保存至 ~/Pictures 目录。

工具底层依赖 shot-scraper(基于 Playwright/Chromium)实现网页渲染与截图,通过 uv 包管理器进行工具链安装。执行流程为:Agent 调用 url2png.sh 脚本 → 生成 PNG 文件 → 以文档/压缩包形式发送给用户(避免 Telegram 等平台的图片压缩)。

显著优点

  • 零配置开箱即用:通过 install.sh 自动完成 shot-scraper 和 Chromium 浏览器模块的安装
  • 移动端适配:输出 PNG 针对移动设备阅读优化,长网页自动处理
  • 跨平台支持:兼容 macOS (darwin) 和 Linux 系统
  • 透明可信:源码托管于 GitHub,纯 Markdown 文档类型,无可执行代码注入风险
  • 隐私友好:本地渲染网页,无第三方数据上传

潜在缺点与局限性

  • 依赖外部工具链:需预装 uv 包管理器,首次安装需下载 Chromium 浏览器(约 100MB+)
  • 无 URL 验证说明:文档未明确输入参数的格式校验逻辑,异常 URL 可能报错
  • 无开源许可证:当前未声明 license,存在潜在使用条款不确定性
  • 浏览器更新维护:Chromium 需手动定期更新以修复安全漏洞
  • 平台限制:暂不支持 Windows 系统

适合人群

  • 需要将在线文章、文档保存为离线 PNG 的读者
  • 内容创作者生成网页截图分享图
  • 开发者快速截取网页视觉回归测试图
  • CLI 重度用户寻求自动化网页截图方案

常规风险

  • 网络依赖:首次安装需从外部下载浏览器组件
  • 渲染一致性:不同 Chromium 版本可能导致截图差异
  • 长页面内存占用:极端长网页可能触发内存问题
  • 无沙箱隔离:shot-scraper 以本地权限运行,需信任来源网页

url2png 内容

手动下载zip · 1.7 kB
install.shtext/x-shellscript
请选择文件