adspower-browser

adspower-browser を使用した AdsPower ローカル API

Skills CLI（npx adspower-browser）は、adspower-browser CLI を介して AdsPower のブラウザープロファイル、グループ、プロキシ、アプリケーション／カテゴリのリストを操作するためのパッケージマネージャーです。製品やサービスの詳細については、AdsPower 公式ウェブサイトをご覧ください。

CLI のインストール

npm install -g adspower-browser

インストール後は、次の同等のコマンドを使用できます。

adspower-browser
adspower
ads

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

このスキルを使用するタイミング

ユーザーが次のことを行う場合に使用します。

• AdsPower のブラウザープロファイルの作成、更新、削除、一覧表示を依頼する
• 「环境を開く」、「配置文件」、「profile」、「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. 単一の値（省略形） — プロファイル関連のコマンドでは、プロファイル ID または番号を 1 つ渡します。

   • 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 を 1 つ指定します。数値トークンは profile_no として扱われます）
   • ads new-fingerprint <profile_id>（ID を 1 つ指定します。数値トークンは profile_no として扱われます）

2. JSON 文字列 — 任意のコマンドに完全なパラメーターを指定します（下記の「コマンドリファレンス」を参照）。

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

AI エージェント向けの基本コマンド

ads -h または ads <command> -h を使用すると、各コマンドのパラメーターを確認できます。

CLI の起動と停止

ads start -k <KEY>                    # Start the adspower runtime
ads stop                              # Stop the adspower runtime
ads restart                           # Restart the adspower runtime
ads status                            # Get the status of the adspower runtime

ブラウザープロファイル – 起動／終了

ads open-browser <profile_id>                    # Or 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>                   # Or JSON: profile_id? | profile_no? (one required)

ブラウザープロファイル – 作成／更新／削除／一覧表示

ads create-browser '{"group_id":"0","user_proxy_config":{"proxy_soft":"no_proxy"},...}'  # group_id required: always include it; use "0" for Ungrouped; if given a group name, call get-group-list first; include either proxyid or user_proxy_config
ads update-browser '{"profile_id":"...",...}'    # profile_id required
ads delete-browser '{"profile_id":["..."]}'     # profile_id required
ads get-recycle-bin-list '{}'                   # page?, limit? (1-100). Omit either to use the Local API backend default. Last 30 days only
ads restore-recycle-bin '{"profile_id":["id1","id2"],"group_id":"123"}'  # profile_id[] or profile_no[], group_id required
ads get-browser-list '{}'                       # CLI defaults to page=1,limit=200 (Local API itself returns only 1). Or group_id?, limit?, page?, profile_id[]?, profile_no[]?, sort_type?, sort_order?, tag_ids?, tags_filter?, name?, name_filter?
ads get-opened-browser                          # No params

すべての環境の一覧表示： get-browser-list は total_count ／ total_pages を返します。CLI はデフォルトで page=1,limit=200 を送信するため、1 回の呼び出しで最大 200 件のプロファイルを取得できます。total_pages > 1 の場合は、すべてのページを取得するまで、同じフィルターを使用して page + 1 で呼び出し続けてください。「グループ内のすべての環境を操作する」タスクでは、まずすべてのページを取得し、その後、返されたすべての profile_id に対して操作してください。最初のページだけを対象にしてはいけません。

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

ads move-browser '{"group_id":"1","user_ids":["..."]}'   # group_id + user_ids required
ads get-profile-cookies <profile_id>             # Or JSON: profile_id? | profile_no?
ads get-profile-ua <profile_id>                  # Or JSON: profile_id[]? | profile_no[]? (up to 10); numeric shorthand maps to profile_no[]
ads close-all-profiles                          # No params
ads new-fingerprint <profile_id>                 # Or JSON: profile_id[]? | profile_no[]? (up to 10); numeric shorthand maps to 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 protected]"}' # receiver required; share_type?, content?
ads get-browser-active <profile_id>              # Or JSON: profile_id? | profile_no?
ads get-cloud-active '{"user_ids":"id1,id2"}'    # user_ids comma-separated, max 100

カーネル

ads download-kernel '{"kernel_type":"Chrome","kernel_version":"141"}'
ads get-kernel-list '{}'                         # kernel_type?: Chrome | Firefox (omit to get all)

パッチ

ads update-patch '{}'                            # version_type?: stable | beta (default stable)

タグ

ads get-tag-list '{}'                              # ids?, limit?, page?
ads create-tag '{"tags":[{"name":"My tag","color":"blue"}]}'   # name required per item; color optional
ads update-tag '{"tags":[{"id":"1","name":"Renamed"}]}'        # id required per item; name?, color?
ads delete-tag '{"ids":["tagId1","tagId2"]}'                   # ids required

グループ

ads create-group '{"group_name":"My Group","remark":"..."}'   # group_name required
ads update-group '{"group_id":"1","group_name":"New Name"}'    # group_id + group_name required; remark? (null to clear)
ads get-group-list '{}'                         # group_name?, page_size?, page?

メンバー

ads create-member '{"user_group_id":"...","email":"[email protected]","password":"password1","identity":4}'  # identity: 2 admin, 3 manager, 4 staff; manager optional; member only for identity 3
ads update-member '{"user_id":"...","name":"Alice"}'   # omit to keep; empty name/manager/remark/member/authorized_group can clear; do not empty email or identity
ads reset-member-password '{"user_id":"..."}'          # unbind_phone?: 0|1; new_password is in the response
ads delete-member '{"user_id":"..."}'                  # permanent, not recoverable
ads get-member-list '{}'                               # user_group_id?, user_id[]?, email[]?, page?, limit? (default 50, max 200)
ads get-member-group-list '{}'                         # page?, limit? (default 50, max 200)

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

ads check-status                                # No params – API availability
ads get-application-list '{"category_id":"123","page":1,"limit":20}'

プロキシ

ads create-proxy '[{"type":"http","host":"127.0.0.1","port":"8080"}]'  # top-level array; type, host, port required per item
ads update-proxy '{"proxy_id":"proxy-1","proxy_url":"https://refresh.example.com"}'
ads get-dynamic-proxy-traffic                    # start_date?, end_date? (YYYY-MM-DD); available traffic, package expiration dates, daily usage; defaults to current month through today
ads get-proxy-list '{}'                         # limit?, page?, proxy_id[]?
ads delete-proxy '{"proxy_id":["..."]}'        # proxy_id required, max 100

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

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

open-browser、close-browser、create-browser、update-browser、delete-browser、get-recycle-bin-list、restore-recycle-bin、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 をご覧ください。

メンバー管理

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

アプリケーション管理

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

プロキシ管理

create-proxy、update-proxy、get-proxy-list、get-dynamic-proxy-traffic、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 を参照してください。create-browser では、proxyid または user_proxy_config のいずれかを指定してください。ブラウザープロファイルの作成時にユーザーがプロキシを指定しない場合は、user_proxy_config に {"proxy_soft":"no_proxy"} を設定してください。update-browser では、プロファイルのプロキシを変更する場合にのみ、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-recycle-bin-list、restore-recycle-bin、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 のパラメーター。	ブラウザープロファイルの操作（開く、作成、更新、削除、ゴミ箱、一覧表示、移動、Cookie、UA、キャッシュ、共有、ステータス）を行う場合。
references/group-management.md	create-group、update-group、get-group-list のパラメーター。	ブラウザーグループを作成、更新、一覧表示する場合。
references/member-management.md	create-member、update-member、reset-member-password、delete-member、get-member-list、get-member-group-list のパラメーター。	チームメンバーやメンバーグループを作成、更新、一覧表示、削除する場合。
references/application-management.md	check-status、get-application-list のパラメーター。	API の利用可否を確認する場合や、アプリケーション（カテゴリ）を一覧表示する場合。
references/proxy-management.md	create-proxy、update-proxy、get-proxy-list、get-dynamic-proxy-traffic、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。バージョンは type（Chrome または 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 バージョン、システムごとの汎用的な「任意のバージョン」、および省略時の動作を指定します。	ブラウザーの作成または更新時に、OS によって UA を制限またはランダム化する場合（例：Android のみ、「任意の macOS バージョン」）。
正確な許可値やセマンティクスが必要な場合は、こちらを参照してください。上記のメインスキルの説明は要約のみです。