Авито Реклама MCP

A1 Авито Реклама MCP 将 AI 应用连接到 Avito 广告账户。它可以帮助你检查广告系列和统计数据，管理组预算和出价，处理代理余额、访问权限和 ORD 文档——使用自然语言。

这不是 Avito 卖家 API：服务器不处理商品、消息、订单或卖家广告推广。它只处理 Avito 广告账户中的展示和效果广告系列。

• 25 个工具。 广告系列、广告组、创意、统计、余额、子账户、用户和 ORD 文档。

• 有限的广告系列修改。 API 只允许更改组预算和出价；不能创建、编辑、暂停或删除广告系列、广告组和创意。

• 不可逆操作可见。 转账或赠送、删除用户和技术 API 请求被标记为破坏性。

• 每周 API 预算。 每次调用消耗积分；服务器返回结果时附带 apiPointBalance 余额。

从一个只读取数据的请求开始：

显示我 Avito 账户的广告系列以及上周按广告组划分的支出。

连接服务器 · 查看场景 · 打开技术文档

一分钟了解工作方式

你： 显示我 Avito 账户的广告系列以及上周按广告组划分的支出。

助手： 显示广告系列、广告组、支出、点击和展示。不进行任何更改。

你： 准备将广告组 101 的出价改为 350 卢布。

助手： 显示账户、广告组、当前出价和新出价，然后请求确认。

你： 确认。

助手： 仅更改该广告组的出价。广告系列、创意和其他广告组不变。

Related MCP server: VK Ads MCP

目录

• 快速开始

• 可以委托什么

• 可能发生什么变化

• 获取访问权限

• 配置

• 数据、限制和后台工作

• 技术文档

• 支持

快速开始

需要 Node.js 20+、Client Key、Client Secret 和 Avito 广告账户 ID。要授予访问权限，需要账户管理员角色。

1. 获取访问权限。

2. 将服务器添加到 AI 应用。

3. 发送上面提到的安全第一个请求。

在 Settings → Plugins → MCP servers 中点击 Add server，然后添加 npx -y mcp-avito-ads@latest，并设置 AVITO_ADS_CLIENT_ID、AVITO_ADS_CLIENT_SECRET 和 AVITO_ADS_ACCOUNT_ID。

codex mcp add avito-ads \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  -- npx -y mcp-avito-ads@latest
codex mcp list

Codex MCP 文档

claude mcp add \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  --transport stdio --scope user avito-ads \
  -- npx -y mcp-avito-ads@latest
claude mcp list

Claude Code MCP 文档

打开 Settings → Developer → Edit Config 并添加：

{"mcpServers":{"avito-ads":{"command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"your_client_key","AVITO_ADS_CLIENT_SECRET":"your_client_secret","AVITO_ADS_ACCOUNT_ID":"your_account_id"}}}}

如果 Edit Config 不可用，请在 macOS 上编辑 ~/Library/Application Support/Claude/claude_desktop_config.json，或在 Windows 上编辑 %APPDATA%\Claude\claude_desktop_config.json。Claude Desktop MCP 文档

将 {"mcpServers":{"avito-ads":{"type":"stdio","command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"your_client_key","AVITO_ADS_CLIENT_SECRET":"your_client_secret","AVITO_ADS_ACCOUNT_ID":"your_account_id"}}}} 添加到 macOS/Linux 上的 ~/.cursor/mcp.json 或 Windows 上的 %USERPROFILE%\.cursor\mcp.json。Cursor MCP 文档

运行 MCP: Open User Configuration 并添加：

{"servers":{"avito-ads":{"type":"stdio","command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"${input:avito_client_id}","AVITO_ADS_CLIENT_SECRET":"${input:avito_client_secret}","AVITO_ADS_ACCOUNT_ID":"${input:avito_account_id}"}}},"inputs":[{"type":"promptString","id":"avito_client_id","description":"Avito Ads Client Key"},{"type":"promptString","id":"avito_client_secret","description":"Avito Ads Client Secret","password":true},{"type":"promptString","id":"avito_account_id","description":"ID рекламного аккаунта"}]}

使用 MCP: List Servers 命令检查服务器。VS Code MCP 文档

可以委托什么

• 显示广告系列、广告组、创意、状态和指定时期的统计。

• 按广告组和创意比较支出、CTR、CPM、CPC 或 VTR。

• 检查代理余额和子账户。

• 准备更改单个广告组的预算或出价。

• 创建广告主和 ORD 合同，先显示要传递的详细信息。

• 添加用户、更改其角色或在确认后撤销访问权限。

可能发生什么变化

无法通过此 API 创建、编辑、暂停、归档或删除广告系列、广告组和创意。创意和定向也不可写。

获取访问权限

1. 使用管理员角色打开 Avito 广告账户。

2. 创建 API 应用并复制 Client Key 和 Client Secret。

3. 复制广告账户 ID。

4. 将它们作为 AVITO_ADS_CLIENT_ID、AVITO_ADS_CLIENT_SECRET、AVITO_ADS_ACCOUNT_ID 传递。

服务器通过 OAuth2 client_credentials 获取 Bearer token。请将 Client Secret 当作密码保存。账户 ID 由配置指定：工具不会意外切换到其他账户。

要演练写入操作，可以设置 AVITO_ADS_ENVIRONMENT=sandbox。沙箱不是生产环境的完整副本：例如，其中没有余额。

配置

数据、限制和后台工作

• 每周积分预算。 积分在周一 00:00 UTC 补充。一份长达 100 天的长报告通常比一系列短报告更节省；服务器在每次结果中显示 apiPointBalance。

• 临时错误。 遇到 429 时，错误中会返回 Retry-After 和剩余积分。网络或 5xx 错误后不会重试写入，以免重复转账。

• 没有持续监控。 服务器仅在调用时运行。如果 AI 应用支持定时任务，它可以定期收集统计数据和积分余额。

• 匿名遥测。 不包含密钥、账户数据、参数和提示；可通过 ASKADS_TELEMETRY=0 关闭。

技术文档

• MCP 功能目录 — 每个工具的用户任务页面。

• 所有工具和参数

• 开发文档

• 发布文档

• 官方 Avito Ads SDK

支持

发现错误或缺少场景？创建 issue 或通过 Telegram 联系我们。