adspower-browser を使った AdsPower Local API

Skills CLI (npx adspower-browser) は adspower-browser CLI 経由で AdsPower ブラウザプロファイル、グループ、プロキシ、アプリケーション/カテゴリリストを操作するためのパッケージマネージャーです。当社の製品およびサービスの詳細については、AdsPower Official Website にアクセスしてください。

CLI のインストール

npm install -g adspower-browser

インストール後、以下のいずれかの同等のコマンドを使用できます:

adspower-browser
adspower
ads

adspower-browser は元のコマンド名です。adspower と ads は同じ CLI エントリポイントを指すエイリアスです。

このスキルを使用する場合

ユーザーが以下のいずれかを行う場合に適用します:

• AdsPower ブラウザプロファイルの作成、更新、削除、またはリスト化をリクエストする
• 「環境を開く」「ファイルを設定する」「プロファイル」「AdsPower」などと述べて既存ブラウザ環境の起動を意図する → open-browser を使用（CLI または MCP）；詳細なマッピングについては references/tool-intent-map.md を参照
• ブラウザ/プロファイルの開閉、フィンガープリント、UA、またはプロキシについて言及する
• グループ、タグ、プロキシの管理、または API ステータスの確認を希望する
• AdsPower または adspower-browser を参照する（MCP が実行されていないか望まない場合）

AdsPower が実行されていることを確認してください（デフォルトポート 50325）。必要に応じて --port / --api-key を渡すか、start を実行する前に ADS_API_KEY 環境変数を設定してください。

CLI 自体は API キーを使用して AdsPower アプリケーションの起動をサポートしています。AdsPower クライアントがインストールされている場合、API キーを介して AdsPower ヘッドレスモードを起動することもできます。

実行方法

以下の例では簡潔さのため ads を使用していますが、adspower-browser と adspower も同じように動作します。

ads start -k <KEY>

ADS_API_KEY 環境変数が設定されている場合、CLI を直接起動できます:

ads start

一般的なコマンド形式:

ads <command> [<arg>] [--port PORT] [--api-key KEY]

AdsPower クライアント ヘッドレスモード:

AdsPower Global：
Windows設備下： "AdsPower Global.exe" --headless=true --api-key=your_api_key --api-port=50325
MacOS設備下："/Applications/AdsPower Global.app/Contents/MacOS/AdsPower Global" --args --headless=true --api-key=your_api_key --api-port=50325
Linux設備下：adspower_global --headless=true --api-key=your_api_key --api-port=50325

<arg> の 2 つの形式:

1. 単一値（短縮形） — プロファイル関連コマンドの場合、1 つのプロファイル ID または番号を渡します:

   • ads open-browser <profile_id>
   • ads close-browser <profile_id>
   • ads get-profile-cookies <profile_id>
   • ads get-browser-active <profile_id>
   • ads get-profile-ua <profile_id> （単一 ID；数値トークンは profile_no として扱われます）
   • ads new-fingerprint <profile_id> （単一 ID；数値トークンは profile_no として扱われます）

2. JSON 文字列 — すべてのコマンドの完全なパラメータ（以下のコマンドリファレンスを参照）:

   • ads open-browser '{"profile_id":"abc123","launch_args":"..."}'
   • パラメータなしのコマンド: <arg> を省略するか '{}' を使用します。

AI エージェント向けの重要コマンド

ads -h または ads <command> -h を使用して特定のパラメータを確認できます。

CLI の開始と停止

ads start -k <KEY>                    # adspower ランタイムを開始
ads stop                              # adspower ランタイムを停止
ads restart                           # adspower ランタイムを再起動
ads status                            # adspower ランタイムのステータスを取得

ブラウザプロファイル – 開く/閉じる

ads open-browser <profile_id>                    # または JSON: profile_id, profile_no?, ip_tab?, launch_args?, headless?, last_opened_tabs?, proxy_detection?, password_filling?, password_saving?, cdp_mask?, delete_cache?, device_scale?
ads close-browser <profile_id>                   # または JSON: profile_id? | profile_no? （いずれか必須）

ブラウザプロファイル – 作成/更新/削除/リスト

ads create-browser '{"group_id":"0","user_proxy_config":{"proxy_soft":"no_proxy"},...}'  # group_id + account フィールド必須；プロキシはオプション（デフォルトは no_proxy；両方が与えられた場合 proxyid が優先）
ads update-browser '{"profile_id":"...",...}'    # profile_id 必須
ads delete-browser '{"profile_id":["..."]}'     # profile_id 必須
ads get-browser-list '{}'                       # または group_id?, limit?, page?, profile_id[]?, profile_no[]?, sort_type?, sort_order?, tag_ids?, tags_filter?, name?, name_filter?
ads get-opened-browser                          # パラメータなし

ブラウザプロファイル – 移動/クッキー/UA/フィンガープリント/キャッシュ/共有/アクティブ

ads move-browser '{"group_id":"1","user_ids":["..."]}'   # group_id + user_ids 必須
ads get-profile-cookies <profile_id>             # または JSON: profile_id? | profile_no?
ads get-profile-ua <profile_id>                  # または JSON: profile_id[]? | profile_no[]? （最大 10）；数値短縮形は profile_no[] にマップ
ads close-all-profiles                          # パラメータなし
ads new-fingerprint <profile_id>                 # または JSON: profile_id[]? | profile_no[]? （最大 10）；数値短縮形は profile_no[] にマップ
ads delete-cache-v2 '{"profile_id":["..."],"type":["cookie","history"]}'  # type: local_storage|indexeddb|extension_cache|cookie|history|image_file
ads share-profile '{"profile_id":["..."],"receiver":"email@example.com"}' # receiver 必須；share_type?, content?
ads get-browser-active <profile_id>              # または JSON: profile_id? | profile_no?
ads get-cloud-active '{"user_ids":"id1,id2"}'    # user_ids カンマ区切り、最大 100

カーネル

ads download-kernel '{"kernel_type":"Chrome","kernel_version":"141"}'
ads get-kernel-list '{}'                         # kernel_type?: Chrome | Firefox （すべて取得する場合は省略）

パッチ

ads update-patch '{}'                            # version_type?: stable | beta （デフォルト stable）

タグ

ads get-tag-list '{}'                              # ids?, limit?, page?
ads create-tag '{"tags":[{"name":"My tag","color":"blue"}]}'   # name 必須；color オプション
ads update-tag '{"tags":[{"id":"1","name":"Renamed"}]}'        # id 必須；name?, color?
ads delete-tag '{"ids":["tagId1","tagId2"]}'                   # ids 必須

グループ

ads create-group '{"group_name":"My Group","remark":"..."}'   # group_name 必須
ads update-group '{"group_id":"1","group_name":"New Name"}'    # group_id + group_name 必須；remark? （クリアする場合は null）
ads get-group-list '{}'                         # group_name?, page_size?, page?

アプリケーション（カテゴリ）

ads check-status                                # パラメータなし – API 利用可能性
ads get-application-list '{"category_id":"123","page":1,"limit":20}'

プロキシ

ads create-proxy '[{"type":"http","host":"127.0.0.1","port":"8080"}]'  # トップレベル配列；type, host, port 各項目必須
ads update-proxy '{"proxy_id":"proxy-1","proxy_url":"https://refresh.example.com"}'
ads get-proxy-list '{}'                         # limit?, page?, proxy_id[]?
ads delete-proxy '{"proxy_id":["..."]}'        # proxy_id 必須、最大 100

コマンドリファレンス（完全なインターフェースとパラメータ）

ブラウザプロファイル管理

open-browser、close-browser、create-browser、update-browser、delete-browser、get-browser-list、get-opened-browser、move-browser、get-profile-cookies、get-profile-ua、close-all-profiles、new-fingerprint、delete-cache-v2、share-profile、get-browser-active、get-cloud-active およびそれらのパラメータについては references/browser-profile-management.md を参照してください。

グループ管理

create-group、update-group、get-group-list のパラメータについては references/group-management.md を参照してください。

アプリケーション管理

check-status および get-application-list のパラメータについては references/application-management.md を参照してください。

プロキシ管理

create-proxy、update-proxy、get-proxy-list、delete-proxy のパラメータと列挙型については references/proxy-management.md を参照してください。

タグ管理

get-tag-list、create-tag、update-tag、delete-tag のパラメータについては references/browser-tag-management.md を参照してください。

カーネル管理

download-kernel および get-kernel-list のパラメータについては references/browser-kernel-management.md を参照してください。

パッチ管理

update-patch のパラメータについては references/client-patch-management.md を参照してください。

user_proxy_config （create-browser / update-browser のインラインプロキシ設定）

すべてのフィールド（proxy_soft、proxy_type、proxy_host、proxy_port など）と例については references/user-proxy-config.md を参照してください。デフォルトは {"proxy_soft":"no_proxy"} です（省略時）。proxyid も提供されている場合、proxyid が優先され user_proxy_config は無視されます。

fingerprint_config （create-browser / update-browser のフィンガープリント設定）

すべてのフィールド（timezone、language、WebRTC、browser_kernel_config、random_ua、TLS など）と例については references/fingerprint-config.md を参照してください。

自動化（このCLIではサポートされていません）

navigate、click-element、fill-input、screenshot などのコマンドは永続的なブラウザ接続を必要とし、このCLIでは公開されていません。オートメーションについては local-api-mcp MCP サーバーを使用してください。

詳細ドキュメント

完全な列挙値とフィールドリストを含むリファレンスドキュメント:

リファレンス	説明	使用時機
references/tool-intent-map.md	MCP/CLI ツール名と中英 intent、triggers の対照表（toolIntentMetadata.ts と同源）。	ユーザーの自然言語に基づいて対応する CLI コマンドまたは MCP ツールを選択（特に open-browser）。
references/browser-profile-management.md	open-browser、close-browser、create-browser、update-browser、delete-browser、get-browser-list、get-opened-browser、move-browser、get-profile-cookies、get-profile-ua、close-all-profiles、new-fingerprint、delete-cache-v2、share-profile、get-browser-active、get-cloud-active のパラメータ。	ブラウザプロファイル操作（開く、作成、更新、削除、リスト、移動、クッキー、UA、キャッシュ、共有、ステータス）。
references/group-management.md	create-group、update-group、get-group-list のパラメータ。	ブラウザグループの作成、更新、またはリスト化。
references/application-management.md	check-status、get-application-list のパラメータ。	API 利用可能性の確認またはアプリケーション（カテゴリ）のリスト化。
references/proxy-management.md	create-proxy、update-proxy、get-proxy-list、delete-proxy のパラメータと列挙型。	プロキシの作成、更新、リスト化、または削除。
references/browser-tag-management.md	get-tag-list、create-tag、update-tag、delete-tag のパラメータ。	ブラウザタグのリスト化、作成、更新、または削除。
references/browser-kernel-management.md	download-kernel、get-kernel-list のパラメータ。	特定のカーネルをダウンロードしたり、サポートされているカーネルバージョンを照会したり。
references/client-patch-management.md	update-patch のパラメータ。	AdsPower クライアントを最新のパッチチャネル（stable/beta）に更新。
references/user-proxy-config.md	完全な user_proxy_config フィールドリスト（proxy_soft、proxy_type、proxy_host、proxy_port など）と例。	proxyid を使用していない場合に create-browser / update-browser 用のインラインプロキシ設定を構築。
references/fingerprint-config.md	完全な fingerprint_config フィールドリスト（timezone、language、WebRTC、browser_kernel_config、random_ua、TLS など）と例。	create-browser / update-browser 用のフィンガープリント設定を構築または編集。
references/browser-kernel-config.md	fingerprint_config.browser_kernel_config の type および version。バージョンはタイプ（Chrome vs Firefox）と一致する必要があります。	ブラウザを作成または更新する際に特定のブラウザカーネル（Chrome/Firefox とバージョン）をピンイングまたは選択。
references/browser-kernel-download-management.md	download-kernel のパラメータ（kernel_type、kernel_version）。	特定のブラウザカーネルバージョンをダウンロードまたは更新し、進捗/ステータスをポーリング。
references/ua-system-version.md	fingerprint_config.random_ua の ua_system_version 列挙型: 特定の OS バージョン、システムごとのジェネリック「任意バージョン」、および省略時の動作。	ブラウザを作成または更新する際に UA を OS で制約またはランダム化（例：Android のみ、または「任意 macOS バージョン」）。

正確な許可値またはセマンティクスが必要な場合にこれらを使用してください。上記のメインスキルテキストはサマリーのみです。