# Page Agent Claw Controller

> 通过本地 page-agent 服务（运行在 http://localhost:4222）执行浏览器自动化任务。当用户指令中包含 "page-agent" 或需要调用本地浏览器时使用,该服务可以打开网页、执行页面操作、提取信息等。

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

---


## When to Apply

用户需要控制浏览器打开页面、执行浏览操作时使用此skill。

## Prerequisites

确保page-agent-claw已安装并运行在端口4222。

## Workflow

### 1. 检查服务状态

```bash
curl http://localhost:4222/api/status
```

**响应示例**:
```json
{"code":100,"message":"请打开 localhost:4222 页面","connectedNumber":0}
{"code":105,"message":"page-agent 未连接","connectedNumber":1}
{"code":200,"message":"正常","connectedNumber":1,"pageAgentCount":1}
```

| 状态码 | 说明 |
|--------|------|
| 100 | 无WebSocket连接，需打开 http://localhost:4222 |
| 105 | 有连接但page-agent未连接 |
| 200 | 正常，可以执行任务 |

### 2. 启动服务（如未运行）

```bash
# 检查服务是否运行
curl http://localhost:4222/health

# 如未运行，启动服务
page-agent-claw
```

### 3. 提交浏览任务

```bash
curl -X POST http://localhost:4222/api/task \
  -H "Content-Type: application/json" \
  -d '{"task": "打开 https://www.example.com"}'
```

**任务示例**:
- `"打开 https://www.example.com"`
- `"在当前页面搜索 Claude"`
- `"访问 Google，搜索 page-agent，然后点击第一个结果"`

## API Reference

| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/status` | GET | 获取服务状态 |
| `/api/task` | POST | 提交浏览任务 |
| `/health` | GET | 健康检查 |

## Requirements

- Node.js + npm
- page-agent-claw: `npm install -g page-agent-claw`
- page-agent Chrome扩展（用于控制浏览器）