Avito Ads MCP

本地服务

github.com商业与营销14 周前更新

代码仓库访问官网

关于 Avito Ads MCP

Avito Ads MCP 将 AI 应用连接到 Avito Ads 广告账户，用于管理媒体和效果广告系列。它提供广告数据查询及部分账户操作，广告系列写入仅限修改广告组预算和出价。

主要功能

01查看广告系列、广告组和创意
02比较支出与效果指标
03查看代理商余额和子账户
04调整广告组预算或出价
05管理用户和 ORD 文档

适用场景

01查看指定时段的广告支出
02比较 CTR、CPM、CPC 或 VTR
03准备广告组出价变更并确认
04检查代理商余额和账户访问权限

MCP 相关

向 MCP 客户端提供 Avito Ads API 工具，可操作广告系列、广告组、创意、统计、余额、用户和 ORD 文档。广告系列写入仅限广告组预算和出价；还可进行账户权限和文档操作。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "a1-x-tech-mcp-avito-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-avito-ads"
      ],
      "env": {
        "AVITO_ADS_CLIENT_ID": "<AVITO_ADS_CLIENT_ID>",
        "AVITO_ADS_CLIENT_SECRET": "<AVITO_ADS_CLIENT_SECRET>",
        "AVITO_ADS_ACCOUNT_ID": "<AVITO_ADS_ACCOUNT_ID>",
        "AVITO_ADS_ENVIRONMENT": "<AVITO_ADS_ENVIRONMENT>",
        "AVITO_ADS_API_BASE": "<AVITO_ADS_API_BASE>",
        "AVITO_ADS_TIMEOUT_MS": "<AVITO_ADS_TIMEOUT_MS>",
        "AVITO_ADS_MAX_RETRIES": "<AVITO_ADS_MAX_RETRIES>",
        "AVITO_ADS_TOKEN_LEEWAY_SECONDS": "<AVITO_ADS_TOKEN_LEEWAY_SECONDS>"
      }
    }
  }
}

启动命令npx -y mcp-avito-ads

需要配置的环境变量

AVITO_ADS_CLIENT_ID密钥OAuth2 client id of your Avito application (grant_type=client_credentials).

AVITO_ADS_CLIENT_SECRET密钥OAuth2 client secret of your Avito application. Treat it as a secret.

AVITO_ADS_ACCOUNT_IDAd account id (positive integer) every request is scoped to.

AVITO_ADS_ENVIRONMENTWhich API to talk to: production or sandbox.

AVITO_ADS_API_BASEAPI root override, replacing host and environment prefix (e.g. a local mock).

AVITO_ADS_TIMEOUT_MSPer-request timeout in milliseconds.

AVITO_ADS_MAX_RETRIESRetries on 429 (always) and on 5xx / network errors for reads only.

AVITO_ADS_TOKEN_LEEWAY_SECONDS密钥Refresh the OAuth2 token this many seconds before it expires.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmcp-avito-ads1.2.0stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

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

A1 Авито Реклама MCP подключает AI-приложение к рекламному кабинету Авито Рекламы. Он помогает проверить кампании и статистику, управлять бюджетом и ставкой группы, работать с балансами агентства, доступами и документами ОРД — на естественном языке.

Это не API продавца Авито: сервер не работает с товарами, перепиской, заказами или продвижением объявлений продавца. Он работает только с медийными и performance-кампаниями рекламного кабинета Авито Рекламы.

25 инструментов. Кампании, группы, креативы, статистика, баланс, дочерние аккаунты, пользователи и документы ОРД.
Узкие изменения кампаний. API позволяет менять только бюджет и ставку группы; создавать, редактировать, ставить на паузу или удалять кампании, группы и креативы нельзя.
Необратимые операции видны. Перевод денег или бонусов, удаление пользователя и технический запрос API помечены как destructive.
Недельный бюджет API. Каждый вызов тратит баллы; остаток apiPointBalance сервер возвращает с результатом.

Начните с запроса, который только читает данные:

Покажи кампании моего аккаунта Авито и расход за прошлую неделю по группам объявлений.

Подключить сервер · Посмотреть сценарии · Открыть техническую документацию

Увидеть работу за минуту

Вы: Покажи кампании моего аккаунта Авито и расход за прошлую неделю по группам объявлений.

Ассистент: Показывает кампании, группы, расход, клики и показы. Ничего не меняется.

Вы: Подготовь изменение ставки группы 101 до 350 рублей.

Ассистент: Показывает аккаунт, группу, текущую и новую ставку, затем запрашивает подтверждение.

Вы: Подтверждаю.

Ассистент: Меняет ставку только этой группы. Кампания, креативы и другие группы не меняются.

快速开始

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

获取访问权限。
将服务添加到 AI 应用中。
发送上方的安全首个请求。

Codex

在 Settings → MCP servers 中点击 Add server，选择 STDIO，填写命令 npx -y mcp-avito-ads@latest 和环境变量 AVITO_ADS_CLIENT_ID、AVITO_ADS_CLIENT_SECRET 及 AVITO_ADS_ACCOUNT_ID，然后点击 Save，再点击 Restart。

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 Code

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 文档

Claude Desktop

目前官方推荐的方式是 Settings → Extensions。要安装自定义桌面扩展，请打开 Advanced settings → Extension Developer → Install Extension…，选择 .mcpb 文件并按提示操作。

此仓库目前发布的是 stdio npm 包，尚未包含 .mcpb。因此，仅在仍支持本地配置的 Claude Desktop 版本中，将下方的 JSON stdio 配置用作备用方案：

{"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"}}}}

在此类版本中，macOS 用户将其保存到 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 用户将其保存到 %APPDATA%\Claude\claude_desktop_config.json。

Claude Desktop MCP 文档

Cursor

在 macOS/Linux 上，将 {"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"}}}} 添加到 ~/.cursor/mcp.json；在 Windows 上，将其添加到 %USERPROFILE%\.cursor\mcp.json。Cursor MCP 文档

VS Code

运行 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 合同，先展示要提交的详细信息。
添加用户、更改其角色，或在确认后撤销其访问权限。

可能发生的变化

操作	操作结果	确认边界
广告系列、广告组、创意、统计数据、余额、用户和 ORD	读取账户数据	不会进行任何更改
广告组预算或出价	修改该广告组两个可用 API 字段之一	修改广告组
用户和角色	授予访问权限或更改角色	更改账户访问权限
广告主、合同、子账户或 sandbox 账户	创建新记录	不可逆地创建对象
转账或转移奖金、删除用户	更改余额或删除访问权限	具有破坏性且不可逆
Raw API request	`confirmWrite: true` 时可能会更改数据	可能具有破坏性

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

Получение доступа

Откройте кабинет Авито Рекламы пользователем с ролью администратора.
Создайте API-приложение и скопируйте Client Key и Client Secret.
Скопируйте ID рекламного аккаунта.
Передайте их как AVITO_ADS_CLIENT_ID, AVITO_ADS_CLIENT_SECRET, AVITO_ADS_ACCOUNT_ID.

Сервер получает Bearer token через OAuth2 client_credentials. Храните Client Secret как пароль. ID аккаунта задан конфигурацией: инструменты не смогут случайно перейти в другой аккаунт.

Для репетиции записей можно задать AVITO_ADS_ENVIRONMENT=sandbox. Песочница не является полной копией production: например, баланс там недоступен.

Настройка

Переменная	Обязательна	Описание
`AVITO_ADS_CLIENT_ID`	Да	Client Key API-приложения.
`AVITO_ADS_CLIENT_SECRET`	Да	Client Secret API-приложения.
`AVITO_ADS_ACCOUNT_ID`	Да	ID рекламного аккаунта.
`AVITO_ADS_ENVIRONMENT`	Нет	`production` или `sandbox`; по умолчанию `production`.
`AVITO_ADS_TIMEOUT_MS`	Нет	Тайм-аут запроса; по умолчанию `30000` мс.
`AVITO_ADS_MAX_RETRIES`	Нет	Повторы 429; по умолчанию `4`.

Данные, лимиты и работа в фоне

Недельный бюджет баллов. Баллы пополняются в понедельник в 00:00 UTC. Один длинный отчёт до 100 дней обычно экономнее серии коротких; сервер показывает apiPointBalance с каждым результатом.
Временные ошибки. При 429 в ошибке возвращаются Retry-After и остаток баллов. Записи не повторяются после сетевой или 5xx ошибки, чтобы не перевести деньги дважды.
Постоянного наблюдения нет. Сервер работает только при вызове. Если AI-приложение поддерживает задания по расписанию, оно может периодически собирать статистику и остаток баллов.
Анонимная телеметрия. В неё не попадают секреты, данные аккаунта, аргументы и промпты; отключение: ASKADS_TELEMETRY=0.