get_dom_tree
Extract structured DOM tree data to analyze page hierarchy, generate precise element selectors, and understand layout relationships for web automation workflows.
Instructions
获取DOM树结构(结构化分析工具)
⚠️ 核心分析工具:这是标准化工作流程的第3步!
🎯 主要用途:
1. 📋 获取页面的层次化结构信息
2. 🔍 为元素定位提供精确的选择器路径
3. 🎯 分析页面布局,理解元素间的父子关系
4. 🛠️ 为非多模态LLM提供详细的结构化信息
💡 与其他工具的协作:
- 在 take_screenshot() 和 get_page_text() 之后使用
- 为 find_elements() 提供选择器构建依据
- 配合 get_element_text() 验证元素内容
Args:
selector: 起始选择器(默认"body"获取整个页面结构)
max_depth: 最大遍历深度(默认10层,避免过深嵌套)
Returns:
str: 结构化的DOM树信息,包含标签、属性、层级关系
🚀 使用建议:
- 首次分析页面:使用默认参数获取完整结构
- 聚焦特定区域:指定具体的selector缩小范围
- 复杂页面:适当减少max_depth避免信息过载
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| selector | No | body | |
| max_depth | No |