# Cn Web Screenshot

> 网页截图工具。输入URL自动捕获网页截图，支持全页截图、视口截图、移动端视图、延迟加载等待。保存为PNG格式。

- Skill: `luokai0/cn-web-screenshot` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add luokai0/cn-web-screenshot`
- Raw SKILL.md: https://api.skillmd.com/api/skills/luokai0/cn-web-screenshot/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: luokai0 (https://skillmd.com/u/luokai0)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/luokai0/cn-web-screenshot

---


# CN Web Screenshot - 网页截图工具

基于 Playwright 的网页截图工具，支持全页截图、视口截图、移动端/平板视图、自定义尺寸和延迟等待。

## 功能

- **全页截图**：捕获整个网页（超出视口的滚动区域也包含）
- **视口截图**：仅截取当前视口可见区域
- **移动端视图**：模拟 iPhone 6/7/8 尺寸 (375×667)
- **平板视图**：模拟 iPad 尺寸 (768×1024)
- **自定义等待**：页面加载后等待指定毫秒再截图（适合 JS 渲染的页面）
- **自动协议**：URL 缺少协议时自动补全 `https://`

## 依赖安装

```bash
pip install playwright
playwright install chromium
```

## 使用方法

```bash
# 基本截图（全页，移动端视图）
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 未渲染，太慢浪费时间）