AdsPower
AdsPower

AdsPower CLI 来了,不装客户端也能操控浏览器

By AdsPower||25 Views

AdsPower 发布了独立的 CLI(命令行工具)。

以前需要在 AdsPower 客户端界面里点鼠标完成的操作,现在可以在命令行里用一行命令完成。配置文件的创建和管理、浏览器的启动和关闭、代理切换、指纹刷新、Cookie 获取、缓存清理、分组标签,全部支持。

CLI 与 AdsPower 客户端完全隔离,独立运行,不共用本地缓存和内核。


安装

两种方式。

有 Node.js 环境的用户,npm 全局安装,

npm install -g adspower-browser

装完之后 adspower-browseradspowerads 三个命令都能用,效果一样。

Windows 用户也可以在 AdsPower 官网下载页直接安装 CLI,

irm https://www.adspower.net/install.ps1 | iex

如果命令执行不成功,可以把安装文件下载下来本地运行。

macOS

curl -fsSL https://www.adspower.net/install.sh | bash

Linux

curl -fsSL https://www.adspower.net/install.sh | bash


基本用法

启动 CLI,

ads start -k <KEY>

设了 ADS_API_KEY 环境变量的话,直接 ads start 就行,不用每次传 key。

打开一个浏览器实例,

ads open-browser <profile_id>

关闭,

ads close-browser <profile_id>

三条命令,一个浏览器实例就起来了。


日常操作速查

配置文件管理,

ads create-browser '{"group_id":"0","user_proxy_config":{"proxy_soft":"no_proxy"}}'
ads update-browser '{"profile_id":"..."}'
ads delete-browser '{"profile_id":["..."]}'
ads get-browser-list '{}'

代理管理,

ads create-proxy '[{"type":"http","host":"127.0.0.1","port":"8080"}]'
ads get-proxy-list '{}'
ads update-proxy '{"proxy_id":"proxy-1","proxy_url":"https://refresh.example.com"}'
ads delete-proxy '{"proxy_id":["..."]}'

指纹、Cookie、缓存,

ads new-fingerprint <profile_id>
ads get-profile-cookies <profile_id>
ads delete-cache-v2 '{"profile_id":["..."],"type":["cookie","history"]}'
ads get-profile-ua <profile_id>

分组和标签,

ads create-group '{"group_name":"My Group"}'
ads get-group-list '{}'
ads create-tag '{"tags":[{"name":"test","color":"darkBlue"}]}'

内核版本管理,

ads get-kernel-list '{"kernel_type":"Chrome"}'
ads download-kernel '{"kernel_type":"Chrome","kernel_version":"..."}'

所有命令的完整参数都可以通过 ads -hads <command> -h 查看。


这对日常业务有什么帮助

举几个实际的场景。

批量建号。以前在客户端里一个一个创建配置文件,现在写一个循环脚本,一次创建 50 个、100 个,每个自动分配不同的代理和分组。

定时维护。把指纹刷新、缓存清理这些操作写进定时任务,每天自动执行。不需要人盯着,跑在服务器上就行。

批量操作。一批账号需要统一换代理、统一移到新分组、统一刷新指纹,一条命令搞定,不用挨个点。

服务器部署。CLI 支持 Docker,

docker-compose -f ./docker-compose.yml up -d
docker-compose exec adspower-cli /bin/bash

进去之后直接用 ads 命令操作。没有图形界面的服务器环境也能完整使用 AdsPower 的能力。


也支持 AI 编程助手

CLI 所在的 GitHub 仓库同时提供了 AI 编程助手的 Skill 支持。一行命令装进 Cursor 等工具,

npx skills add AdsPower/adspower-browser

同时,GitHub 仓库里还集成了 MCP(Model Context Protocol)支持,Claude Code、Cursor、Codex、OpenCode 等 AI Agent 可以通过 MCP 直接操控 AdsPower 的浏览器实例。

装完之后 AI 编程助手会自动获得 AdsPower 的调用上下文,用自然语言描述你想做的事情,它就能生成对应的 CLI 命令。不熟悉命令行的用户也可以通过这种方式上手。

随着 AI Agent 在更多工作流中承担执行角色,浏览器作为 Agent 与网页交互的核心工具,也需要提供对应的接入能力。CLI、MCP、Skill 目前都已经可以使用。


相关链接

GitHub 文档(完整命令列表和参数说明)👉 github.com/AdsPower/adspower-browser/blob/main/packages/adspower-browser/README.MD

AdsPower 官网下载页(CLI 安装入口)👉 https://www.adspower.net/download

AdsPower

与AdsPower一起,开启多账号管理新篇章

AdsPower CLI 来了,不装客户端也能操控浏览器

人们还读过