# AdsPower 本地 API 与 adspower-browser 技能 CLI (npx adspower-browser) 是程序包管理器，用于通过 **adspower-browser** CLI 操作 AdsPower 浏览器配置文件、组、代理和应用程序/类别列表。 ## 何时使用此技能当用户满足以下条件时申请： * 要求创建、更新、删除或列出 AdsPower 浏览器配置文件 * 提及打开或关闭浏览器/配置文件、指纹、UA 或代理 * 想要管理群组、代理或检查 API 状态 * 指 AdsPower 或 adspower-browser（且 MCP 未运行或不需要）确保 AdsPower 正在运行（默认端口 50325）。如果需要，通过环境或“--port”/“--api-key”设置“PORT”和“API_KEY”。 ## 如何运行 adspower-browser [--port PORT] [--api-key KEY] <命令> [] **``的两种形式：** 1. **单值（简写）** — 对于与配置文件相关的命令，传递一个配置文件 ID 或编号： * `adspower-browser 打开浏览器 ` * `adspower-browser 关闭浏览器 ` * `adspower-browser get-profile-cookies ` * `adspower-browser get-browser-active ` * `adspower-browser get-profile-ua `（单个 ID） * `adspower-browser new-fingerprint `（单个 ID） 2. **JSON 字符串** — 任何命令的完整参数（请参阅下面的命令参考）： * `adspower-browser 打开浏览器 '{"profileId":"abc123","launchArgs":"..."}'` * 不带参数的命令：省略 `` 或使用 `'{}'`。 ## 基本命令 ### 浏览器配置文件 – 打开/关闭 adspower-browser open-browser # 或 JSON: profileId, profileNo?, ipTab?, launchArgs?,clearCacheAfterClosing?, cdpMask? adspower-browser close-browser # 或者 JSON: profileId？ |简介没有？（必填一项） ### 浏览器配置文件 – 创建/更新/删除/列表 adspower-browser create-browser '{"groupId":"0","proxyid":"random",...}' # groupId + 帐户字段 + 需要代理 adspower-browser update-browser '{"profileId":"...",...}' # profileId 必需 adspower-browser delete-browser '{"profileIds":["..."]}' # profileIds 必需 adspower-browser get-browser-list '{}' # 或者 groupId?, limit?, page?, profileId?, profileNo?, sortType?, sortOrder? adspower-browser get-opened-browser # 无参数 ### 浏览器配置文件 – move/cookies/UA/fingerprint/cache/share/active adspower-browser move-browser '{"groupId":"1","userIds":["..."]}' # 需要 groupId + userIds adspower-browser get-profile-cookies # 或者 JSON: profileId？ |简介没有？ adspower-browser get-profile-ua # 或者 JSON: profileId[]？ |简介没有[]？（最多 10 个） adspower-browser close-all-profiles # 无参数 adspower-browser new-fingerprint # 或者 JSON: profileId[]？ |简介没有[]？（最多 10 个） adspower-browser delete-cache-v2 '{"profileIds":["..."],"type":["cookie","history"]}' # 类型：local_storage|indexeddb|extension_cache|cookie|history|image_file adspower-browser share-profile '{"profileIds":["..."],"receiver":"email@example.com"}' # 需要接收者；分享类型？，内容？ adspower-browser get-browser-active # 或者 JSON: profileId？ |简介没有？ adspower-browser get-cloud-active '{"userIds":"id1,id2"}' # userIds 以逗号分隔，最大 100 ### 组 adspower-browser create-group '{"groupName":"我的群组","remark":"..."}' # groupName 必填 adspower-browser update-group '{"groupId":"1","groupName":"新名称"}' # groupId + groupName 必需；评论？（为空则清除） adspower-browser get-group-list '{}' # 组名称？，大小？，页面？ ### 应用程序（类别） adspower-browser check-status # 无参数 – API 可用性 adspower-browser get-application-list '{}' # 类别 ID？、页面？、限制？ ### 代理 adspower-browser create-proxy '{"proxies":[{"type":"http","host":"127.0.0.1","port":"8080"}]}' # 每项所需的类型、主机、端口 adspower-browser update-proxy '{"proxyId":"...","host":"..."}' # proxyId 必需 adspower-browser get-proxy-list '{}' # limit?, page?, proxyId? adspower-browser delete-proxy '{"proxyIds":["..."]}' # 需要 proxyId，最多 100 ## 命令参考（完整接口及参数） JSON 中的所有参数名称均采用驼峰命名法。 ### 浏览器配置文件管理有关打开浏览器、关闭浏览器、创建浏览器、更新浏览器、删除浏览器、获取浏览器列表、获取打开浏览器、 move-browser、get-profile-cookies、get-profile-ua、close-all-profiles、new-fingerprint、delete-cache-v2、share-profile、get-browser-active、get-cloud-active 及其参数。 ### 集团管理有关 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]()。 ### UserProxyConfig（创建浏览器/更新浏览器的内联代理配置）请参阅 [references/user-proxy-config.md]() 了解所有字段（proxy_soft、proxy_type、proxy_host、proxy_port 等）和示例。 ### FingerprintConfig（创建浏览器/更新浏览器的指纹配置）请参阅 [references/fingerprint-config.md]() 了解所有字段（时区、语言、WebRTC、browser_kernel_config、random_ua、TLS 等）和示例。 ## 自动化（此 CLI 不支持） “navigate”、“click-element”、“fill-input”、“screenshot”等命令依赖于持久的浏览器连接，并且此 CLI **不**公开。使用 **local-api-mcp** MCP 服务器进行自动化。 ## 深入研究文档包含完整枚举值和字段列表的参考文档：参考|描述 |何时使用 ---|---|--- [references/browser-profile-management.md]() | **打开浏览器**、**关闭浏览器**、**创建浏览器**、**更新浏览器**、**删除浏览器**、**获取浏览器列表**、**获取打开浏览器**、**移动浏览器**、**获取配置文件-cookies**、**获取配置文件-ua**、**关闭所有配置文件**、**新指纹**、 **delete-cache-v2** 、 **share-profile** 、 **get-browser-active** 、 **get-cloud-active** 参数。 |任何浏览器配置文件操作（打开、创建、更新、删除、列表、移动、cookies、UA、缓存、共享、状态）。 [references/group-management.md]() | **创建组**、**更新组**、**获取组列表**参数。 |创建、更新或列出浏览器组。 [references/application-management.md]() | **检查状态**、**获取应用程序列表**参数。 |检查 API 可用性或列出应用程序（类别）。 [references/proxy-management.md]() | **create-proxy** 、 **update-proxy** 、 **get-proxy-list** 、 **delete-proxy** 参数和枚举。 |创建、更新、列出或删除代理。 [references/user-proxy-config.md]() |完整的 **userProxyConfig** 字段列表（proxy_soft、proxy_type、proxy_host、proxy_port 等）和示例。 |不使用 **proxyid** 时为创建浏览器/更新浏览器构建内联代理配置。 [references/fingerprint-config.md]() |完整的 **fingerprintConfig** 字段列表（时区、语言、WebRTC、browser_kernel_config、random_ua、TLS 等）和示例。 |为创建浏览器/更新浏览器构建或编辑指纹配置。 [references/browser-kernel-config.md]() | `fingerprintConfig.browser_kernel_config` 的 **类型** 和 **版本**。版本必须与类型匹配（Chrome 与 Firefox）。 |创建或更新浏览器时固定或选择特定的浏览器内核（Chrome/Firefox 和版本）。 [references/ua-system-version.md]() | **ua_system_version** `fingerprintConfig.random_ua` 的枚举：特定操作系统版本，每个系统的通用“任何版本”，并省略行为。 |创建或更新浏览器时，按操作系统（例如仅限 Android 或“任何 macOS 版本”）限制或随机化 UA。当您需要确切的允许值或语义时，请使用这些；上面的主要技能文字只是概括。

广告动力浏览器

包含技能