qqbrowser-skill
Platform Support
- Linux x86_64: Supported
- Windows: Supported
- macOS: Supported
- Other Linux architectures (ARM, etc.) are not supported.
Installation
Linux:
pipx install qqbrowser-skill
qqbrowser-skill install # Download and install QQ BrowserWindows:
pip install qqbrowser-skill
qqbrowser-skill install # Download and install QQ BrowsermacOS:
pipx install qqbrowser-skill
qqbrowser-skill install # Download and install QQ BrowserSecurity
Permissions
This skill requires the following permissions to function properly:
| Permission | Scope | Purpose |
|---|---|---|
| Network Access | Outbound HTTP/HTTPS | Required for browser navigation, page loading, and web interaction |
| File System (Read/Write) | Temporary directories only | Required for saving screenshots (.webp) and downloaded files |
QQBrowser Binary
The qqbrowser-skill install command downloads the QQ Browser package from official Tencent distribution channels via HTTPS:
- Base URL:
https://dldir1v6.qq.com/invc/tt/QB/Public/ dldir1v6.qq.comis Tencent's official software distribution CDN.- All downloads are performed over HTTPS to ensure transport-level security.
File Storage
- Screenshots: Saved to the system's temporary directory (e.g.,
/tmp/on Linux) and returned as file paths. - Downloaded files: Saved to the system's temporary directory or user-specified path via
browser_download_file/browser_download_url. - This skill does not access or modify files outside of its designated directories.
Note:
Each command will return a snapshot of the current page after execution, including the index of elements. Please call the standalone qqbrowser-skill browser_snapshot command only when necessary to avoid unnecessary token consumption.
Core Workflow
Every browser automation follows this pattern:
- Navigate:
qqbrowser-skill browser_go_to_url --url <url> - Snapshot:
qqbrowser-skill browser_snapshot(get indexed element refs) - Interact: Use element index to click, fill, select
- Re-snapshot: After navigation or DOM changes, get fresh refs
qqbrowser-skill browser_go_to_url --url https://example.com/form
qqbrowser-skill browser_snapshot
# Output includes element indices: [1] input "email", [2] input "password", [3] button "Submit"
qqbrowser-skill browser_input_text --index 1 --text "user@example.com"
qqbrowser-skill browser_input_text --index 2 --text "password123"
qqbrowser-skill browser_click_element --index 3
qqbrowser-skill browser_wait --seconds 2
qqbrowser-skill browser_snapshot # Check resultEssential Commands
# Navigation
qqbrowser-skill browser_go_to_url --url <url> # Navigate to URL
qqbrowser-skill browser_go_back # Go back
qqbrowser-skill browser_wait --seconds 3 # Wait for page load (default 3s)
# Snapshot & Screenshot
qqbrowser-skill browser_snapshot # Get page content with element indices
qqbrowser-skill browser_screenshot # Take screenshot (returns temp file path of .webp image)
qqbrowser-skill browser_screenshot --full # Full-page screenshot (returns temp file path)
qqbrowser-skill browser_screenshot --annotate # Annotated screenshot with element labels (returns temp file path)
qqbrowser-skill browser_markdownify # Convert page to markdown
# Click & Input (use indices from snapshot)
qqbrowser-skill browser_click_element --index 1 # Click element
qqbrowser-skill browser_dblclick_element --index 1 # Double-click element
qqbrowser-skill browser_focus_element --index 1 # Focus element
qqbrowser-skill browser_input_text --index 1 --text "hello" # Input text into element
# Scroll
qqbrowser-skill browser_scroll_down # Scroll down one page
qqbrowser-skill browser_scroll_down --amount 300 # Scroll down 300px
qqbrowser-skill browser_scroll_up # Scroll up one page
qqbrowser-skill browser_scroll_up --amount 300 # Scroll up 300px
qqbrowser-skill browser_scroll_to_text --text "Section 3" # Scroll to text
qqbrowser-skill browser_scroll_to_top # Scroll to top
qqbrowser-skill browser_scroll_to_bottom # Scroll to bottom
qqbrowser-skill browser_scroll_by --direction down --pixels 500 # Scroll page by direction
qqbrowser-skill browser_scroll_by --direction right --pixels 200 --index 3 # Scroll element by direction
qqbrowser-skill browser_scroll_into_view --index 5 # Scroll element into view
# Keyboard
qqbrowser-skill browser_keypress --key Enter # Press a key
qqbrowser-skill browser_keyboard_op --action type --text "hello" # Type text
qqbrowser-skill browser_keyboard_op --action inserttext --text "hello" # Insert text without key events
qqbrowser-skill browser_keydown --key Shift # Hold down a key
qqbrowser-skill browser_keyup --key Shift # Release a key
# Dropdown
qqbrowser-skill browser_get_dropdown_options --index 2 # Get dropdown options
qqbrowser-skill browser_select_dropdown_option --index 2 --text "Option A" # Select option
# Checkbox
qqbrowser-skill browser_check_op --index 4 --value # Check checkbox
qqbrowser-skill browser_check_op --index 4 --no-value # Uncheck checkbox
# Get Information
qqbrowser-skill browser_get_info --type text --index 1 # Get element text
qqbrowser-skill browser_get_info --type url # Get current URL
qqbrowser-skill browser_get_info --type title # Get page title
qqbrowser-skill browser_get_info --type html --index 1 # Get element HTML
qqbrowser-skill browser_get_info --type value --index 1 # Get element value
qqbrowser-skill browser_get_info --type attr --index 1 --attribute href # Get attribute
qqbrowser-skill browser_get_info --type count # Get element count
qqbrowser-skill browser_get_info --type box --index 1 # Get bounding box
qqbrowser-skill browser_get_info --type styles --index 1 # Get computed styles
qqbrowser-skill browser_check_state --state visible --index 1 # Check visibility
qqbrowser-skill browser_check_state --state enabled --index 1 # Check if enabled
qqbrowser-skill browser_check_state --state checked --index 1 # Check if checked
# Find and Act (semantic locators)
qqbrowser-skill browser_find_and_act --by role --value button --action click --name "Submit"
qqbrowser-skill browser_find_and_act --by text --value "Sign In" --action click
qqbrowser-skill browser_find_and_act --by label --value "Email" --action fill --actionValue "user@test.com"
qqbrowser-skill browser_find_and_act --by placeholder --value "Search" --action type --actionValue "query"
qqbrowser-skill browser_find_and_act --by testid --value "submit-btn" --action click
# Download
qqbrowser-skill browser_download_file --index 5 # Download file by clicking element
qqbrowser-skill browser_download_url # Download from URL
# Tab Management
qqbrowser-skill browser_tab_open --url <url> # Open URL in new tab
qqbrowser-skill browser_tab_list # List open tabs
qqbrowser-skill browser_tab_switch --tabId 2 # Switch to tab
qqbrowser-skill browser_tab_close --tabId 2 # Close tab
# Dialog
qqbrowser-skill browser_dialog --action accept # Accept dialog
qqbrowser-skill browser_dialog --action dismiss # Dismiss dialog
qqbrowser-skill browser_dialog --action accept --text "input text" # Accept prompt with text
# Task Completion
qqbrowser-skill browser_done --success --text "Task completed" # Mark task as done
qqbrowser-skill browser_done --text "Still in progress" # Mark task as incomplete
# Help
qqbrowser-skill list # List all available skills
qqbrowser-skill <skill_name> --help # Show help for a specific skill
# Skill Check
qqbrowser-skill status # Check skill statusCommon Patterns
Form Submission
qqbrowser-skill browser_go_to_url --url https://example.com/signup
qqbrowser-skill browser_snapshot
qqbrowser-skill browser_input_text --index 1 --text "Jane Doe"
qqbrowser-skill browser_input_text --index 2 --text "jane@example.com"
qqbrowser-skill browser_select_dropdown_option --index 3 --text "California"
qqbrowser-skill browser_check_op --index 4 --value
qqbrowser-skill browser_click_element --index 5
qqbrowser-skill browser_wait --seconds 2
qqbrowser-skill browser_snapshot # Verify resultData Extraction
qqbrowser-skill browser_go_to_url --url https://example.com/products
qqbrowser-skill browser_snapshot
qqbrowser-skill browser_get_info --type text --index 5 # Get specific element text
qqbrowser-skill browser_markdownify # Get full page as markdownInfinite Scroll Pages
qqbrowser-skill browser_go_to_url --url https://example.com/feed
qqbrowser-skill browser_scroll_to_bottom # Trigger lazy loading
qqbrowser-skill browser_wait --seconds 2 # Wait for content
qqbrowser-skill browser_snapshot # Get updated contentElement Index Lifecycle (Important)
Element indices are invalidated when the page changes. Always re-snapshot after:
- Clicking links or buttons that navigate
- Form submissions
- Dynamic content loading (dropdowns, modals, AJAX)
qqbrowser-skill browser_click_element --index 5 # May navigate to new page
qqbrowser-skill browser_snapshot # MUST re-snapshot
qqbrowser-skill browser_click_element --index 1 # Use new indicesEvaluation Report
See the full skill evaluation report: QQBrowserSkillReport