luokai0 CN Web Screenshot - 网页截图工具
基于 Playwright 的网页截图工具，支持全页截图、视口截图、移动端/平板视图、自定义尺寸和延迟等待。
功能
- 全页截图：捕获整个网页（超出视口的滚动区域也包含）
- 视口截图：仅截取当前视口可见区域
- 移动端视图：模拟 iPhone 6/7/8 尺寸 (375×667)
- 平板视图：模拟 iPad 尺寸 (768×1024)
- 自定义等待：页面加载后等待指定毫秒再截图（适合 JS 渲染的页面）
- 自动协议：URL 缺少协议时自动补全
https://
依赖安装
pip install playwright
playwright install chromium
使用方法
# 基本截图（全页，移动端视图）
python3 scripts/web_screenshot.py "https://example.com" --viewport mobile
# 视口截图
python3 scripts/web_screenshot.py "https://news.ycombinator.com" -p
# 平板视图截图
python3 scripts/web_screenshot.py "https://example.com" --viewport tablet
# 指定输出路径
python3 scripts/web_screenshot.py "https://example.com" -o /tmp/page.png
# 等待3秒后截图（适合 SPA/React/Vue 页面）
python3 scripts/web_screenshot.py "https://example.com" --wait 3000
# 完整示例
python3 scripts/web_screenshot.py "https://example.com" --viewport mobile --wait 2000 -o /tmp/mobile.png
参数说明
| 参数 | 说明 | 可选值 |
|---|---|---|
<url> |
目标网页 URL（必填） | 任意 http/https URL |
--viewport, -v |
视口类型 | mobile / tablet（默认桌面1280×720） |
--partial, -p |
仅截取视口可见区域，不全页滚动 | flag |
--output, -o |
输出文件路径 | 任意 .png 路径（默认 /tmp/screenshot_时间戳.png） |
--wait, -w |
截图前等待毫秒数 | 数字，默认 2000ms |
应用场景
- 存档网页快照（新闻、公告、证据留存）
- 监测网站 UI 变化（视觉回归测试）
- 社交媒体内容预览图
- SEO 诊断（查看页面渲染后内容）
- 移动端兼容性检查
注意事项
- Chromium 仅支持，依赖系统已安装 Chromium
- 登录态页面（如需要 Cookie/Token）无法直接截图（可结合 browser skill）
- 超长页面（>10000px）全页截图可能较慢
- 等待时间建议 1000-3000ms（太快 JS 未渲染，太慢浪费时间）