核心功能: 本技能提供化工作流场景等能力。
核心功能: 本技能提供中文交互、时使用、、工作流优化时使用、处理、工作流优化时使用等能力。
Browser Automation
专业版增强能力
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| 多标签页并行抓取 | 不支持 | 支持 |
| 反爬虫策略自动绕过 | 不支持 | 支持 |
| 页面结构变化自适应 | 不支持 | 支持 |
| 批量导出结构化数据 | 不支持 | 支持 |
功能能力
- Automate web browser interactions using natural language via CLI commands
- Use when the user asks
快速入门
- 确认运行环境满足依赖说明中的要求
- 在AI Agent对话中调用本技能,提供必要的输入参数
- 检查输出结果,根据需要进行后续处理
详细的输入输出格式请参考下方章节说明。
应用场景
| 场景 | 输入 | 输出 |
|---|---|---|
| 场景1 自然语言经CLI自动化浏览器交互 | 用户请求数据 | 结构化处理结果 |
| 场景2 告别手写脚本 | 用户请求数据 | 结构化处理结果 |
不适用于:需要人工判断的复杂决策场景
使用方法
- 初始化浏览器会话: 启动无头浏览器实例,配置代理与用户代理参数
- 执行页面交互: 按照用户指令进行导航/点击/输入/提取等页面操作
- 采集与返回数据: 提取页面内容或操作结果,返回结构化数据与截图
- 异常处理: 如遇错误,参考错误处理章节中对应场景的处理方式
请求格式
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content | string | 否 | browser-automation处理的内容输入 |
| mode | string | 否 | 处理模式, 可选: json/text/markdown, |
| max_retries | integer | 否 | 单步最大重试次数, 默认: 2 |
| skip_steps | array | 否 | 跳过的步骤编号(用于断点续传), 默认: [] |
返回格式
{
"success": true,
"data": {
"final_result": {
"automation_result": "automation_result_value",
"automation_metadata": "automation_metadata_value",
"automation_status": "automation_status_value"
},
"execution_log": [
{
"step": 1,
"name": "按流程执行",
"status": "completed",
"duration_ms": 1200,
"output_summary": "按流程执行"
},
{
"step": 2,
"name": "按流程执行",
"status": "completed",
"duration_ms": 3500,
"output_summary": "按流程执行"
},
{
"step": 3,
"name": "按流程执行",
"status": "completed",
"duration_ms": 2100,
"output_summary": "按流程执行"
},
{
"step": 4,
"name": "按流程执行",
"status": "completed",
"duration_ms": 800,
"output_summary": "按流程执行"
}
],
"total_duration_ms": 7600,
"gates_passed": 3,
"gates_total": 3
},
"error": null
}
中间产物模板参考: assets/browser-automation_template
异常管理
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 页面加载超时 | 目标网站响应慢或网络延迟 | 增加超时阈值,启用重试机制,检查代理配置 |
| 页面结构变化导致选择器失效 | 目标网站更新了DOM结构 | 切换到可访问性树定位元素,或提示用户提供新的选择器 |
| 反爬虫机制触发 | 频繁请求被目标站点识别 | 降低请求频率,启用随机延迟,更换User-Agent |
前置条件
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
依赖说明(补充)
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
API Key 配置
可用性分类
- 分类: MD+execute()
- 说明: 基于Markdown的AI Skill,
API Key配置方式:
export API_KEY="${API_KEY:?请设置环境变量}"
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
案例展示
browser navigate https://example.com
browser act "click the Sign In button"
browser extract "get the page title"
browser close
热门问题
Q1: 如何开始使用Browser Automation?
A: 请参考使用流程和依赖说明章节,确保运行环境满足要求后调用本技能。
错误处理机制
| 错误场景2 | 原因 | 处理方式 |
|---|---|---|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | 请求重试;确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求,参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述,补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求;检查命令权限设置 |
创新亮点
效率提升量化分析
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 页面导航 | 15分钟 | 30秒 | 14分钟 | 100% |
| 数据提取 | 1小时 | 10分钟 | 50分钟 | 95% |
| 数据验证 | 30分钟 | 5分钟 | 25分钟 | 98% |
| 批量处理 | 2小时 | 20分钟 | 1小时40分钟 | 100% |
| 日志记录 | 1小时 | 5分钟 | 55分钟 | 100% |
差异化对比
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 易用性 | 高 | 低 | 中 | 高 |
| 交互性 | 高 | 低 | 低 | 高 |
| 适应性 | 中 | 低 | 低 | 高 |
| 成本 | 低 | 高 | 中 | 高 |
| 学习曲线 | 低 | 高 | 中 | 高 |
核心痛点解决
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 手动操作效率低 | 重复性任务手动操作耗时过长,影响工作效率 | 各行业 | 引入自动化工具,提高操作效率 | 平均时间节约30% |
| 脚本编写复杂 | 编写和维护自动化脚本需要专业知识和时间投入 | 开发者 | 提供自然语言交互,降低技术门槛 | 编写效率提升50% |
| 数据处理困难 | 手动处理大量数据费时费力,且易出错 | 数据分析师 | 自动化提取和整理数据,减少错误 | 准确率提升20% |
常见问题FAQ
Q1: 什么是浏览器自动化?
A: 浏览器自动化是指通过脚本或程序来模拟人类操作浏览器的过程,如导航、点击、输入等,从而实现自动化的网页交互。
Q2: 浏览器自动化适用于哪些场景?
A: 浏览器自动化适用于需要自动化处理网页数据的场景,如数据采集、网页测试、自动化测试等。
Q3: 浏览器自动化需要哪些技术基础?
A: 浏览器自动化通常需要了解Web技术、编程语言(如Python、JavaScript等)以及自动化测试框架。
Q4: 浏览器自动化有哪些优点?
A: 浏览器自动化的优点包括提高效率、降低人工成本、减少错误、实现自动化测试等。
Q5: 如何选择合适的浏览器自动化工具?
A: 选择合适的浏览器自动化工具需要考虑需求、易用性、稳定性、支持性等因素,选择符合自己需求的工具。
问题排查手册
| 错误现象 | 可能原因 | 诊断步骤 | 解决方案 |
|---|---|---|---|
| 页面加载失败 | 网络问题、代理设置错误 | 检查网络连接、代理设置 | 修复网络问题、重新配置代理 |
| 操作执行失败 | 选择器错误、元素不可用 | 检查选择器、元素状态 | 修正选择器、等待元素加载 |
| 数据提取错误 | 数据格式问题、数据处理逻辑错误 | 检查数据格式、逻辑 | 修正数据格式、优化处理逻辑 |
| 脚本执行异常 | 代码错误、依赖问题 | 检查代码、依赖库 | 修正代码、安装依赖库 |
安全声明
- 确保使用合法的浏览器自动化工具,避免侵犯网站版权。
- 避免使用高频请求导致网站服务器过载。
- 注意个人隐私和数据安全,不泄露敏感信息。
- 定期更新浏览器自动化工具,确保安全性和兼容性。
- 合理使用资源,避免过度占用服务器和带宽。
安全风险防范
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置,禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令,避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议,验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限,实施认证机制 | 定期审计访问日志 |
功能概览
- 自动化执行: 自然语言经CLI自动化浏览器交互,告别手写脚本。Automate web browser interactions us
- 文件处理: 支持多种文件格式的读取、解析和写入操作
- API集成: 通过标准化接口调用外部服务并处理响应
- 命令执行: 在安全沙箱中执行系统命令并收集结果
- 信息检索: 快速搜索和过滤目标数据
