# QB X5 Use
Based on the Browser, providing comprehensive browser automation capabilities.
Installation (one-time only)
Install QQ Browser and the x5use Python package.
``bash
bash skills/qb-x5-use/scripts/install_dep.sh
`
Setup (run before each session)
Start the X5 background service on port 18009. Must be called after Installation. If the service is already running, it exits immediately without restarting.
`bash
bash skills/qb-x5-use/scripts/setup.sh
`
Commands
Navigation
`bash
python3 skills/qb-x5-use/scripts/go_to_url.py # Navigate to URL
python3 skills/qb-x5-use/scripts/go_back.py # Go back
`
Element interaction
`bash
python3 skills/qb-x5-use/scripts/click_element.py [xpath] # Click element by index
python3 skills/qb-x5-use/scripts/input_text.py [xpath] # Fill input by index
python3 skills/qb-x5-use/scripts/get_dropdown_options.py # Get dropdown options
python3 skills/qb-x5-use/scripts/select_dropdown_option.py # Select dropdown option
`
Scrolling
`bash
python3 skills/qb-x5-use/scripts/scroll_down.py [amount] # Scroll down
python3 skills/qb-x5-use/scripts/scroll_up.py [amount] # Scroll up
python3 skills/qb-x5-use/scripts/scroll_to_text.py # Scroll to text
python3 skills/qb-x5-use/scripts/scroll_to_top.py # Scroll to top
python3 skills/qb-x5-use/scripts/scroll_to_bottom.py # Scroll to bottom
`
Download
`bash
python3 skills/qb-x5-use/scripts/download_file.py # Download file by index
python3 skills/qb-x5-use/scripts/download_url.py # Download file by URL
`
Content
`bash
python3 skills/qb-x5-use/scripts/get_content.py # Get page content as Markdown
`
Wait
`bash
python3 skills/qb-x5-use/scripts/wait.py [seconds] # Wait specified time
`
Core workflow
Navigate:
go_to_url.py
Read result: Check the returned interactive elements with refs like
[0], [1]
Interact: Use index from the result to click, fill, select, etc.
Re-read result: After navigation or interaction, check new interactive elements
Return value
Every command returns the current page state, including action result and interactive elements.
Structure
Action Result
Success or Failed status
Target URL and Content-Type
Page Content
| Field | Description |
|-------|-------------|
| Previous page | Title and URL of the previous page |
| Action | Action name and parameters |
| Action Result | Execution result (e.g. navigation triggered) |
| Current page | Title and URL of the current page |
| Interactive elements | All interactive elements in the viewport, each with [index] |
Example output
Navigating to Baidu:
`bash
python3 skills/qb-x5-use/scripts/go_to_url.py https://www.baidu.com/
``
Action result: Success! Navigated to https://www.baidu.com/, The Content-Type of the url in response headers is 'text/html; charset=utf-8'
>>>>> Page Content
State of current webpage. NOTE that the following is one-time information!
[Start of state]
Previous page: 百度一下，你就知道 (https://www.baidu.com/)
Action: go_to_url ({"url":"https://www.baidu.com/"})
Action Result: navigation triggered.
Current page: [0] 百度一下，你就知道 (https://www.baidu.com/)
Interactive elements from top layer of current page inside the viewport: [Start of page]
[0]
[1]
[2]
[3]
[5]
[13]
[29]
[12]登录/>
...
[End of page]
[End of state]
`
Interactive element format
Each element: [index]
| Part | Description | Example |
|------|-------------|---------|
| [index] | Element index for click_element, input_text, etc. | [13] |
| | HTML element type (a, button, textarea, div, img, span) |
by