用途:指导 AI 智能体生成可运行的站点专用网页抓取项目,采用 PageObject 模式,基于 Playwright 与 TypeScript,并支持 Docker 部署。适用于构建站点专用抓取器、生成 PageObject 类、搭建含 Docker 的完整项目、用 agent-browser 分析站点并自动生成选择器,以及创建分页、数据表格等可复用抓取组件。不适用于构建 API 客户端、编写 QA/E2E 测试、整域大规模爬取,或需要绕过认证与验证码的站点。
主要能力:每个页面映射为一个 PageObject 类,定位器在构造函数中定义,抓取逻辑放在方法中;选择器优先级为 data-testid > id > 语义 HTML > 结构化 CSS 类 > 文本内容;可复用 UI 模式以组件类组合;抓取数据经 Zod schema 校验;生成项目包含基于官方 Playwright 镜像的 Dockerfile 与 docker-compose.yml。
使用方式:提供三种生成模式。模式一用 agent-browser 分析站点,若未安装可执行 npx skills add vercel-labs/agent-browser,随后用 agent-browser open、snapshot -i --json、click、wait --load networkidle、close 等命令采集快照并生成选择器。模式二由用户描述页面结构,智能体提问后映射为页面对象。模式三用脚手架脚本一次性生成完整项目:deno run --allow-read --allow-write scripts/scaffold-scraper-project.ts --name "my-scraper" --url "https://example.com" --pages "ProductListing,ProductDetail" --fields "title,price,image_url,description"。另有 generate-page-object.ts 生成单个 PageObject 类。
限制:不绕过认证或登录墙,不解决验证码或机器人检测,仅生成 TypeScript,不生成整域爬虫,不创建违反 robots.txt 的抓取器,不处理限流 API,也不生成测试套件。具体收费、价格与平台支持情况暂未提供。