cn-web-screenshot

slug	cn-web-screenshot
name	cn-web-screenshot
version	1.0.0
description	网页截图工具。输入URL自动捕获网页截图，支持全页截图、视口截图、移动端视图、延迟加载等待。保存为PNG格式。
scope	web screenshot, page capture, visual testing
install	pip install playwright playwright install chromium
env
entry	{"type":"prompt","prompt":"当用户需要截取网页、保存网页截图、捕获页面时，使用此skill。\n识别意图：\n- \"截取这个网页\"\n- \"网页截图\"\n- \"保存页面截图\"\n- \"捕获网站画面\"\n- \"帮我截图\"\n执行流程：\n1. 获取URL\n2. 调用 scripts/web_screenshot.py 截图\n3. 返回截图路径\n"}
handler	调用 scripts/web_screenshot.py 截取网页

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 变化（视觉回归测试）
• 社交媒体内容预览图