网页自动化助手（Powered by Playwright）

基于 GitHub 热门开源项目 Microsoft Playwright（95K+ Star，Apache-2.0 许可）封装的付费网页自动化服务。后端使用无头浏览器执行页面操作，支持截图、正文提取与数据抓取。

计费说明

按调用量计费：0.50 元 / 次
每次调用默认最多访问 5 个页面；单个任务超时上限 120 秒
每个订单号（out_trade_no）只履约一次，重复请求返回缓存结果

输入与输出

| 项目 | 说明 | |---|---| | 输入 | 目标 URL + 任务类型（screenshot / extract_text / extract_data / fill_form）+ 可选参数（选择器、等待条件） | | 输出 | 截图直链、正文 Markdown、表格/JSON 数据、页面标题与元信息 | | 限制 | 仅支持公开可访问页面；不做登录态/验证码破解；遵守目标站点 robots 与条款 |

服务地址

Base URL：https://hzwdzz.cn/skillpay

下文接口均写路径（如 /skill/web-automator/invoke），完整地址 = Base URL + 路径。

付费前置检查

调用本 Skill 前，检查当前 Agent 是否已安装 weixinpay 插件：

已安装：可继续提供付费服务
未安装：提示「当前 Agent 暂不支持微信支付付费能力」，终止流程

工作流程

第一步：请求资源

POST /skill/web-automator/invoke
Content-Type: application/json

{
  "query": "https://example.com/products",
  "task": "extract_data",
  "fields": ["title", "price", "stock"]
}

第二步：处理 402 响应

首次调用会返回 HTTP 402，必须提取并保存两个 Header 的值：

WeixinPay-Required（支付码 payment_code）
X-Out-Trade-No（订单号）

响应体中的 WeixinPay 提示块需原样保留给用户查看。

第三步：发起支付

将 WeixinPay-Required 的值作为 paymentCode，调用 weixinpay_pay，引导用户完成微信支付授权。

第四步：支付成功后获取资源（⚠️ 必须执行）

POST /skill/web-automator/invoke
Headers:
  WeixinPay-Required: <第二步保存的支付码>
  X-Out-Trade-No: <第二步保存的订单号>
Content-Type: application/json

{
  "query": "https://example.com/products",
  "task": "extract_data",
  "fields": ["title", "price", "stock"]
}

⚠️ body 必须与第一次请求完全一致，仅通过 Header 传递订单号与支付凭证。 若缺少 X-Out-Trade-No，服务端无法验证支付，将再次返回 402。

第五步：交付结果

支付核验通过后返回 HTTP 200，交付截图链接、正文或结构化数据。

成功响应示例

{
  "code": "SUCCESS",
  "message": "抓取完成",
  "out_trade_no": "WX402_20260908120000abcdef123456",
  "transaction_id": "4200001234202306300000000001",
  "content": {
    "title": "产品列表",
    "pages_visited": 1,
    "data": [
      { "title": "无线耳机", "price": "¥299", "stock": "128" }
    ],
    "screenshot": "<文件下载直链>"
  }
}

错误处理

| 状态 | 含义 | 处理 | |---|---|---| | 402 + WeixinPay-Required | 需要支付 | 按工作流程发起支付 | | 403 | 目标站拒绝访问/反爬 | 提示更换来源或稍后重试 | | 404 | URL 不存在 | 提示检查链接 | | 408 | 页面加载超时 | 提示简化任务或更换页面 | | 500 | 后端处理失败 | 提示稍后重试 |