cloudflare-browser — скилл для Claude Code
Скилл для Claude Code управляет headless Chrome через Cloudflare Browser Rendering с помощью Chrome DevTools Protocol по WebSocket. Запускает скриншоты, навигацию, скрейпинг и видеозапись из агента в окружении Cloudflare Workers.
Apache-2.0 25 установок ★ 9 948 обновлён 2026-05-09
npx skills add cloudflare/moltworker --skill cloudflare-browser -a claude-codeЧто делает cloudflare-browser
Работает во всех перечисленных платформах — Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Подключается к CDP-эндпоинту воркера через WebSocket, используя переменную окружения CDP_SECRET. После подключения воркер создаёт target страницы и отправляет событие Target.targetCreated с targetId, который затем используется для отправки команд: навигация через Page.navigate, снимки экрана через Page.captureScreenshot, выполнение JavaScript через Runtime.evaluate.
Для скриншотов достаточно одной команды — скилл ждёт рендеринга и сохраняет PNG или JPEG. Для видео собирает кадры во время навигации по нескольким URL и stitches их через ffmpeg в MP4. Требует, чтобы в openclaw.json была секция browser.profiles с cdpUrl, указывающим на рабочий эндпоинт воркера с secret.
Холодный старт воркера может задержать ответ на 30–60 секунд; обычные таймауты команд нужно увеличивать. Если команды зависают, проверьте, что CDP_SECRET совпадает с конфигурацией воркера и что целевой страницы уже создана.
Какие задачи решает
- снять скриншот веб-страницы из агента
- собрать видео из серии URL-адресов
- выполнить скрейпинг или парсинг с JavaScript в браузере
- автоматизировать навигацию и клики в headless Chrome
- изменить viewport и эмулировать мобильное устройство
Примеры запросов агенту
- Снимите скриншот https://example.com и сохраните как output.png
- Запишите видео с кадрами с https://site1.com и https://site2.com в output.mp4
- Откройте страницу, прокрутите её на 300 пикселей и выполните JavaScript
Как установить cloudflare-browser
1Через Skills CLI (Vercel)
npx skills add cloudflare/moltworker --skill cloudflare-browser -a claude-code2Вручную: положить файлы
~/.claude/skills/cloudflare-browser/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cloudflare-browser/
1Через Skills CLI (Vercel)
npx skills add cloudflare/moltworker --skill cloudflare-browser -a codex2Вручную: положить файлы
.agents/skills/cloudflare-browser/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cloudflare/moltworker --skill cloudflare-browser -a cursor2Вручную: положить файлы
.cursor/skills/cloudflare-browser/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cloudflare/moltworker skills/cloudflare-browser2Вручную: положить файлы
.github/skills/cloudflare-browser/SKILL.md1Через Skills CLI (Vercel)
npx skills add cloudflare/moltworker --skill cloudflare-browser -a gemini-cli2Командой платформы
gemini skills install https://github.com/cloudflare/moltworker --path skills/cloudflare-browserВручную: положить файлы
.devin/skills/cloudflare-browser/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add cloudflare/moltworker --skill cloudflare-browser -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о cloudflare-browser
Как установить cloudflare-browser в Claude Code?
Выполните npx skills add cloudflare/moltworker --skill cloudflare-browser -a claude-code, а затем откройте файл конфигурации скилла по пути ~/.claude/skills/cloudflare-browser/SKILL.md.
Что делает cloudflare-browser?
Управляет headless Chrome через CDP-протокол Cloudflare Browser Rendering. Позволяет агенту снимать скриншоты страниц, записывать видео, выполнять JavaScript и автоматизировать навигацию в браузере.
Что нужно для работы cloudflare-browser?
Переменная окружения CDP_SECRET, сконфигурированный в openclaw.json браузер-профиль с cdpUrl, указывающий на Cloudflare Workers эндпоинт, и Node.js для запуска скриптов.
Исходный текст
SKILL.md · Apache-2.0
---
name: cloudflare-browser
description: Control headless Chrome via Cloudflare Browser Rendering CDP WebSocket. Use for screenshots, page navigation, scraping, and video capture when browser automation is needed in a Cloudflare Workers environment. Requires CDP_SECRET env var and cdpUrl configured in browser.profiles.
---
# Cloudflare Browser Rendering
Control headless browsers via Cloudflare's Browser Rendering service using CDP (Chrome DevTools Protocol) over WebSocket.
## Prerequisites
- `CDP_SECRET` environment variable set
- Browser profile configured in openclaw.json with `cdpUrl` pointing to the worker endpoint:
```json
"browser": {
"profiles": {
"cloudflare": {
"cdpUrl": "https://your-worker.workers.dev/cdp?secret=..."
}
}
}
```
## Quick Start
### Screenshot
```bash
node /path/to/skills/cloudflare-browser/scripts/screenshot.js https://example.com output.png
```
### Multi-page Video
```bash
node /path/to/skills/cloudflare-browser/scripts/video.js "https://site1.com,https://site2.com" output.mp4
```
## CDP Connection Pattern
The worker creates a page target automatically on WebSocket connect. Listen for Target.targetCreated event to get the targetId:
```javascript
const WebSocket = require('ws');
const CDP_SECRET = process.env.CDP_SECRET;
const WS_URL = `wss://your-worker.workers.dev/cdp?secret=${encodeURIComponent(CDP_SECRET)}`;
const ws = new WebSocket(WS_URL);
let targetId = null;
ws.on('message', (data) => {
const msg = JSON.parse(data.toString());
if (msg.method === 'Target.targetCreated' && msg.params?.targetInfo?.type === 'page') {
targetId = msg.params.targetInfo.targetId;
}
});
```
## Key CDP Commands
| Command | Purpose |
|---------|---------|
| Page.navigate | Navigate to URL |
| Page.captureScreenshot | Capture PNG/JPEG |
| Runtime.evaluate | Execute JavaScript |
| Emulation.setDeviceMetricsOverride | Set viewport size |
## Common Patterns
### Navigate and Screenshot
```javascript
await send('Page.navigate', { url: 'https://example.com' });
await new Promise(r => setTimeout(r, 3000)); // Wait for render
const { data } = await send('Page.captureScreenshot', { format: 'png' });
fs.writeFileSync('out.png', Buffer.from(data, 'base64'));
```
### Scroll Page
```javascript
await send('Runtime.evaluate', { expression: 'window.scrollBy(0, 300)' });
```
### Set Viewport
```javascript
await send('Emulation.setDeviceMetricsOverride', {
width: 1280,
height: 720,
deviceScaleFactor: 1,
mobile: false
});
```
## Creating Videos
1. Capture frames as PNGs during navigation
2. Use ffmpeg to stitch: `ffmpeg -framerate 10 -i frame_%04d.png -c:v libx264 -pix_fmt yuv420p output.mp4`
## Troubleshooting
- **No target created**: Race condition - wait for Target.targetCreated event with timeout
- **Commands timeout**: Worker may have cold start delay; increase timeout to 30-60s
- **WebSocket hangs**: Verify CDP_SECRET matches worker configuration
© cloudflare · Apache-2.0 · cloudflare/moltworker