SkillHub

page-agent-claw

v0.1.1

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

Sourced from ClawHub, Authored by ucasYToo

Installation

Please help me install the skill `page-agent-claw` from SkillHub official store. npx skills add ucasYToo/page-agent-claw

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扩展（用于控制浏览器）