mcpField
Q
qqbrowser-skill

qqbrowser-skill

github.com/qqbrowserteamエージェントワークフロー286 回インストール24 週間前に更新
リポジトリ

qqbrowser-skill について

qqbrowser-skillは、ウェブページの移動や操作を行うQQ Browser向けコマンドラインブラウザー自動化スキルです。操作用のインデックス付きスナップショットと、内容を読むためのMarkdown形式のスナップショットを備えています。

主な機能

  1. 01ページ移動と閲覧履歴の操作
  2. 02インデックス付きスナップショットでページを確認
  3. 03Markdown形式でページ内容を取得
  4. 04クリック、テキスト入力、選択
  5. 05ページのスクロールと読み込み待機
  6. 06スクリーンショットとダウンロードファイルの保存

活用シーン

  1. 01ウェブフォームへの入力と送信
  2. 02ウェブページの情報の閲覧と抽出
  3. 03無限スクロールページの追加コンテンツ読み込み

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/qqbrowserteam/qqbrowser-skill --skill qqbrowser-skill

インストール後、Claude Code で/qqbrowser-skillを入力して読み込まれたか確認します。

詳細

qqbrowser-skill

プラットフォームのサポート

  • Linux x86_64：サポート対象
  • Windows：サポート対象
  • macOS：サポート対象
  • その他の Linux アーキテクチャ（ARM など）はサポートされていません。

インストール

Linux：

pipx install qqbrowser-skill
qqbrowser-skill install   # Download and install QQ Browser

Windows：

pip install qqbrowser-skill
qqbrowser-skill install   # Download and install QQ Browser

macOS：

pipx install qqbrowser-skill
qqbrowser-skill install   # Download and install QQ Browser

セキュリティ

権限

このスキルを正常に動作させるには、次の権限が必要です。

権限範囲目的
ネットワークアクセスアウトバウンド HTTP/HTTPSブラウザーの移動、ページの読み込み、Web 操作に必要です
ファイルシステム（読み取り／書き込み）一時ディレクトリのみスクリーンショット（.webp）やダウンロードしたファイルの保存に必要です
QQBrowser バイナリ

qqbrowser-skill install コマンドは、HTTPS 経由で Tencent の公式配布チャネルから QQ Browser パッケージをダウンロードします。

  • ベース URL：https://dldir1v6.qq.com/invc/tt/QB/Public/
  • dldir1v6.qq.com は Tencent の公式ソフトウェア配布 CDN です。
  • 転送レベルのセキュリティを確保するため、すべてのダウンロードは HTTPS 経由で行われます。
ファイルの保存
  • スクリーンショット：システムの一時ディレクトリ（Linux の場合は /tmp/ など）に保存され、ファイルパスとして返されます。
  • ダウンロードしたファイル：システムの一時ディレクトリ、または browser_download_file／browser_download_url で指定したパスに保存されます。
  • このスキルは、指定されたディレクトリ外のファイルにはアクセスせず、変更もしません。

注意：

各コマンドは実行後に、要素のインデックスを含む現在のページのスナップショットを返します。 不要なトークン消費を避けるため、単独の qqbrowser-skill browser_snapshot コマンドは必要な場合にのみ呼び出してください。

基本的なワークフロー

すべてのブラウザー自動化は、次のパターンに従います。

  1. 移動：qqbrowser-skill browser_go_to_url --url <url>
  2. スナップショット：qqbrowser-skill browser_snapshot（インデックス付きの要素参照を取得）
  3. 操作：要素のインデックスを使ってクリック、入力、選択を行います
  4. 再スナップショット：移動または DOM の変更後に、新しい参照を取得します
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 "[email protected]"
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 result

基本コマンド

# 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                     # Default mode: page content with element indices (for interaction)
qqbrowser-skill browser_snapshot --markdown          # Markdown mode: clean Markdown of the page (for reading/extraction, no 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)

# 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 "[email protected]"
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

# JavaScript Evaluation
qqbrowser-skill browser_eval_content_js --script "document.title"                    # Evaluate JS and return result
qqbrowser-skill browser_eval_content_js --script "ZG9jdW1lbnQudGl0bGU=" --base64    # Evaluate base64-encoded JS script

# 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 status

よくあるパターン

フォームの送信
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 "[email protected]"
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 result
データの抽出

目的に応じて、適切な browser_snapshot モードを選択してください。

  • browser_snapshot --markdown — ページコンテンツ（記事、ドキュメント、検索結果、製品ページ）の閲覧／要約に推奨されます。広告、ナビゲーション、スクリプトを除いた、すっきりした Markdown を返します。トークン効率に優れていますが、要素のインデックスは含まれないため、クリックや入力の操作には使用できません。
  • browser_snapshot（デフォルト）— ページを操作する場合に必要です。browser_click_element、browser_input_text などで使用する、インデックス付きの要素を返します。
qqbrowser-skill browser_go_to_url --url https://example.com/products
qqbrowser-skill browser_snapshot --markdown                # Read the whole page as clean markdown

# Use default snapshot + get_info when you need to interact or read a specific element
qqbrowser-skill browser_snapshot
qqbrowser-skill browser_get_info --type text --index 5     # Get a specific element's text
無限スクロールページ
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 content

要素インデックスのライフサイクル（重要）

ページが変更されると、要素のインデックスは無効になります。次の操作の後は、必ずスナップショットを再取得してください。

  • ページ遷移を伴うリンクやボタンのクリック
  • フォームの送信
  • 動的コンテンツの読み込み（ドロップダウン、モーダル、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 indices

評価レポート

スキルの評価レポート全文はこちらをご覧ください：QQBrowserSkillReport

コメント

Markdown 対応