When to Apply
用户需要控制浏览器打开页面、执行浏览操作时使用此skill。
Prerequisites
确保page-agent-claw npm包已安装，并运行在端口4222。
Workflow
1. 检查服务状态
curl http://localhost:4222/api/status
响应示例:
{"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. 启动服务（如未运行）
# 检查服务是否运行
curl http://localhost:4222/health
# 如未运行，启动服务
page-agent-claw
3. 提交浏览任务
curl -X POST http://localhost:4222/api/task \
-H "Content-Type: application/json" \
-d '{"task": "打开 https://www.example.com"}'
⚠️ 超时设置提示
复杂任务（如多步骤操作、大量数据提取）可能需要较长时间，建议设置 curl 超时参数：
# 设置最大执行时间为 120 秒
curl -X POST http://localhost:4222/api/task \
-H "Content-Type: application/json" \
--max-time 180 \
-d '{"task": "复杂的浏览任务"}'
| 参数 | 说明 |
|---|---|
--max-time <seconds> | 设置整个操作的最大允许时间 |
--connect-timeout <seconds> | 仅设置连接超时时间 |
任务示例:
"打开 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扩展（用于控制浏览器）