Agent Skill
浏览器自动化助手
全面的浏览器自动化操作指南。覆盖网页自动化操作(点击/填写表单/截图)、多标签页管理、登录流程、文件上传下载、网页数据抓取等。适用于 OpenClaw/Playwright/Selenium 等自动化框架。
skillhub install @user_c562f70c/browser-auto
10 Stars·3.8万 综合热度·3,691 字文档·源站更新 2026-11-11
README 文档
3,691 字浏览器自动化助手
概述
全面的浏览器自动化操作指南。基于 SkillsMP 上 ⭐378K 的超热门浏览器自动化技能汉化增强,适配国内网页生态和常用自动化工具。
本技能在以下场景自动触发:
- 用户需要进行网页自动化操作
- 需要填写表单或模拟用户交互
- 需要多标签页管理
- 需要网页截图和信息采集
- 需要自动化登录流程
- 需要文件上传/下载自动化
使用说明
浏览器自动化的核心操作模式:
1. 导航与等待
// 导航到页面
await page.goto('https://example.com', { waitUntil: 'networkidle' });
// 等待元素出现
await page.waitForSelector('.content-loaded', { timeout: 10000 });
// 等待网络请求完成
await page.waitForResponse(response => response.url().includes('/api/data'));
// 自定义等待条件
await page.waitForFunction(() => document.querySelectorAll('.item').length > 10);
2. 元素交互
// 点击(优先使用语义化选择器)
await page.click('text=提交');
await page.click('[data-testid="submit-btn"]');
await page.click('button:has-text("确认订单")');
// 输入文本
await page.fill('#username', 'test_user');
await page.type('#search', '关键词', { delay: 50 }); // 模拟真人输入
// 选择选项
await page.selectOption('#city', '北京');
// 悬停
await page.hover('.dropdown-trigger');
// 拖拽
await page.dragAndDrop('#source', '#target');
3. 多标签管理
// 打开新标签
const newPage = await context.newPage();
await newPage.goto('https://example.com/2');
// 切换标签
await page.bringToFront();
// 获取所有标签
const pages = context.pages();
// 关闭标签
await page.close();
// 等待新标签打开
const [newPage] = await Promise.all([
context.waitForEvent('page'),
page.click('a[target="_blank"]'),
]);
4. 数据采集
// 提取单个元素
const title = await page.textContent('h1');
// 提取多个元素
const items = await page.$$eval('.product-item', elements =>
elements.map(el => ({
name: el.querySelector('.name')?.textContent?.trim(),
price: el.querySelector('.price')?.textContent?.trim(),
link: el.querySelector('a')?.href,
}))
);
// 提取表格数据
const tableData = await page.$$eval('table tr', rows =>
rows.map(row =>
Array.from(row.querySelectorAll('td, th')).map(cell => cell.textContent?.trim())
)
);
// 获取页面全部文本
const text = await page.evaluate(() => document.body.innerText);
// 截图
await page.screenshot({ path: 'screenshot.png', fullPage: true });
5. 登录与认证
// Cookie 管理
const cookies = await page.cookies();
await page.setCookie(...cookies);
// 本地存储
await page.evaluate(() => {
localStorage.setItem('token', 'xxx');
});
// 表单登录
await page.fill('#username', 'user');
await page.fill('#password', 'pass');
await page.click('button[type="submit"]');
await page.waitForNavigation();
6. 文件操作
// 文件上传
const fileInput = await page.$('input[type="file"]');
await fileInput.setInputFiles('/path/to/file.pdf');
// 文件下载
const [download] = await Promise.all([
page.waitForEvent('download'),
page.click('a#download-btn'),
]);
await download.saveAs('/path/to/save/file.pdf');
7. 错误处理
// 超时处理
try {
await page.waitForSelector('.dynamic-content', { timeout: 5000 });
} catch (error) {
console.log('元素未找到,尝试备选方案...');
// 备选方案
}
// 页面异常捕获
page.on('pageerror', error => {
console.error('页面JS错误:', error.message);
});
// 请求失败重试
page.on('requestfailed', request => {
console.error('请求失败:', request.url(), request.failure()?.errorText);
});
触发关键词
- "自动登录这个网站"
- "帮我把这个表单填了"
- "抓取这个页面的数据"
- "页面截个图"
- "自动化操作这个流程"
- "批量处理网页"
- "帮我在网页上点一下"
- "爬取这个网站"
- "网页数据采集"
最佳实践
- 优先语义化选择器:text=、data-testid、role 优于 CSS/XPath
- 避免脆弱的定位:不用索引依赖的选择器(
:nth-child(3)) - 操作前等待就绪:每个交互前等待目标元素出现
- 验证操作结果:操作后验证预期结果,而非假设成功
- 错误恢复:设计超时和异常处理机制
- 反检测策略:合理延迟(100-300ms 随机)、调整 User-Agent
- 资源管理:用完关闭浏览器实例,避免内存泄漏
注意事项
- 遵守网站的 robots.txt 和使用条款
- 合理设置请求频率,避免对服务器造成压力
- 注意登录凭证安全,不硬编码密码/Token
- 处理验证码/滑块时需人类介入
- 不用于破解、撞库、批量注册等非法行为
- 微信/淘宝等网站的自动化需特别注意风控机制
- 国内网站可能有更严格的反爬措施(字体反爬、CSS 偏移等)
- 建议配合浏览器自动化工具(Playwright/Selenium/Puppeteer)使用
同分类其他技能
查看全部 ›
编程大神.Skill
【全栈能力】编程大神.Skill:面向复杂真实项目的高阶全栈编程助手。不止生成代码,而是从一句目标接手陌生代码库,拆解需求、补齐实现、追
142 1217.9万 编程专家Pro.Skill编程专家 Pro:融合编程专家 2.0.3 工程专题与编程大神的鸿蒙 ArkTS/ArkUI、微信小程序和小游戏开发资料。用于项目实现、
46 634.2万 编程专家.Skill编程专家.Skill P8级编程助手,完整闭环式 全栈编程专家:Java/Php网站/小程序/软件项目、API设计、Bug诊断、代码生成
394 620.4万 dev-expert编程专家.Skill P8级编程助手,25年实战经验技能Skill,全栈:Java/Php网站/软件项目、API设计、Bug诊断、代码生
34 545.3万 dev-expert-pro编程专家 Pro:融合编程专家 2.0.3 工程专题与编程大神的鸿蒙 ArkTS/ArkUI、微信小程序和小游戏开发资料。用于项目实现、
0 110.2万 编程专家 Pro编程专家 Pro 是一款本地知识与工作流技能包,集成工程专题、鸿蒙 ArkTS/ArkUI 及微信小程序/小游戏开发资料。按任务读取对应
1 103.7万