browser-automation

浏览器自动化技能

Playwright CSS 选择器参考

基本选择器

选择器	描述	示例
#id	按 ID 选择	#checkout-btn
.class	按类选择	.add-to-cart
tag	按元素选择	button、input
[attr=val]	按属性选择	[data-testid="submit"]
tag.class	组合选择	button.primary

表单选择器

选择器	用途
input[type="email"]	电子邮件字段
input[type="password"]	密码字段
input[type="search"]	搜索框
input[name="q"]	Google/搜索查询
textarea	多行文本区域
select[name="country"]	下拉菜单
input[type="checkbox"]	复选框
input[type="radio"]	单选按钮
button[type="submit"]	提交按钮

导航选择器

选择器	用途
a[href*="cart"]	购物车链接
a[href*="checkout"]	结账链接
a[href*="login"]	登录链接
nav a	导航菜单链接
.breadcrumb a	面包屑导航链接
[role="navigation"] a	ARIA 导航链接

电商选择器

选择器	用途
.product-price, [data-price]	商品价格
.add-to-cart, #add-to-cart	加入购物车按钮
.cart-total, .order-total	购物车总额
.quantity, input[name="quantity"]	数量选择器
.checkout-btn, #checkout	结账按钮

常见工作流

搜索并购买商品

1. browser_navigate → store homepage
2. browser_type → search box with product name
3. browser_click → search button or press Enter
4. browser_read_page → scan results
5. browser_click → desired product
6. browser_read_page → verify product details & price
7. browser_click → "Add to Cart"
8. browser_navigate → cart page
9. browser_read_page → verify cart contents & total
10. STOP → Report to user, wait for approval
11. browser_click → "Proceed to Checkout" (only after approval)

账户登录

1. browser_navigate → login page
2. browser_type → email/username field
3. browser_type → password field
4. browser_click → login/submit button
5. browser_read_page → verify successful login

提交表单

1. browser_navigate → form page
2. browser_read_page → understand form structure
3. browser_type → fill each field sequentially
4. browser_click → checkboxes/radio buttons as needed
5. browser_screenshot → visual verification before submit
6. browser_click → submit button
7. browser_read_page → verify confirmation

价格比较

1. For each store:
   a. browser_navigate → store URL
   b. browser_type → search query
   c. browser_read_page → extract prices
   d. memory_store → save price data
2. memory_recall → compare all prices
3. Report findings to user

错误恢复策略

错误	恢复方法
找不到元素	尝试其他选择器，使用可见文本，滚动页面
页面超时	重试导航，检查 URL
需要登录	告知用户并索取凭据
CAPTCHA	无法解决 — 告知用户
弹出窗口/模态框	先点击关闭/取消按钮
Cookie 同意提示	点击“接受”或关闭横幅
请求频率受限	等待 30s 后重试
页面错误	使用 browser_read_page 验证，然后返回上一页

安全检查清单

• 输入凭据前确认域名
• 切勿将密码存储在 memory_store 中
• 提交敏感数据前检查是否使用 HTTPS
• 向用户报告可疑的重定向
• 切勿自动批准金融交易
• 警惕网络钓鱼迹象（拼写错误的域名、不寻常的 URL）