用途:该技能面向脚本化网页自动化,适合数据管道、表单机器人等场景,与侧重 QA 断言的 webapp-testing、交互式 MCP DevTools 控制的 chrome-browser 区分使用。
主要能力:导航与数据提取、表单填写、截图与 PDF 捕获、认证会话保存与复用、反检测配置。
安装:pip install playwright && playwright install chromium;可选 pip install playwright-stealth 用于反检测。
核心用法:使用 sync_playwright 启动 chromium,创建带 user_agent 与 viewport 的 context,page.goto 后调用 page.wait_for_load_state("networkidle"),再用 get_by_role 等定位元素提取文本。表单填写使用 page.get_by_label("Email").fill(...),提交时用 with page.expect_navigation(): 包裹点击。截图 page.screenshot(path="full.png", full_page=True),PDF 用 page.pdf(path="page.pdf", format="A4", print_background=True)。会话通过 context.storage_state(path="auth-state.json") 保存,复用则 new_context(storage_state="auth-state.json")。反检测可加启动参数 --disable-blink-features=AutomationControlled,设置 locale、timezone_id,并用 add_init_script 覆盖 navigator.webdriver。
约定与限制:禁止使用 time.sleep(),应改用 page.wait_for_selector() 或 wait_for_load_state();表单避免 CSS 选择器,优先 get_by_label()、get_by_role();不要每次重新登录,应持久化会话;auth-state.json 不得提交,需加入 .gitignore。提取数据保存到 .claude/context/tmp/ 的 JSON,截图与 PDF 保存到 .claude/context/artifacts/。开始前读取 .claude/context/memory/learnings.md,完成后将新提取模式写入 learnings.md、将遇到的机器人检测写入 issues.md。其他细节暂未提供。