---
name: chrome-automation-38809b66150e
description: Linux服务器Chrome浏览器自动化方案。支持2K高清截图、表单填写、自动登录、绕过反爬虫检测。适用于B站、YouTube等网站自动化操作。
metadata:
  openclaw:
    requires:
      bins: ["google-chrome", "python3"]
    install:
      - id: google-chrome
        kind: shell
        command: |
          # 下载并安装Google Chrome
          wget -q https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb -O /tmp/chrome.deb
          sudo apt update && sudo apt install -y /tmp/chrome.deb xvfb
        label: Install Google Chrome
      - id: playwright-env
        kind: shell
        command: |
          # 创建Python虚拟环境并安装Playwright
          sudo apt install -y python3.11-venv
          python3 -m venv ~/.playwright-env
          source ~/.playwright-env/bin/activate
          pip install playwright
          playwright install chromium
        label: Setup Playwright Environment
---

# Chrome 浏览器自动化

服务器环境下的Chrome浏览器自动化方案，支持2K高清截图和复杂交互操作。

## 🚀 快速开始

### 方案1：Chrome 无头模式（简单截图）

```bash
# 2K高清截图（推荐默认）
google-chrome --headless=new --no-sandbox --disable-gpu \
  --window-size=1920,1080 --force-device-scale-factor=2 \
  --screenshot=/home/Kano/.openclaw/workspace/screenshot.png \
  https://www.bilibili.com
```

**参数说明：**
| 参数 | 作用 |
|------|------|
| `--headless=new` | 新版无头模式 |
| `--window-size=1920,1080` | 窗口分辨率 |
| `--force-device-scale-factor=2` | 2倍缩放（2K清晰度）|
| `--no-sandbox` | 跳过沙箱（服务器必需）|
| `--disable-gpu` | 禁用GPU（服务器必需）|

---

### 方案2：Playwright + Stealth（高级自动化）

**适用于：** 填表、登录、发帖、绕过反爬虫检测

```bash
# Stealth模式截图
python3 ~/.openclaw/workspace/skills/chrome-automation/scripts/playwright_stealth.py <URL>

# 指定输出路径
python3 ~/.openclaw/workspace/skills/chrome-automation/scripts/playwright_stealth.py <URL> -o <输出路径>
```

**Python调用：**
```python
import sys
sys.path.insert(0, '/home/Kano/.playwright-env/lib/python3.11/site-packages')
sys.path.insert(0, '/home/Kano/.openclaw/workspace/skills/chrome-automation/scripts')

from playwright_stealth import screenshot_with_stealth, auto_fill_form

# 截图（自动绕过反爬虫）
screenshot_with_stealth('https://bilibili.com')

# 自动填表登录
auto_fill_form('https://login.example.com', {
    '#username': '用户名',
    '#password': '密码'
}, submit_selector='button[type=submit]')
```

---

## 📊 方案对比

| 特性 | Chrome无头 | Playwright |
|------|-----------|------------|
| **启动速度** | ⚡ 最快 | 🚀 快 |
| **截图质量** | ✅ 2K高清 | ✅ 2K高清 |
| **绕过反爬虫** | ⚠️ 容易被检测 | ✅ Stealth模式 |
| **填表/登录** | ❌ 不支持 | ✅ 完美支持 |
| **资源占用** | 低 | 中 |
| **推荐场景** | 简单截图 | 复杂自动化 |

---

## 🔧 常用命令

```bash
# ========== 基础截图 ==========
# 默认分辨率
google-chrome --headless=new --no-sandbox --disable-gpu \
  --screenshot=output.png https://example.com

# 2K高清（推荐）
google-chrome --headless=new --no-sandbox --disable-gpu \
  --window-size=1920,1080 --force-device-scale-factor=2 \
  --screenshot=output.png https://example.com

# 全页面截图
google-chrome --headless=new --no-sandbox --disable-gpu \
  --window-size=1920,1080 --hide-scrollbars \
  --screenshot=output.png https://example.com

# ========== Playwright ==========
# Stealth截图
python3 ~/.openclaw/workspace/skills/chrome-automation/scripts/playwright_stealth.py <URL>

# 自定义输出
python3 ~/.openclaw/workspace/skills/chrome-automation/scripts/playwright_stealth.py <URL> -o <路径>
```

---

## 🛠️ 环境信息

| 组件 | 版本/路径 |
|------|----------|
| Google Chrome | `/usr/bin/google-chrome` (v145+) |
| Playwright | `~/.playwright-env/` (v1.58.0) |
| Python虚拟环境 | `~/.playwright-env/` |
| Stealth脚本 | `scripts/playwright_stealth.py` |

---

## ⚠️ 注意事项

1. **每次运行都是新会话**，不会保留登录状态
2. **截图默认保存到** `/home/Kano/.openclaw/workspace/`
3. **B站等网站可能触发验证码**，需要人工处理或使用已登录的Cookie

---

## 🔗 相关文件

- Stealth脚本：`scripts/playwright_stealth.py`
- 测试脚本：`scripts/test_playwright.py`


---
Source attribution: modbender
Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/chrome-automation/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Dave AI.

## Upstream license notice

MIT License

Copyright (c) 2025 skill-library-mcp contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Dave AI resource metadata

Creator / publisher: modbender
Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/chrome-automation/SKILL.md
Attribution basis: Source repository record

Fields of work: Development & Engineering
Roles: Backend Developer, Data Engineer, DevOps / SRE
Specialties: Backend, Testing
Tools: Google Chrome, Python3, Playwright
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 38138d34651ff7c0e4d2a4bc5997473213d81fa5a7d10ae462128708f97c24d4