如何通过 AI 工具接入 AdsPower？

一、功能介绍

AdsPower 支持通过 AI 工具接入，实现浏览器环境的自动化管理。用户可以根据自身需求，选择 Skill、MCP 或 CLI 三种方式，将 AdsPower 与支持的 AI 工具连接，让 AI 协助完成浏览器环境打开、管理及自动化操作等任务。

目前提供以下三种接入方式：

可根据使用场景选择合适的接入方式，无需同时配置全部方式。

二、接入方式

方式一：通过 Skill 接入（推荐）

Skill 是较为简单的接入方式。通过在支持 Skill 的 AI 工具中安装 AdsPower Skill，即可让 AI 学习如何调用 AdsPower，实现浏览器环境管理。

1. 准备工作

安装前，请先下载、安装并运行 AdsPower 客户端，同时确保所使用的 AI 工具支持 Skill 安装。

2. 安装 AdsPower Skill

在支持 Skill 的 AI 工具中，执行以下命令：

npx skills add https://github.com/adspower/adspower-browser --skill adspower-browser

执行完成后，按照 AI 工具的提示完成安装，即可尝试通过 AI 操作 AdsPower。

3. 其他 AI 工具安装方式

OpenClaw

npx clawhub@latest install adspower-browser --force

Hermes Agent

hermes skills install https://github.com/AdsPower/adspower-browser/blob/main/skills/adspower-browser --force

不同 AI 工具的 Skill 安装方式可能存在差异，请根据实际使用的工具选择对应命令。

4. 使用说明

Skill 安装完成后，可尝试向 AI 工具发送操作指令，例如：

请帮我查看当前 AdsPower 中的浏览器环境，并打开指定的浏览器环境。

AI 将根据已安装的 Skill 能力尝试执行相关操作，具体支持的功能以 Skill 说明及实际运行结果为准。

方式二：通过 MCP 接入

MCP 接入适用于使用 Claude Code、Codex、Cursor 等 AI 工具的用户。完成 MCP 配置后，AI 可以通过本地接口调用 AdsPower，执行相关自动化操作。

1. 准备工作

请先安装并运行 AdsPower 客户端，确认本地 API 服务已正确配置，并准备好对应的 API Key。

2. 选择 AI 工具进行配置

说明：不同工具的 MCP 配置命令和 JSON 内容有所区别。请从 AdsPower 接入页面复制对应工具的完整配置，避免手动填写遗漏参数。

3. 验证 MCP 是否接入成功

配置完成后，重新加载或启动对应 AI 工具，检查 AdsPower MCP 服务是否正常连接。

连接成功后，可尝试向 AI 发送浏览器环境查询或打开指令，验证 AI 是否能够调用 AdsPower 本地接口。

方式三：通过 CLI 接入

CLI（命令行工具）适用于开发者或需要通过脚本管理浏览器环境的用户。

通过 CLI，可以使用命令行启动和管理 AdsPower 浏览器环境，方便接入自定义脚本及自动化工作流程。

CLI 支持独立运行，不依赖桌面客户端缓存。

1. Windows 系统

打开 PowerShell，执行以下命令：

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

2. macOS 系统

打开终端，执行以下命令：

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

3. Linux 系统

打开终端，执行以下命令：

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

4. 安装完成后

按照终端提示完成安装，并参考 CLI 命令文档了解具体使用方法。

如果命令执行失败，可以访问官方页面下载对应安装文件后在本地运行。

三、常见问题

Q1：三种接入方式有什么区别？

Skill 更适合希望通过 AI 对话完成操作的用户；MCP 适合希望在 AI 工具中调用 AdsPower 本地接口的用户；CLI 则适合通过命令行或脚本执行自动化操作的开发者。

Q2：使用 Skill 或 MCP 前，是否需要启动 AdsPower？

需要。使用 Skill 或 MCP 接入前，请先安装并运行 AdsPower 客户端。CLI 可独立运行，具体使用条件以对应命令文档为准。

Q3：安装 Skill 后，AI 是否就能自动操作浏览器？

Skill 安装完成后，AI 可以根据 Skill 提供的能力尝试执行 AdsPower 相关操作。实际执行效果取决于 AI 工具的支持情况、运行环境及相关权限配置。

Q4：MCP 连接失败怎么办？

建议检查 AdsPower 客户端是否正常运行、本地 API 服务是否可访问、端口及 API Key 是否配置正确，同时确认 AI 工具中的 MCP 服务配置是否完整。

Q5：CLI 安装命令执行失败怎么办？

请检查网络连接、终端权限及系统环境是否满足要求。如果在线安装失败，可尝试下载官方安装文件后手动运行。