Skip to main content
Glama
Yandex Direct MCP

Yandex Direct MCP

Яндекс Директ MCP

npm CI Glama License: MIT

Яндекс Директ MCP 将 AI 应用连接到 Яндекс Директ 广告账户。您可以用自然语言询问广告预算的去向,关联查看广告系列、广告组和关键词,然后直接在对话中准备或执行所需修改,无需在账户各板块之间切换。连接直接在对话中开始:无需提前创建令牌或编辑配置。

  • 44 个工具。 广告系列、广告组、广告、关键词、出价、调整、附加信息、统计、余额、参考手册以及直接在对话中连接账户。

  • 两种连接方式。 通过 URL 的远程服务器无需手动获取令牌,且只读取数据;通过 npx 的本地服务器可对账户进行完全访问。

  • 在聊天中连接。 Яндекс 会打开登录页面;从聊天中获取代码后即可立即操作广告,访问权限会自动续期。

  • 金额一目了然。 在便捷工具中,预算、出价和余额以账户货币显示,而非 API 的微单位。

  • 真实广告。 本地修改会应用到真实账户,可能影响实际花费。如需在测试环境中操作,可使用 Яндекс Директ 沙箱。

试试第一条消息:

显示我账户的广告系列以及上周按广告组统计的花费。

连接服务器 · 查看可执行的任务 · 打开技术文档


一分钟了解工作方式

您: 连接 Яндекс Директ。

助手: 提供 Яндекс 登录链接。请使用有权限访问目标广告账户的账号打开链接,确认授权后把显示的代码发给我。

您: 发送 Яндекс 页面上的代码。

助手: 连接 Директ 并显示账户。无需重启应用。

您: 显示我账户的广告系列以及上周按广告组统计的花费。

助手: 找到广告系列,按广告组生成报告,并以账户货币显示花费。

Related MCP server: Yandex MCP Server

目录

快速开始

  1. 选择连接方式,并按下方说明将服务器添加到 AI 应用。

  2. 打开新对话并询问:「显示我账户的广告系列以及上周按广告组统计的花费」。

无需自行获取令牌的分析 — 通过 URL

远程服务器 https://mcp.askads.ru/mcp 可通过支持按 URL 连接 MCP 的应用进行连接。在浏览器中登录 Яндекс 并确认授权:无需在配置中传递令牌。此模式仅用于读取 — 统计、审计和查看对象;不会修改广告设置。

在 Claude Code 中可通过以下命令添加:

claude mcp add --transport http yandex-direct https://mcp.askads.ru/mcp

连接后打开 /mcp 完成授权。在其他支持 HTTP MCP 的应用中,通过应用界面添加相同的 URL。

完全访问 — 通过 npx 本地运行

创建和修改对象需要 Node.js 20+。npx 会在首次运行时下载服务器 — 无需单独安装包。无需提前获取令牌 — 连接直接在对话中开始:

  1. 将服务器添加到 AI 应用 — 下方以 Codex 为例,其他应用收录在可折叠说明中。

  2. 输入:「连接 Яндекс Директ」— 助手会引导您完成 Яндекс 登录并显示账户。

用于 CI 和代理环境 — 使用现成令牌和 YANDEX_DIRECT_LOGIN,参见 连接与配置。

通过应用界面:

  1. 打开 Settings → Plugins → MCP servers。

  2. 点击 Add server。

  3. 添加启动命令 npx -y mcp-yandex-direct@latest。

通过命令行:

codex mcp add yandex-direct -- npx -y mcp-yandex-direct@latest

检查连接:

codex mcp list

Codex 官方说明

claude mcp add --transport stdio --scope user yandex-direct -- npx -y mcp-yandex-direct@latest

检查连接:claude mcp list。

打开 Settings → Developer → Edit Config,在 claude_desktop_config.json 中添加:

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-direct@latest"]
    }
  }
}

如果没有 Developer 部分,请手动打开文件:macOS — ~/Library/Application Support/Claude/claude_desktop_config.json,Windows — %APPDATA%\Claude\claude_desktop_config.json。重启 Claude Desktop。

打开 ~/.cursor/mcp.json 以在所有项目中连接服务器,或在特定项目中打开 .cursor/mcp.json。添加:

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-direct@latest"]
    }
  }
}

在命令面板中执行 MCP: Open User Configuration。在打开的 mcp.json 中添加服务器:

{
  "servers": {
    "yandex-direct": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-direct@latest"]
    }
  }
}

保存后执行 MCP: List Servers,并从列表启动服务器。

可以委托什么

检查预算花费情况

  • 「上周哪些广告系列花费最多?」

  • 「哪些广告获得了展示和点击,但没有产生转化?」

  • 「比较各广告系列一个月的花费、CTR 和平均点击价格」。

  • 「显示账户余额和 API 每日配额剩余量」。

寻找优化点

  • 「哪些关键词在消耗预算,但没有带来点击?」

  • 「哪些广告组和广告目前处于暂停状态或未通过审核?」

  • 「检查当前对移动设备生效的出价调整」。

  • 「这个广告系列有哪些快速链接和补充说明?」

准备修改

  • 「为高 CTR 的关键词建议新出价,并在应用前显示修改内容」。

  • 「检查广告系列中是否包含该主题的否定关键词,并准备列表」。

  • 「为莫斯科收集新文字广告系列的参数:预算、广告组、关键词和广告」。

执行明确操作

  • 「将以下关键词添加到广告组 123,并设置出价 45 ₽」。

  • 「暂停广告 456」。

  • 「将带图片的页面发送到广告库」。

工作原理

广告通常由三个层级构成:广告系列 → 广告组 → 广告。广告组中包含关键词、展示设置和出价调整。广告可以包含快速链接、补充说明、名片和图片。

服务器帮助您将这些对象关联起来查看:将广告系列的花费与广告组统计、关键词和广告关联。它只能创建文字类型的广告系列和广告。其他类型的广告系列可以读取、重命名、修改预算、暂停、归档和按 ID 删除。

统计数据并非即时生成:get_statistics 会在 Reports 服务中启动报告并等待其完成。大型列表由 autoPaginate 自动翻页获取。

哪些操作会修改数据

通过 URL 的远程服务器只读取数据。通过 npx 的本地服务器可以修改真实广告账户:

操作

具体内容

注意事项

读取统计和对象

服务器获取广告系列、广告、关键词、余额和报告。

这些调用不会修改数据,也不会产生费用。

创建

可以创建文字广告系列、广告组、文字广告、关键词、附加信息或上传图片。

如果未启用沙箱,新对象会进入真实账户。

更新

可以修改预算、出价、名称、否定关键词、广告组设置和出价调整。

修改出价和预算可能影响实际花费。

修改状态或删除

可以暂停、恢复、归档或删除部分对象。

删除和部分操作不可逆。

直接 API 请求

raw_request 可调用任何没有独立工具的 API 方法。

除读取外的任何方法都需要 confirmWrite=true;数据以微单位传递。

工具会向 AI 应用传递读取、写入和潜在不可逆操作的标记。应用可能会显示确认提示,但其行为取决于客户端。直接 API 请求在未设置 confirmWrite=true 时不会执行写入;修改广告需要明确的请求。

连接与配置

常规使用无需提前获取令牌:

  1. 在聊天中请求连接 Яндекс Директ。

  2. 打开 Яндекс OAuth 链接 使用有权限访问目标广告账户的账号。

  3. 确认授权,并将显示的代码发送到聊天中。完成,即可操作广告:无需重启客户端,也无需修改配置。

之后连接会自动维持:访问权限自动续期,不会一年后失效。检查状态 — 请求「显示连接状态」,断开 — 「断开 Директ」。已授予的权限可在 Яндекс ID 中撤销。

对于没有对话的 CI 和自动安装环境,可通过环境变量进行配置:

变量

用途

YANDEX_DIRECT_TOKEN

现成的 OAuth 令牌;优先于聊天登录。

YANDEX_DIRECT_LOGIN

通过代理账户操作时的客户登录名;否则 API 将显示代理机构的账户。

YANDEX_DIRECT_SANDBOX

true — 在 Яндекс Директ 测试环境(沙箱)中工作。

YANDEX_DIRECT_OAUTH_CLIENT_ID

自定义 OAuth 应用的 Client ID,替代内置应用。

YANDEX_DIRECT_LANG

API 响应语言;默认为 ru。

YANDEX_DIRECT_TIMEOUT_MS

请求超时;默认 60 000 毫秒。

YANDEX_DIRECT_MAX_RETRIES

临时错误时的重试次数;默认为 3。

可通过以下链接获取用于 YANDEX_DIRECT_TOKEN 的现成令牌,使用有权限访问目标账户的账号登录:

获取 Яндекс Директ 令牌

请勿在聊天、代码仓库和截图中发布令牌:它可以访问广告账户,包括可能影响预算的操作。

数据与遥测

默认情况下,服务器会发送匿名技术事件:随机安装标识符、所调用工具的名称、服务器、AI 应用、Node.js 和操作系统的版本。这是为了了解服务器的哪些部分被使用,以及启动时是否出现问题。Yandex 令牌、广告账户数据、工具参数、请求文本、环境变量的值和名称不会被发送。

要为 Ask Ads MCP 服务器禁用遥测,请设置环境变量:

ASKADS_TELEMETRY=0

限制

  • 每日 API 配额。 每次调用都会消耗 Units。get_quota 工具显示今天已消耗、剩余和可用的额度。

  • 报告限制。 Yandex 报告对每日数量和容量有自己的限制,而且需要等待 Reports 服务中的报告就绪。

  • 大列表。 如果在自动分页时达到内部限制,服务器会明确将结果标记为不完整,而不是隐藏这一点。

  • 临时错误。 在频率限制时,服务器最多重试三次。网络和服务器错误仅对只读操作自动重试,以避免重复更改。

  • 生产账户。 本地更改会应用到真实的广告账户,并可能影响支出。测试时请使用沙箱(YANDEX_DIRECT_SANDBOX=true)。

  • 无持续监控。 服务器仅在 AI 应用调用期间运行。如果应用支持定期任务,可以配置周期性请求来检查所需指标。

技术文档

支持

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

Available Tools

46 tools
ad_actionДействие с объявлениямиC
Destructive

Выполняет действие над объявлениями по id: moderate, suspend, resume, archive, unarchive или delete.

NameRequiredDescriptionDefault
idsYesId объявлений, к которым применить действие.
actionYes
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
add_bid_modifierДобавить корректировку ставокA

Добавляет корректировку ставок на кампанию или группу объявлений. Значения BidModifier — проценты по правилам API (например, 0–1300), а не деньги. API принимает в одном элементе BidModifiers только один тип корректировки, поэтому каждый переданный тип (mobile, desktop, demographics, retargeting, regional) уходит отдельным элементом в одном вызове bidmodifiers/add, в этом порядке. Каждая запись AddResults помечена полем Type (MOBILE_ADJUSTMENT, DESKTOP_ADJUSTMENT, DEMOGRAPHICS_ADJUSTMENT, RETARGETING_ADJUSTMENT, REGIONAL_ADJUSTMENT): типы создаются независимо, при частичной ошибке повторять только типы с Errors. Внутри одного типа (массивы demographics/retargeting/regional) API создаёт всё или ничего.

NameRequiredDescriptionDefault
mobileNoКорректировка для мобильных.
desktopNoКорректировка для десктопа.
regionalNoКорректировки по регионам.
adGroupIdNoId группы объявлений (либо это поле, либо campaignId).
campaignIdNoId кампании (либо это поле, либо adGroupId).
retargetingNoКорректировки по ретаргетингу.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
demographicsNoКорректировки по демографии.
add_calloutsДобавить уточненияA

Создаёт уточнения, до 25 символов каждое, не более 1000 за вызов. Уточнения неизменяемы — чтобы поменять, нужно удалить и создать заново. Привязка к объявлениям — через сервис Ads.

NameRequiredDescriptionDefault
textsYesТексты уточнений, до 25 символов каждый, не более 1000 за вызов.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
add_keywordsДобавить ключевые фразыB

Добавляет ключевые фразы в группу объявлений, при необходимости — со ставками для поиска и сетей.

NameRequiredDescriptionDefault
keywordsYesКлючевые фразы для добавления.
adGroupIdYesId группы объявлений.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
auth_statusСтатус подключения к ДиректуA
Read-onlyIdempotent

Показывает, подключён ли Яндекс Директ: есть ли токен, откуда он взят (переменная окружения YANDEX_DIRECT_TOKEN или сохранённый вход), когда истекает и где лежит файл с сохранёнными данными. Ничего не отправляет в сеть и не показывает сам токен. Вызовите это, если инструменты Директа отвечают, что подключение не настроено.

NameRequiredDescriptionDefault

No parameters

campaign_actionДействие с кампаниямиB
Destructive

Выполняет действие над кампаниями по id: suspend, resume, archive, unarchive или delete.

NameRequiredDescriptionDefault
idsYesId кампаний, к которым применить действие.
actionYes
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
clients_overviewСводка по клиентамA
Read-onlyIdempotent

Сводка по всем клиентам агентства и кабинетам в управлении за один вызов — для вопросов вроде «что у меня по аккаунтам в управлении»: по каждому клиенту баланс общего счёта и число кампаний по состояниям (on — идут или могут идти, suspended — остановлены пользователем, off — не идут по другой причине, ended) и статусам модерации (moderation, rejected, draft). Архивные кампании не считаются. Клиенты — из list_clients, либо явный список logins. Ошибка по одному клиенту (нет доступа, нет общего счёта) не прерывает остальных и попадает в его строку. С параметром stats добавляет показы, клики и расход (с НДС, в валюте клиента) за период — по одному отчёту Reports на клиента, строго по очереди: Яндекс пускает примерно один отчёт в 10 секунд, так что 30 клиентов — около 5 минут; клиенты без неархивных кампаний не запрашиваются, а кто не уложился в 5 минут, помечается statsSkipped. Без stats ответ приходит за секунды — запрашивать расход, только когда вопрос про деньги или трафик. Не вызывать list_campaigns по каждому клиенту в цикле — эта сводка дешевле. Тратит баллы API каждого клиента: один запрос кампаний на клиента и один запрос баланса на 50 клиентов у агентства (у обычного аккаунта — на каждого).

NameRequiredDescriptionDefault
limitNoСколько клиентов обойти, 1–200. По умолчанию 50.
statsNoДобавить показы, клики и расход за этот период. Медленно: около 10 с на клиента.
loginsNoТолько эти логины клиентов. По умолчанию — все из list_clients.
searchNoТолько клиенты, у которых логин или название содержит эту подстроку.
create_ad_groupСоздать группу объявленийB

Создаёт группу объявлений в кампании с заданными регионами показа.

NameRequiredDescriptionDefault
nameYesНазвание группы объявлений.
regionIdsYesId регионов показа, например [225] — Россия.
campaignIdYesId родительской кампании.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
create_text_adСоздать текстовое объявлениеA

Создаёт текстовое объявление (TextAd) в группе объявлений. Новые объявления создаются черновиками. TextAdAdd требует хотя бы одно из Href/TurboPageId/BusinessId — этот инструмент передаёт посадочную страницу через href (обязателен); объявление с BusinessId вместо ссылки создаётся через raw_request. Визитки (VCardId) Директ больше не поддерживает: контакты задаются организацией из Яндекс Бизнеса (BusinessId). Директ создаёт такие объявления комбинаторными (тип RESPONSIVE_AD), а Title2 объединяет с Title через «. », если вместе они короче 56 символов, иначе отбрасывает; о таких изменениях API сообщает предупреждениями.

NameRequiredDescriptionDefault
hrefYesURL посадочной страницы (обязателен для TextAdAdd).
textYesТекст объявления, до 81 символа.
titleYesЗаголовок (Title 1), до 56 символов.
mobileNoМобильное ли это объявление. Поле в API устарело (значение принудительно NO), но остаётся обязательным.
title2NoВторой заголовок (Title 2), до 30 символов.
adGroupIdYesId родительской группы объявлений.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
create_text_campaignСоздать текстовую кампаниюA

Создаёт кампанию TextCampaign (текстово-графические объявления). Без biddingStrategy применяются ручные ставки на поиске с отключёнными сетями (Search HIGHEST_POSITION, Network SERVING_OFF) — у ручных ставок текстовой кампании бюджета в API нет. Чтобы ограничить расход, включить автостратегию или сети, передать biddingStrategy целиком — {Search, Network}, недельный бюджет внутри него (WeeklySpendLimit в структуре параметров автостратегии). Дневного бюджета у Директа больше нет.

NameRequiredDescriptionDefault
nameYesНазвание кампании.
endDateNoДата окончания в формате YYYY-MM-DD.
startDateYesДата начала в формате YYYY-MM-DD.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
biddingStrategyNoПолный объект BiddingStrategy {Search, Network} в формате API, деньги (WeeklySpendLimit, BidCeiling, AverageCpc, AverageCpa, Cpa…) в валюте аккаунта. Заменяет значение по умолчанию.
dailyBudgetModeNoУстарело: дневного бюджета в Директе больше нет (с 30.11.2026) — вызов с этим параметром отклоняется. У текстовой кампании недельный бюджет есть только у автостратегий: передать biddingStrategy, например {Search: {BiddingStrategyType: "WB_MAXIMUM_CLICKS", WbMaximumClicks: {WeeklySpendLimit: <сумма>}}, Network: {BiddingStrategyType: "SERVING_OFF"}}. У ручных ставок (HIGHEST_POSITION) TextCampaign бюджета нет.
dailyBudgetAmountNoУстарело: дневного бюджета в Директе больше нет (с 30.11.2026) — вызов с этим параметром отклоняется. У текстовой кампании недельный бюджет есть только у автостратегий: передать biddingStrategy, например {Search: {BiddingStrategyType: "WB_MAXIMUM_CLICKS", WbMaximumClicks: {WeeklySpendLimit: <сумма>}}, Network: {BiddingStrategyType: "SERVING_OFF"}}. У ручных ставок (HIGHEST_POSITION) TextCampaign бюджета нет.
weeklyBudgetAmountNoУстарело: вызов с этим параметром отклоняется. У текстовой кампании недельный бюджет есть только у автостратегий: передать biddingStrategy, например {Search: {BiddingStrategyType: "WB_MAXIMUM_CLICKS", WbMaximumClicks: {WeeklySpendLimit: <сумма>}}, Network: {BiddingStrategyType: "SERVING_OFF"}}. У ручных ставок (HIGHEST_POSITION) TextCampaign бюджета нет.
delete_ad_groupsУдалить группы объявленийA
Destructive

Удаляет группы объявлений по id (adgroups/delete). Вместе с группой удаляются её объявления и ключевые фразы; отменить это нельзя.

NameRequiredDescriptionDefault
idsYesId групп, которые нужно удалить.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
delete_bid_modifiersУдалить корректировки ставокC
Destructive

Удаляет корректировки ставок по id (bidmodifiers/delete).

NameRequiredDescriptionDefault
idsYesId корректировок, которые нужно удалить.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
delete_calloutsУдалить уточненияC
Destructive

Удаляет уточнения по id (adextensions/delete).

NameRequiredDescriptionDefault
idsYesId уточнений, которые нужно удалить.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
finish_loginЗавершить подключение ДиректаA
Idempotent

Второй шаг подключения: обменивает код подтверждения из start_login на токен доступа, сохраняет его в файл только для владельца (0600) и сразу проверяет живым запросом к Директу. После успеха остальные инструменты работают немедленно — перезапускать клиент не нужно. Код одноразовый и живёт 10 минут: если он не принят, вызовите start_login заново и попросите свежий.

NameRequiredDescriptionDefault
codeYesКод подтверждения, который Яндекс показал пользователю после входа.
get_account_infoДанные аккаунтаB
Read-onlyIdempotent

Возвращает данные текущего аккаунта рекламодателя (логин, валюта, тип, страна) через сервис clients Яндекс Директа.

NameRequiredDescriptionDefault
fieldNamesNoКакие поля клиента вернуть. По умолчанию — типовой набор.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
get_ad_imagesИзображения объявленийA
Read-onlyIdempotent

Возвращает список изображений из библиотеки изображений, ключ — хеш изображения. Новые изображения загружает upload_ad_image.

NameRequiredDescriptionDefault
limitNoМаксимум объектов на страницу.
hashesNoФильтр по хешам изображений.
offsetNoСмещение постраничной выдачи.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
get_ad_videosВидео объявленийA
Read-onlyIdempotent

Читает видео из библиотеки видео по id (API требует id). Загрузка идёт через raw_request (advideos/add).

NameRequiredDescriptionDefault
idsYesId видео (обязательны по требованию API).
limitNoМаксимум объектов на страницу.
offsetNoСмещение постраничной выдачи.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
get_balanceБаланс аккаунтаA
Read-onlyIdempotent

Возвращает баланс общего счёта и финансовые поля (Amount, AmountAvailableForTransfer, Currency, Discount, AccountID) через устаревший сервис AccountManagement Live v4 — единственный API Яндекс Директа, который отдаёт баланс (в v5 финансового метода нет). Amount — строка в ВАЛЮТЕ АККАУНТА (не в микроединицах); отрицательный Amount означает задолженность. По умолчанию — собственный аккаунт токена, а при переданном client_login — счёт этого клиента; чтобы получить несколько общих счетов разом (агентство, до 50 логинов), передать logins.

NameRequiredDescriptionDefault
loginsNoЛогины аккаунтов, по которым нужны данные. По умолчанию — собственный аккаунт токена.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
get_bid_modifiersКорректировки ставокA
Read-onlyIdempotent

Читает корректировки ставок (мобильные, десктоп, демография, ретаргетинг, регионы, видео) для кампаний или групп объявлений. BidModifier — это процент, а не деньги.

NameRequiredDescriptionDefault
idsNoФильтр по id корректировок.
typesNoФильтр по типам корректировок.
levelsNoУровни, на которых читать. По умолчанию оба: CAMPAIGN и AD_GROUP.
adGroupIdsNoФильтр по id групп объявлений.
campaignIdsNoФильтр по id кампаний.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
get_calloutsУточненияB
Read-onlyIdempotent

Возвращает список уточнений из библиотеки adextensions. Привязать уточнение к объявлению можно через сервис Ads.

NameRequiredDescriptionDefault
idsNoФильтр по id уточнений.
limitNoМаксимум объектов на страницу.
offsetNoСмещение постраничной выдачи.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
get_creativesКреативыB
Read-onlyIdempotent

Возвращает список креативов (смарт-баннеры, HTML5) из библиотеки креативов.

NameRequiredDescriptionDefault
idsNoФильтр по id креативов.
limitNoМаксимум объектов на страницу.
offsetNoСмещение постраничной выдачи.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
get_dictionariesСправочникиA
Read-onlyIdempotent

Возвращает справочники Яндекс Директа (валюты, часовые пояса, константы, категории объявлений, …). GeoRegions может быть очень большим — для поиска регионов лучше get_regions.

NameRequiredDescriptionDefault
namesYesНазвания нужных справочников.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
get_quotaКвота APIA
Read-onlyIdempotent

Возвращает сегодняшнюю квоту баллов API (потрачено / осталось / лимит) из заголовка Units — чтобы не упереться в дневной лимит.

NameRequiredDescriptionDefault
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
get_regionsПоиск регионовA
Read-onlyIdempotent

Ищет id регионов для таргетинга (те самые regionIds, которые нужны create_ad_group). Фильтр — подстрока названия; количество результатов ограничено limit.

NameRequiredDescriptionDefault
limitNoМаксимум регионов в ответе. По умолчанию 50.
queryNoПодстрока названия региона без учёта регистра, например 'Москва' или 'Moscow'.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
get_statisticsСтатистикаA
Read-onlyIdempotent

Запрашивает отчёт по эффективности через сервис Reports Яндекс Директа. По умолчанию отчёт АГРЕГИРОВАН за весь период (одна строка на объект) — добавлять "Date" в fieldNames только для динамики по дням или вопросов о трендах. Почасовой статистики в Reports нет: минимум — сутки, внутридневную динамику дают только повторные снимки TODAY. Готового ROAS нет — считать Revenue / Cost; GoalsRoi — это ROI ((Revenue − Cost) / Cost), не ROAS. Revenue, Profit, GoalsRoi и конверсии заполняются только по целям Метрики с ценностью. ALL_TIME без фильтра по кампаниям отклоняется для отчётов SEARCH_QUERY/CRITERIA: нужно передать campaignIds или ограниченный период. SEARCH_QUERY_PERFORMANCE_REPORT возвращает не сырые строки, а ВЫЧИСЛЕННУЮ СВОДКУ (итоги по ВСЕМ строкам + детализация top-N + свёртка хвоста + количество строк без кликов и без конверсий); её форму задают sortBy/topN/minCost/queryContains/zeroClicksOnly/zeroConversionsOnly, а для подсчётов по конверсиям нужно добавить Conversions в fieldNames. Остальные типы отчётов возвращают строки, разделённые табуляцией (без заголовка). compareTo — сравнение двух периодов: инструмент запускает ДВЕ задачи Reports (текущий период dateFrom/dateTo и compareTo) и возвращает JSON, где строки сопоставлены по разрезам отчёта (matchKey; название кампании или группы не учитывается, если запрошен её id — переименование не ломает сопоставление), с current, previous, delta и deltaPct по каждой метрике. Это только значения Яндекса и их разность: вклад факторов (расход = показы × CTR × CPC) инструмент не считает — при объяснении изменений считать по колонкам ответа и называть порядок факторов. Последние ~3 дня статистики Яндекс может пересчитать.

NameRequiredDescriptionDefault
topNNoМаксимум строк детализации в сводке (на сервере ограничено 100). По умолчанию 50.
goalsNoId целей Яндекс Метрики (не более 10). Без них Conversions и Revenue считаются по всем целям кампании; с ними колонки приходят как <поле>_<idЦели>_<модель> (по одной на цель × модель). Для SEARCH_QUERY_PERFORMANCE_REPORT и compareTo сводка разбирает только одну цель и одну модель (ограничение инструмента, не API).
orderNoПорядок сортировки строк детализации. По умолчанию desc.
dateToNoДата окончания YYYY-MM-DD (обязательна для CUSTOM_DATE).
sortByNoМетрика для ранжирования строк детализации. По умолчанию Cost.
filtersNoПроизвольные условия SelectionCriteria.Filter, складываются с campaignIds по И. Например Clicks GREATER_THAN 0 или Device EQUALS MOBILE.
minCostNoВключать в детализацию только строки с Cost >= этого значения.
dateFromNoДата начала YYYY-MM-DD (обязательна для CUSTOM_DATE).
compareToNoПериод, с которым сравнить текущий (dateFrom/dateTo, обязательны). Лучше той же длины. Не для SEARCH_QUERY_PERFORMANCE_REPORT и не с Date/Week/Month/Quarter/Year в fieldNames. sortBy задаёт сортировку по |delta|, topN — сколько строк показать.
fieldNamesNoКолонки отчёта (должны быть допустимы для его типа). Сверх базовых метрик: Conversions, ConversionRate, CostPerConversion, Revenue, Profit, GoalsRoi. Разрезы CUSTOM_REPORT: Date, Device, Age, Gender, LocationOfPresenceName, Placement, AdNetworkType, Slot и др.
includeVatNoВключать ли НДС в расход. По умолчанию true.
reportTypeNoТип отчёта. По умолчанию CAMPAIGN_PERFORMANCE_REPORT.
campaignIdsNoОграничить отчёт этими id кампаний.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
dateRangeTypeNoПредустановленный период. Если заданы dateFrom/dateTo, подставляется CUSTOM_DATE.
queryContainsNoВключать только строки, где запрос или условие содержит эту подстроку (без учёта регистра).
zeroClicksOnlyNoВключать в детализацию только строки с 0 кликов.
attributionModelsNoМодели атрибуции для конверсий по целям из goals; без goals не применяются (API их тогда не принимает). По умолчанию LC (последний переход).
zeroConversionsOnlyNoТолько строки с clicks>0 и 0 конверсий (нужно Conversions в fieldNames).
keyword_actionДействие с ключевыми фразамиC
Destructive

Выполняет действие над ключевыми фразами по id: suspend, resume или delete.

NameRequiredDescriptionDefault
idsYesId ключевых фраз, к которым применить действие.
actionYes
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
list_ad_groupsСписок групп объявленийA
Read-onlyIdempotent

Возвращает список групп объявлений. Нужно передать campaignIds и/или ids — API Яндекс Директа требует хотя бы один критерий отбора.

NameRequiredDescriptionDefault
idsNoФильтр по id групп объявлений.
limitNoМаксимум объектов на страницу.
offsetNoСмещение постраничной выдачи (сколько объектов пропустить).
fieldNamesNoКакие поля группы вернуть.
campaignIdsNoФильтр по id кампаний.
autoPaginateNoЗабрать все страницы, идя по LimitedBy (limit тогда не ограничивает общий объём).
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
list_adsСписок объявленийA
Read-onlyIdempotent

Возвращает список объявлений. Нужно передать campaignIds, adGroupIds или ids — API Яндекс Директа требует хотя бы один из них; states и statuses только сужают выборку.

NameRequiredDescriptionDefault
idsNoФильтр по id объявлений.
limitNoМаксимум объектов на страницу.
offsetNoСмещение постраничной выдачи (сколько объектов пропустить).
statesNoФильтр по состояниям объявлений.
statusesNoФильтр по статусам модерации.
adGroupIdsNoФильтр по id групп объявлений.
fieldNamesNoКакие поля объявления вернуть. Тексты и ссылки (Title, Title2, Text, Href, …) приходят в объекте TextAd.
campaignIdsNoФильтр по id кампаний.
autoPaginateNoЗабрать все страницы, идя по LimitedBy (limit тогда не ограничивает общий объём).
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
list_campaignsСписок кампанийA
Read-onlyIdempotent

Возвращает список кампаний с необязательными фильтрами по id, типу, состоянию и статусу. Денежные поля (Funds общего счёта — Sum, Balance, SumAvailableForTransfer, Spend) отдаются в валюте аккаунта. Бюджет кампании — недельный (WeeklySpendLimit) и у ручных ставок, и у автостратегий; он лежит внутри BiddingStrategy и виден только при strategy: true (дневного бюджета DailyBudget у API больше нет). strategy: true добавляет блок TextCampaign/UnifiedCampaign со стратегией (BiddingStrategy), ключевыми целями (PriorityGoals), счётчиками Метрики, моделью атрибуции, пакетной стратегией и переносом бюджета (WeeklyBudgetRollover — сколько добавлено к недельному бюджету за счёт неиспользованного на прошлой неделе, до 30%; null — перенос не применяется или данных нет) — деньги в нём тоже в валюте аккаунта, а сам объект BiddingStrategy в этом виде принимает set_campaign_strategy.

NameRequiredDescriptionDefault
idsNoФильтр по id кампаний.
limitNoМаксимум объектов на страницу.
typesNoФильтр по типам кампаний.
offsetNoСмещение постраничной выдачи (сколько объектов пропустить).
statesNoФильтр по состояниям кампаний.
statusesNoФильтр по статусам модерации.
strategyNoВернуть стратегию показа и ключевые цели (блок TextCampaign или UnifiedCampaign).
fieldNamesNoКакие поля кампании вернуть. Стратегия здесь не запрашивается — для неё strategy: true.
autoPaginateNoЗабрать все страницы, идя по LimitedBy (limit тогда не ограничивает общий объём).
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
list_clientsКлиенты и кабинеты в управленииA
Read-onlyIdempotent

Перечисляет рекламодателей, с которыми может работать токен: клиентов агентства (AgencyClients.get) и кабинеты в управлении из YANDEX_DIRECT_CLIENTS. Логин из ответа передаётся в параметр client_login любого инструмента данных — так один сервер работает со всеми клиентами без перезапуска. accountType=agency — токен агентства: без client_login (и без YANDEX_DIRECT_LOGIN) инструменты видят собственный аккаунт агентства, где обычно нет кампаний. accountType=advertiser — обычный аккаунт: API не перечисляет кабинеты, где этот логин представитель, поэтому список есть только если его задали в YANDEX_DIRECT_CLIENTS. Архивные клиенты агентства по умолчанию скрыты. Сводка по всем клиентам сразу (баланс, кампании) — clients_overview.

NameRequiredDescriptionDefault
limitNoСколько клиентов вернуть, 1–1000. По умолчанию 200.
searchNoФильтр по подстроке логина или названия клиента, без учёта регистра.
includeArchivedNoПоказать и архивных клиентов агентства. По умолчанию — только активных.
list_keywordsСписок ключевых фразA
Read-onlyIdempotent

Возвращает список ключевых фраз. Нужно передать campaignIds, adGroupIds или ids — API Яндекс Директа требует хотя бы один из них. Bid и ContextBid отдаются в валюте аккаунта.

NameRequiredDescriptionDefault
idsNoФильтр по id ключевых фраз.
limitNoМаксимум объектов на страницу.
offsetNoСмещение постраничной выдачи (сколько объектов пропустить).
adGroupIdsNoФильтр по id групп объявлений.
fieldNamesNoКакие поля ключевой фразы вернуть.
campaignIdsNoФильтр по id кампаний.
autoPaginateNoЗабрать все страницы, идя по LimitedBy (limit тогда не ограничивает общий объём).
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
logoutОтключить ДиректA
Destructive

Удаляет сохранённый токен Директа с диска. Токен, заданный переменной окружения YANDEX_DIRECT_TOKEN, не трогает — его нужно убирать из конфигурации клиента вручную. Доступ, выданный приложению, остаётся активным на стороне Яндекса: отозвать его можно в Яндекс ID.

NameRequiredDescriptionDefault

No parameters

raw_requestПрямой вызов API Яндекс ДиректаA
Destructive

Универсальный запрос: вызывает напрямую любой сервис или метод API Яндекс Директа v5 (например service "bidmodifiers", method "get"). Нужен для сервисов, у которых нет отдельного инструмента. Деньги — в микроединицах (без конвертации). Методы чтения (get/has/check) выполняются свободно; любой другой метод считается записью и требует confirmWrite=true.

NameRequiredDescriptionDefault
methodYesМетод API, например get, add, update, delete, set, toggle, checkCampaigns.
paramsNoОбъект params для метода — как есть.
serviceYesПуть сервиса строчными буквами, например campaigns, bidmodifiers, sitelinks, adextensions, changes, keywordsresearch.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
confirmWriteNoДолжен быть true для запуска метода записи (всё, кроме get/has/check).
set_bid_modifiersИзменить корректировки ставокA
Idempotent

Меняет процент существующих корректировок (bidmodifiers/set) по id корректировки. BidModifierSetItem принимает только Id и BidModifier; включить/выключить корректировку через API нельзя (метод bidmodifiers/toggle устарел и не поддерживается) — чтобы отключить корректировку, удалить её через delete_bid_modifiers.

NameRequiredDescriptionDefault
bidsYesВ каждом элементе нужны id и percent.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
set_campaign_strategyИзменить стратегию кампанииA
Idempotent

Меняет стратегию показа (BiddingStrategy) текстовой кампании или ЕПК. Формат — объект API как есть, в том же виде, в каком его отдаёт list_campaigns с strategy: true, поэтому порядок такой: прочитать текущую стратегию, показать её пользователю, скопировать и поправить нужное поле. Сервер делает только три вещи: (1) одним campaigns.get узнаёт тип кампании и кладёт стратегию в TextCampaign или UnifiedCampaign; (2) переводит деньги из валюты аккаунта в микроединицы — WeeklySpendLimit, BidCeiling, AverageCpc, AverageCpa, Cpa, SpendLimit, MinimumExplorationBudget (Crr и BudgetIncreasePercent — проценты, не деньги); (3) возвращает previous — стратегию до изменения — рядом с UpdateResults. Больше ничего не дописывается и не проверяется: правила совместимости проверяет API и отвечает ошибкой по объекту. Бюджет кампании — недельный и задаётся только здесь: у автостратегий — WeeklySpendLimit в их структуре параметров, у ручных ставок ЕПК — {BiddingStrategyType: HIGHEST_POSITION, HighestPosition: {WeeklySpendLimit}}; у ручных ставок текстовой кампании бюджета нет (API отвечает 8000 на HighestPosition). Дневного бюджета (DailyBudget) у Директа больше нет. Передаются обе стороны, search и network. Внутри структуры параметров непереданные поля той же стратегии сохраняют текущие значения (проверено вживую на ЕПК). PriorityGoals, CounterIds и AttributionModel этим инструментом не меняются (raw_request). Правила API: автостратегия на поиске ⇒ в сетях только NETWORK_DEFAULT или SERVING_OFF; автостратегия в сетях ⇒ на поиске SERVING_OFF. Конверсионные стратегии требуют GoalId цели Метрики и счётчик на кампании; стратегии *_MULTIPLE_GOALS берут цели из PriorityGoals. Минимумы бюджета и ставок — get_dictionaries → Currencies. Смена типа стратегии перезапускает её обучение. Кампании других типов и кампании в пакетной стратегии — через raw_request.

NameRequiredDescriptionDefault
idYesId кампании.
searchYesСтратегия на поиске в формате API: {BiddingStrategyType, <Структура параметров>: {...}}, деньги в валюте аккаунта.
networkYesСтратегия в сетях в формате API: {BiddingStrategyType, <Структура параметров>: {...}}, деньги в валюте аккаунта.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
set_keyword_bidsЗадать ставки ключевых фразA
Idempotent

Задаёт ручные ставки на поиске и в сетях для ключевых фраз либо для всех фраз указанных групп объявлений или кампаний (keywordbids/set). Ставки — в валюте аккаунта. Тип цели один на весь вызов: все элементы bids используют только keywordId, только adGroupId или только campaignId; для целей разных типов нужны отдельные вызовы.

NameRequiredDescriptionDefault
bidsYesВ каждом элементе ровно один целевой id (keywordId, adGroupId или campaignId) и хотя бы одно из полей bid/contextBid. Тип id одинаков во всех элементах: смешивать keywordId, adGroupId и campaignId в одном вызове нельзя.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
start_loginНачать подключение ДиректаA
Read-onlyIdempotent

Первый шаг подключения Яндекс Директа без правки конфигурации и без перезапуска клиента. Возвращает ссылку на страницу Яндекс OAuth. Покажите ссылку пользователю целиком и попросите: открыть её в браузере под аккаунтом, у которого есть доступ к нужному рекламному кабинету, подтвердить доступ и прислать показанный код подтверждения. Полученный код передайте в finish_login. Код действует 10 минут. Сам по себе код бесполезен для постороннего: обменять его может только этот сервер.

NameRequiredDescriptionDefault

No parameters

update_ad_groupОбновить группу объявленийC
Idempotent

Обновляет название и/или регионы показа группы объявлений (adgroups/update).

NameRequiredDescriptionDefault
idYesId группы, которую нужно обновить.
nameNoНовое название группы.
regionIdsNoНовые id регионов показа.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
negativeKeywordsNoЗаменяет минус-фразы группы; пустой массив очищает их. Чтобы дописать или убрать отдельные фразы, не затирая список, — update_negative_keywords.
update_campaignОбновить кампаниюA
Idempotent

Обновляет название, дату окончания и/или минус-фразы кампании (campaigns/update). Бюджет здесь не меняется: у Директа он недельный и является частью стратегии — set_campaign_strategy (WeeklySpendLimit в структуре параметров автостратегии; у ручных ставок — HighestPosition: {WeeklySpendLimit}, только у ЕПК).

NameRequiredDescriptionDefault
idYesId кампании, которую нужно обновить.
nameNoНовое название кампании.
endDateNoНовая дата окончания в формате YYYY-MM-DD.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
dailyBudgetModeNoУстарело: дневного бюджета в Директе больше нет (с 30.11.2026) — вызов с этим параметром отклоняется. Менять бюджет — set_campaign_strategy (WeeklySpendLimit в структуре параметров автостратегии; у ручных ставок — HighestPosition: {WeeklySpendLimit}, только у ЕПК).
negativeKeywordsNoЗаменяет минус-фразы кампании; пустой массив очищает их. Чтобы дописать или убрать отдельные фразы, не затирая список, — update_negative_keywords.
dailyBudgetAmountNoУстарело: дневного бюджета в Директе больше нет (с 30.11.2026) — вызов с этим параметром отклоняется. Менять бюджет — set_campaign_strategy (WeeklySpendLimit в структуре параметров автостратегии; у ручных ставок — HighestPosition: {WeeklySpendLimit}, только у ЕПК).
update_excluded_sitesИзменить запрещённые площадкиA
Destructive

Меняет список площадок, где кампании запрещено показываться (ExcludedSites): сайты, мобильные приложения и внешние сети РСЯ. Действует только в сетях, на поиске площадки не запрещаются. API хранит список целиком и при записи заменяет его, поэтому действие задаётся явно:

  • add — дописать площадки к текущим. Инструмент читает текущий список (campaigns/get) и записывает объединённый (campaigns/update): два вызова API. Уже исключённые не дублируются.

  • remove — вернуть показы на указанных площадках. Тоже чтение + запись.

  • replace — записать ровно переданный список вместо текущего, без чтения. Пустой список здесь не принимается — для очистки есть clear.

  • clear — снять все запреты (отправляется null). Значения: домен без протокола (example.com — API сам уберёт www. и приведёт к нижнему регистру), id приложения Android/iOS в виде com.example.app (числовой id App Store вида id123456789 API отвергает), название внешней сети из get_dictionaries → SupplySidePlatforms (например BidSwitch). Значение площадки из отчёта get_statistics (поле Placement, строки с AdNetworkType=AD_NETWORK) передаётся как есть. Если add/remove ничего не меняют, записи нет (changed: false). Ответ: before/after — число площадок до и после, added/alreadyPresent или removed/notFound. Между чтением и записью нет блокировки: правка того же списка в интерфейсе в эту секунду будет перезаписана. Лимиты API: до 1000 площадок, до 255 символов в каждой. Текущий список — list_campaigns с fieldNames ["ExcludedSites"].

NameRequiredDescriptionDefault
sitesNoПлощадки: домены, id приложений, названия внешних сетей. Не передаётся для clear.
actionYesadd, remove, replace или clear — см. описание инструмента.
campaignIdYesId кампании.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
update_negative_keywordsИзменить минус-фразыA
Destructive

Меняет минус-фразы одной кампании или одной группы объявлений. API хранит список целиком и при записи заменяет его, поэтому действие задаётся явно:

  • add — дописать фразы к текущим. Инструмент читает текущий список (campaigns/get или adgroups/get) и записывает объединённый (update): два вызова API. Уже имеющиеся фразы не дублируются.

  • remove — убрать указанные фразы из текущего списка. Тоже чтение + запись.

  • replace — записать ровно переданный список вместо текущего, без чтения. Пустой список здесь не принимается — для очистки есть clear.

  • clear — удалить все минус-фразы (отправляется null). Фразы сравниваются без учёта регистра и лишних пробелов — так же склеивает их сам API; морфологию и порядок слов инструмент не учитывает. Если add/remove ничего не меняют, записи нет (changed: false). Ответ: before/after — число фраз до и после, added/alreadyPresent или removed/notFound — что именно произошло. Между чтением и записью нет блокировки: правка того же списка в интерфейсе в эту секунду будет перезаписана. Ограничения API: фраза без минуса в начале, до 7 слов, слово до 35 символов; суммарно до 20 000 символов на кампанию и 4096 на группу — нарушения API вернёт ошибкой по объекту. Минус-фразы кампании и группы действуют вместе.

NameRequiredDescriptionDefault
actionYesadd, remove, replace или clear — см. описание инструмента.
phrasesNoМинус-фразы без ведущего минуса, например ["бесплатно", "!скачать"]. Не передаётся для clear.
adGroupIdNoId группы объявлений (либо это поле, либо campaignId).
campaignIdNoId кампании (либо это поле, либо adGroupId).
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
update_text_adОбновить текстовое объявлениеA
Idempotent

Обновляет заголовок, текст или посадочную страницу текстового объявления (ads/update). Правка активного объявления отправляет его на повторную модерацию.

NameRequiredDescriptionDefault
idYesId объявления, которое нужно обновить.
hrefNoНовый URL посадочной страницы.
textNoНовый текст объявления, до 81 символа.
titleNoНовый заголовок (Title 1), до 56 символов.
title2NoНовый второй заголовок (Title 2), до 30 символов.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
upload_ad_imageЗагрузить изображениеA

Загружает изображение в библиотеку изображений (adimages/add) и возвращает его AdImageHash — этот хеш подставляется в поле AdImageHash текстово-графического объявления. Изображение передаётся публичным URL (сервер сам скачает и закодирует) или в base64 через imageData. Яндекс принимает JPG/PNG/GIF до 10 МБ; текстово-графическому объявлению нужна горизонтальная картинка (минимум 1080×607).

NameRequiredDescriptionDefault
urlNoПубличный URL изображения; сервер скачает его и закодирует в base64. Нужно передать это поле или imageData.
nameYesНазвание изображения в библиотеке.
imageDataNoБайты изображения в base64 (префикс data:-URL отбрасывается). Нужно передать это поле или url.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 3 tool updatesv1.13.1
    • Changedcreate_text_campaign4 fields changed
      • changedInput schema / properties / dailyBudgetAmount / description
        Previous value: -"Дневной бюджет в валюте аккаунта (конвертируется в микроединицы)."New value: +"Устарело: дневного бюджета в Директе больше нет (с 30.11.2026) — вызов с этим параметром отклоняется. У текстовой кампании недельный бюджет есть только у автостратегий: передать biddingStrategy, например {Search: {BiddingStrategyType: \"WB_MAXIMUM_CLICKS\", WbMaximumClicks: {WeeklySpendLimit: <сумма>}}, Network: {BiddingStrategyType: \"SERVING_OFF\"}}. У ручных ставок (HIGHEST_POSITION) TextCampaign бюджета нет."
      • removedInput schema / properties / dailyBudgetAmount / exclusiveMinimum
        Removed value: -0
      • changedInput schema / properties / dailyBudgetMode / description
        Previous value: -"Режим траты дневного бюджета: STANDARD — показы как можно быстрее, DISTRIBUTED — равномерно в течение дня. По умолчанию STANDARD."New value: +"Устарело: дневного бюджета в Директе больше нет (с 30.11.2026) — вызов с этим параметром отклоняется. У текстовой кампании недельный бюджет есть только у автостратегий: передать biddingStrategy, например {Search: {BiddingStrategyType: \"WB_MAXIMUM_CLICKS\", WbMaximumClicks: {WeeklySpendLimit: <сумма>}}, Network: {BiddingStrategyType: \"SERVING_OFF\"}}. У ручных ставок (HIGHEST_POSITION) TextCampaign бюджета нет."
      • addedInput schema / properties / weeklyBudgetAmount
        Added value: +{
        +  "description": "Устарело: вызов с этим параметром отклоняется. У текстовой кампании недельный бюджет есть только у автостратегий: передать biddingStrategy, например {Search: {BiddingStrategyType: \"WB_MAXIMUM_CLICKS\", WbMaximumClicks: {WeeklySpendLimit: <сумма>}}, Network: {BiddingStrategyType: \"SERVING_OFF\"}}. У ручных ставок (HIGHEST_POSITION) TextCampaign бюджета нет.",
        +  "type": "number"
        +}
    • Changedlist_campaigns1 field changed
      • changedInput schema / properties / fieldNames / items / enum
        Previous value: -[
        -  "BlockedIps",
        -  "ExcludedSites",
        -  "Currency",
        -  "DailyBudget",
        -  "Notification",
        -  "EndDate",
        -  "Funds",
        -  "ClientInfo",
        -  "Id",
        -  "Name",
        -  "NegativeKeywords",
        -  "RepresentedBy",
        -  "StartDate",
        -  "CreateTime",
        -  "Statistics",
        -  "State",
        -  "Status",
        -  "StatusPayment",
        -  "StatusClarification",
        -  "SourceId",
        -  "TimeTargeting",
        -  "TimeZone",
        -  "Type"
        -]New value: +[
        +  "BlockedIps",
        +  "ExcludedSites",
        +  "Currency",
        +  "Notification",
        +  "EndDate",
        +  "Funds",
        +  "ClientInfo",
        +  "Id",
        +  "Name",
        +  "NegativeKeywords",
        +  "RepresentedBy",
        +  "StartDate",
        +  "CreateTime",
        +  "Statistics",
        +  "State",
        +  "Status",
        +  "StatusPayment",
        +  "StatusClarification",
        +  "SourceId",
        +  "TimeTargeting",
        +  "TimeZone",
        +  "Type"
        +]
    • Changedupdate_campaign3 fields changed
      • changedInput schema / properties / dailyBudgetAmount / description
        Previous value: -"Дневной бюджет в валюте аккаунта."New value: +"Устарело: дневного бюджета в Директе больше нет (с 30.11.2026) — вызов с этим параметром отклоняется. Менять бюджет — set_campaign_strategy (WeeklySpendLimit в структуре параметров автостратегии; у ручных ставок — HighestPosition: {WeeklySpendLimit}, только у ЕПК)."
      • removedInput schema / properties / dailyBudgetAmount / exclusiveMinimum
        Removed value: -0
      • changedInput schema / properties / dailyBudgetMode / description
        Previous value: -"Режим траты дневного бюджета: STANDARD — показы как можно быстрее, DISTRIBUTED — равномерно в течение дня. Если не задан, сохраняется текущий режим кампании."New value: +"Устарело: дневного бюджета в Директе больше нет (с 30.11.2026) — вызов с этим параметром отклоняется. Менять бюджет — set_campaign_strategy (WeeklySpendLimit в структуре параметров автостратегии; у ручных ставок — HighestPosition: {WeeklySpendLimit}, только у ЕПК)."
  2. 8 tool updatesv1.12.1
    • Changedcreate_text_campaign1 field changed
      • changedInput schema / properties / biddingStrategy / description
        Previous value: -"Полный объект BiddingStrategy {Search, Network}. Заменяет значение по умолчанию."New value: +"Полный объект BiddingStrategy {Search, Network} в формате API, деньги (WeeklySpendLimit, BidCeiling, AverageCpc, AverageCpa, Cpa…) в валюте аккаунта. Заменяет значение по умолчанию."
    • Changedget_statistics3 fields changed
      • addedInput schema / properties / compareTo
        Added value: +{
        +  "additionalProperties": false,
        +  "description": "Период, с которым сравнить текущий (dateFrom/dateTo, обязательны). Лучше той же длины. Не для SEARCH_QUERY_PERFORMANCE_REPORT и не с Date/Week/Month/Quarter/Year в fieldNames. sortBy задаёт сортировку по |delta|, topN — сколько строк показать.",
        +  "properties": {
        +    "dateFrom": {
        +      "description": "Начало периода для сравнения, YYYY-MM-DD.",
        +      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
        +      "type": "string"
        +    },
        +    "dateTo": {
        +      "description": "Конец периода для сравнения, YYYY-MM-DD.",
        +      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
        +      "type": "string"
        +    }
        +  },
        +  "required": [
        +    "dateFrom",
        +    "dateTo"
        +  ],
        +  "type": "object"
        +}
      • addedInput schema / properties / fieldNames / items / enum
        Added value: +[
        +  "AdFormat",
        +  "AdGroupId",
        +  "AdGroupName",
        +  "AdId",
        +  "AdNetworkType",
        +  "Age",
        +  "AvgClickPosition",
        +  "AvgCpc",
        +  "AvgCpm",
        +  "AvgEffectiveBid",
        +  "AvgImpressionFrequency",
        +  "AvgImpressionPosition",
        +  "AvgPageviews",
        +  "AvgTrafficVolume",
        +  "AvgVideoCompleteCost",
        +  "BounceRate",
        +  "Bounces",
        +  "CampaignId",
        +  "CampaignName",
        +  "CampaignUrlPath",
        +  "CampaignType",
        +  "CarrierType",
        +  "Clicks",
        +  "ClickType",
        +  "ClientLogin",
        +  "ConversionRate",
        +  "Conversions",
        +  "Cost",
        +  "CostPerConversion",
        +  "CPV",
        +  "Criteria",
        +  "CriteriaId",
        +  "CriteriaType",
        +  "Criterion",
        +  "CriterionId",
        +  "CriterionType",
        +  "Ctr",
        +  "Date",
        +  "Device",
        +  "ExternalNetworkName",
        +  "Gender",
        +  "GoalsRoi",
        +  "ImpressionReach",
        +  "Impressions",
        +  "IncomeGrade",
        +  "LocationOfPresenceId",
        +  "LocationOfPresenceName",
        +  "MatchedKeyword",
        +  "MatchType",
        +  "MobilePlatform",
        +  "Month",
        +  "Placement",
        +  "Profit",
        +  "PurchaseRevenue",
        +  "PurchaseProfit",
        +  "PurchaseGoalsRoi",
        +  "Quarter",
        +  "Query",
        +  "Revenue",
        +  "RlAdjustmentId",
        +  "Sessions",
        +  "Slot",
        +  "TargetingCategory",
        +  "TargetingLocationId",
        +  "TargetingLocationName",
        +  "VideoComplete",
        +  "VideoCompleteRate",
        +  "VideoFirstQuartile",
        +  "VideoFirstQuartileRate",
        +  "VideoMidpoint",
        +  "VideoMidpointRate",
        +  "VideoThirdQuartile",
        +  "VideoThirdQuartileRate",
        +  "VideoViews",
        +  "VideoViewsRate",
        +  "Week",
        +  "WeightedCtr",
        +  "WeightedImpressions",
        +  "Year"
        +]
      • changedInput schema / properties / goals / description
        Previous value: -"Id целей Яндекс Метрики (не более 10). Без них Conversions и Revenue считаются по всем целям кампании; с ними колонки приходят как <поле>_<idЦели>_<модель> (по одной на цель × модель). Для SEARCH_QUERY_PERFORMANCE_REPORT — только одна цель и одна модель."New value: +"Id целей Яндекс Метрики (не более 10). Без них Conversions и Revenue считаются по всем целям кампании; с ними колонки приходят как <поле>_<idЦели>_<модель> (по одной на цель × модель). Для SEARCH_QUERY_PERFORMANCE_REPORT и compareTo сводка разбирает только одну цель и одну модель (ограничение инструмента, не API)."
    • Changedlist_campaigns2 fields changed
      • changedInput schema / properties / fieldNames / description
        Previous value: -"Какие поля кампании вернуть. Стратегии и настройки конкретного типа кампании здесь не запрашиваются."New value: +"Какие поля кампании вернуть. Стратегия здесь не запрашивается — для неё strategy: true."
      • addedInput schema / properties / strategy
        Added value: +{
        +  "description": "Вернуть стратегию показа и ключевые цели (блок TextCampaign или UnifiedCampaign).",
        +  "type": "boolean"
        +}
    • Addedset_campaign_strategy
    • Changedupdate_ad_group1 field changed
      • changedInput schema / properties / negativeKeywords / description
        Previous value: -"Заменяет минус-фразы группы; пустой массив очищает их."New value: +"Заменяет минус-фразы группы; пустой массив очищает их. Чтобы дописать или убрать отдельные фразы, не затирая список, — update_negative_keywords."
    • Changedupdate_campaign1 field changed
      • changedInput schema / properties / negativeKeywords / description
        Previous value: -"Заменяет минус-фразы кампании; пустой массив очищает их."New value: +"Заменяет минус-фразы кампании; пустой массив очищает их. Чтобы дописать или убрать отдельные фразы, не затирая список, — update_negative_keywords."
    • Addedupdate_excluded_sites
    • Addedupdate_negative_keywords
  3. 13 tool updatesv1.11.0
    • Changedadd_callouts2 fields changed
      • changedInput schema / properties / texts / description
        Previous value: -"Тексты уточнений, до 25 символов каждый."New value: +"Тексты уточнений, до 25 символов каждый, не более 1000 за вызов."
      • addedInput schema / properties / texts / maxItems
        Added value: +1000
    • Changedcreate_sitelinks_set6 fields changed
      • changedInput schema / properties / sitelinks / items / properties / description / description
        Previous value: -"Описание быстрой ссылки (для некоторых типов объявлений)."New value: +"Описание быстрой ссылки, до 60 символов (показывается в расширенном формате объявления)."
      • addedInput schema / properties / sitelinks / items / properties / description / maxLength
        Added value: +60
      • changedInput schema / properties / sitelinks / items / properties / href / description
        Previous value: -"URL быстрой ссылки."New value: +"URL быстрой ссылки с протоколом и доменом, до 1024 символов."
      • addedInput schema / properties / sitelinks / items / properties / href / maxLength
        Added value: +1024
      • changedInput schema / properties / sitelinks / items / properties / title / description
        Previous value: -"Текст быстрой ссылки."New value: +"Текст быстрой ссылки, до 30 символов."
      • addedInput schema / properties / sitelinks / items / properties / title / maxLength
        Added value: +30
    • Removedcreate_vcard
    • Removeddelete_vcards
    • Changedget_account_info1 field changed
      • addedInput schema / properties / fieldNames / items / enum
        Added value: +[
        +  "AccountQuality",
        +  "Archived",
        +  "ClientId",
        +  "ClientInfo",
        +  "CountryId",
        +  "CreatedAt",
        +  "Currency",
        +  "Grants",
        +  "Bonuses",
        +  "Login",
        +  "Notification",
        +  "OverdraftSumAvailable",
        +  "Phone",
        +  "Representatives",
        +  "Restrictions",
        +  "Settings",
        +  "Type",
        +  "Subtype",
        +  "VatRate",
        +  "ManagedLogins",
        +  "ForbiddenPlatform",
        +  "AvailableCampaignTypes",
        +  "AvailableAdGroupTypes",
        +  "ProductMode"
        +]
    • Changedget_statistics1 field changed
      • changedInput schema / properties / attributionModels / description
        Previous value: -"Модели атрибуции для конверсий. По умолчанию LC (последний переход)."New value: +"Модели атрибуции для конверсий по целям из goals; без goals не применяются (API их тогда не принимает). По умолчанию LC (последний переход)."
    • Removedget_vcards
    • Changedlist_ad_groups1 field changed
      • addedInput schema / properties / fieldNames / items / enum
        Added value: +[
        +  "Id",
        +  "CampaignId",
        +  "Status",
        +  "Name",
        +  "RegionIds",
        +  "RestrictedRegionIds",
        +  "NegativeKeywords",
        +  "NegativeKeywordSharedSetIds",
        +  "Type",
        +  "TrackingParams",
        +  "Subtype",
        +  "ServingStatus"
        +]
    • Changedlist_ads2 fields changed
      • changedInput schema / properties / fieldNames / description
        Previous value: -"Какие поля объявления вернуть."New value: +"Какие поля объявления вернуть. Тексты и ссылки (Title, Title2, Text, Href, …) приходят в объекте TextAd."
      • addedInput schema / properties / fieldNames / items / enum
        Added value: +[
        +  "AdCategories",
        +  "AgeLabel",
        +  "AdGroupId",
        +  "CampaignId",
        +  "Id",
        +  "State",
        +  "Status",
        +  "StatusClarification",
        +  "Type",
        +  "Subtype",
        +  "Title",
        +  "Title2",
        +  "Text",
        +  "Href",
        +  "FinalUrl",
        +  "DisplayDomain",
        +  "DisplayUrlPath",
        +  "Mobile",
        +  "SitelinkSetId",
        +  "VCardId",
        +  "AdImageHash",
        +  "AdExtensions",
        +  "TurboPageId",
        +  "BusinessId",
        +  "ErirAdDescription"
        +]
    • Changedlist_campaigns2 fields changed
      • changedInput schema / properties / fieldNames / description
        Previous value: -"Какие поля кампании вернуть."New value: +"Какие поля кампании вернуть. Стратегии и настройки конкретного типа кампании здесь не запрашиваются."
      • addedInput schema / properties / fieldNames / items / enum
        Added value: +[
        +  "BlockedIps",
        +  "ExcludedSites",
        +  "Currency",
        +  "DailyBudget",
        +  "Notification",
        +  "EndDate",
        +  "Funds",
        +  "ClientInfo",
        +  "Id",
        +  "Name",
        +  "NegativeKeywords",
        +  "RepresentedBy",
        +  "StartDate",
        +  "CreateTime",
        +  "Statistics",
        +  "State",
        +  "Status",
        +  "StatusPayment",
        +  "StatusClarification",
        +  "SourceId",
        +  "TimeTargeting",
        +  "TimeZone",
        +  "Type"
        +]
    • Changedlist_keywords1 field changed
      • addedInput schema / properties / fieldNames / items / enum
        Added value: +[
        +  "Id",
        +  "Keyword",
        +  "State",
        +  "Status",
        +  "AdGroupId",
        +  "CampaignId",
        +  "Bid",
        +  "AutotargetingSearchBidIsAuto",
        +  "ContextBid",
        +  "StrategyPriority",
        +  "UserParam1",
        +  "UserParam2",
        +  "Productivity",
        +  "StatisticsSearch",
        +  "StatisticsNetwork",
        +  "ServingStatus",
        +  "AutotargetingCategories",
        +  "AutotargetingBrandOptions",
        +  "AutotargetingMode",
        +  "AutotargetingBrief",
        +  "AutotargetingBriefSuggests"
        +]
    • Changedraw_request1 field changed
      • changedInput schema / properties / service / description
        Previous value: -"Путь сервиса строчными буквами, например campaigns, bidmodifiers, sitelinks, vcards, changes, keywordsresearch."New value: +"Путь сервиса строчными буквами, например campaigns, bidmodifiers, sitelinks, adextensions, changes, keywordsresearch."
    • Changedset_keyword_bids1 field changed
      • changedInput schema / properties / bids / description
        Previous value: -"В каждом элементе нужен один целевой id и хотя бы одно из полей bid/contextBid."New value: +"В каждом элементе ровно один целевой id (keywordId, adGroupId или campaignId) и хотя бы одно из полей bid/contextBid. Тип id одинаков во всех элементах: смешивать keywordId, adGroupId и campaignId в одном вызове нельзя."
  4. 1 tool updatev1.5.2
    • Changedget_statistics6 fields changed
      • addedInput schema / properties / attributionModels
        Added value: +{
        +  "description": "Модели атрибуции для конверсий. По умолчанию LC (последний переход).",
        +  "items": {
        +    "enum": [
        +      "FCCD",
        +      "LC",
        +      "LSCCD",
        +      "AUTO"
        +    ],
        +    "type": "string"
        +  },
        +  "minItems": 1,
        +  "type": "array"
        +}
      • changedInput schema / properties / dateRangeType / enum
        Previous value: -[
        -  "TODAY",
        -  "YESTERDAY",
        -  "LAST_7_DAYS",
        -  "LAST_30_DAYS",
        -  "THIS_MONTH",
        -  "LAST_MONTH",
        -  "ALL_TIME",
        -  "CUSTOM_DATE"
        -]New value: +[
        +  "TODAY",
        +  "YESTERDAY",
        +  "LAST_3_DAYS",
        +  "LAST_5_DAYS",
        +  "LAST_7_DAYS",
        +  "LAST_14_DAYS",
        +  "LAST_30_DAYS",
        +  "LAST_90_DAYS",
        +  "LAST_365_DAYS",
        +  "THIS_WEEK_MON_TODAY",
        +  "THIS_WEEK_SUN_TODAY",
        +  "LAST_WEEK",
        +  "LAST_BUSINESS_WEEK",
        +  "LAST_WEEK_SUN_SAT",
        +  "THIS_MONTH",
        +  "LAST_MONTH",
        +  "ALL_TIME",
        +  "CUSTOM_DATE",
        +  "AUTO"
        +]
      • changedInput schema / properties / fieldNames / description
        Previous value: -"Колонки отчёта (должны быть допустимы для его типа)."New value: +"Колонки отчёта (должны быть допустимы для его типа). Сверх базовых метрик: Conversions, ConversionRate, CostPerConversion, Revenue, Profit, GoalsRoi. Разрезы CUSTOM_REPORT: Date, Device, Age, Gender, LocationOfPresenceName, Placement, AdNetworkType, Slot и др."
      • addedInput schema / properties / filters
        Added value: +{
        +  "description": "Произвольные условия SelectionCriteria.Filter, складываются с campaignIds по И. Например Clicks GREATER_THAN 0 или Device EQUALS MOBILE.",
        +  "items": {
        +    "additionalProperties": false,
        +    "properties": {
        +      "field": {
        +        "description": "Поле для фильтрации (должно быть допустимо для типа отчёта).",
        +        "type": "string"
        +      },
        +      "operator": {
        +        "description": "Оператор сравнения.",
        +        "enum": [
        +          "EQUALS",
        +          "NOT_EQUALS",
        +          "IN",
        +          "NOT_IN",
        +          "LESS_THAN",
        +          "GREATER_THAN",
        +          "STARTS_WITH_IGNORE_CASE",
        +          "DOES_NOT_START_WITH_IGNORE_CASE",
        +          "STARTS_WITH_ANY_IGNORE_CASE",
        +          "DOES_NOT_START_WITH_ALL_IGNORE_CASE"
        +        ],
        +        "type": "string"
        +      },
        +      "values": {
        +        "description": "Значения; числа передавать строками, деньги — в валюте аккаунта.",
        +        "items": {
        +          "type": "string"
        +        },
        +        "minItems": 1,
        +        "type": "array"
        +      }
        +    },
        +    "required": [
        +      "field",
        +      "operator",
        +      "values"
        +    ],
        +    "type": "object"
        +  },
        +  "type": "array"
        +}
      • addedInput schema / properties / goals
        Added value: +{
        +  "description": "Id целей Яндекс Метрики (не более 10). Без них Conversions и Revenue считаются по всем целям кампании; с ними колонки приходят как <поле>_<idЦели>_<модель> (по одной на цель × модель). Для SEARCH_QUERY_PERFORMANCE_REPORT — только одна цель и одна модель.",
        +  "items": {
        +    "type": "string"
        +  },
        +  "maxItems": 10,
        +  "minItems": 1,
        +  "type": "array"
        +}
      • changedInput schema / properties / reportType / enum
        Previous value: -[
        -  "ACCOUNT_PERFORMANCE_REPORT",
        -  "CAMPAIGN_PERFORMANCE_REPORT",
        -  "ADGROUP_PERFORMANCE_REPORT",
        -  "AD_PERFORMANCE_REPORT",
        -  "CRITERIA_PERFORMANCE_REPORT",
        -  "SEARCH_QUERY_PERFORMANCE_REPORT"
        -]New value: +[
        +  "ACCOUNT_PERFORMANCE_REPORT",
        +  "CAMPAIGN_PERFORMANCE_REPORT",
        +  "ADGROUP_PERFORMANCE_REPORT",
        +  "AD_PERFORMANCE_REPORT",
        +  "CRITERIA_PERFORMANCE_REPORT",
        +  "SEARCH_QUERY_PERFORMANCE_REPORT",
        +  "CUSTOM_REPORT"
        +]
  5. 42 tool updatesv1.6.0
    • Changedad_action1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedadd_bid_modifier1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedadd_callouts1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedadd_keywords1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedcampaign_action1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Addedclients_overview
    • Changedcreate_ad_group1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedcreate_sitelinks_set1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedcreate_text_ad1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedcreate_text_campaign1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedcreate_vcard1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changeddelete_ad_groups1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changeddelete_bid_modifiers1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changeddelete_callouts1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changeddelete_sitelinks1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changeddelete_vcards1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedget_account_info1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedget_ad_images1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedget_ad_videos1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedget_balance1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedget_bid_modifiers1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedget_callouts1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedget_creatives1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedget_dictionaries1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedget_quota2 fields changed
      • addedInput schema / additionalProperties
        Added value: +false
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedget_regions1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedget_sitelinks1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedget_statistics1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedget_vcards1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedkeyword_action1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedlist_ad_groups1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedlist_ads1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedlist_campaigns1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Addedlist_clients
    • Changedlist_keywords1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedraw_request1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedset_bid_modifiers1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedset_keyword_bids1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedupdate_ad_group1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedupdate_campaign1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedupdate_text_ad1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
    • Changedupload_ad_image1 field changed
      • addedInput schema / properties / client_login
        Added value: +{
        +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
        +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
        +  "type": "string"
        +}
  6. 43 tool updatesv1.5.1
    • Changedad_action1 field changed
      • changedInput schema / properties / ids / description
        Previous value: -"Ad ids to act on."New value: +"Id объявлений, к которым применить действие."
    • Changedadd_bid_modifier9 fields changed
      • changedInput schema / properties / adGroupId / description
        Previous value: -"Target ad group id (use this OR campaignId)."New value: +"Id группы объявлений (либо это поле, либо campaignId)."
      • changedInput schema / properties / campaignId / description
        Previous value: -"Target campaign id (use this OR adGroupId)."New value: +"Id кампании (либо это поле, либо adGroupId)."
      • changedInput schema / properties / demographics / description
        Previous value: -"Demographic bid adjustments."New value: +"Корректировки по демографии."
      • changedInput schema / properties / desktop / description
        Previous value: -"Desktop bid adjustment."New value: +"Корректировка для десктопа."
      • changedInput schema / properties / mobile / description
        Previous value: -"Mobile bid adjustment."New value: +"Корректировка для мобильных."
      • changedInput schema / properties / mobile / properties / os / description
        Previous value: -"Limit to IOS or ANDROID."New value: +"Ограничить IOS или ANDROID."
      • changedInput schema / properties / mobile / properties / percent / description
        Previous value: -"Adjustment percent."New value: +"Процент корректировки."
      • changedInput schema / properties / regional / description
        Previous value: -"Regional bid adjustments."New value: +"Корректировки по регионам."
      • changedInput schema / properties / retargeting / description
        Previous value: -"Retargeting bid adjustments."New value: +"Корректировки по ретаргетингу."
    • Changedadd_callouts1 field changed
      • changedInput schema / properties / texts / description
        Previous value: -"Callout texts, up to 25 characters each."New value: +"Тексты уточнений, до 25 символов каждый."
    • Changedadd_keywords5 fields changed
      • changedInput schema / properties / adGroupId / description
        Previous value: -"Target ad group id."New value: +"Id группы объявлений."
      • changedInput schema / properties / keywords / description
        Previous value: -"Keywords to add."New value: +"Ключевые фразы для добавления."
      • changedInput schema / properties / keywords / items / properties / bid / description
        Previous value: -"Search bid in currency units."New value: +"Ставка на поиске в валюте аккаунта."
      • changedInput schema / properties / keywords / items / properties / contextBid / description
        Previous value: -"Network bid in currency units."New value: +"Ставка в сетях в валюте аккаунта."
      • changedInput schema / properties / keywords / items / properties / keyword / description
        Previous value: -"Keyword phrase, with operators if needed."New value: +"Ключевая фраза, при необходимости с операторами."
    • Addedauth_status
    • Changedcampaign_action1 field changed
      • changedInput schema / properties / ids / description
        Previous value: -"Campaign ids to act on."New value: +"Id кампаний, к которым применить действие."
    • Changedcreate_ad_group3 fields changed
      • changedInput schema / properties / campaignId / description
        Previous value: -"Parent campaign id."New value: +"Id родительской кампании."
      • changedInput schema / properties / name / description
        Previous value: -"Ad group name."New value: +"Название группы объявлений."
      • changedInput schema / properties / regionIds / description
        Previous value: -"Target geo region ids, e.g. [225] for Russia."New value: +"Id регионов показа, например [225] — Россия."
    • Changedcreate_sitelinks_set4 fields changed
      • changedInput schema / properties / sitelinks / description
        Previous value: -"1–8 sitelinks."New value: +"От 1 до 8 быстрых ссылок."
      • changedInput schema / properties / sitelinks / items / properties / description / description
        Previous value: -"Sitelink description (for some ad types)."New value: +"Описание быстрой ссылки (для некоторых типов объявлений)."
      • changedInput schema / properties / sitelinks / items / properties / href / description
        Previous value: -"Sitelink URL."New value: +"URL быстрой ссылки."
      • changedInput schema / properties / sitelinks / items / properties / title / description
        Previous value: -"Sitelink title."New value: +"Текст быстрой ссылки."
    • Changedcreate_text_ad9 fields changed
      • changedInput schema / properties / adGroupId / description
        Previous value: -"Parent ad group id."New value: +"Id родительской группы объявлений."
      • changedInput schema / properties / href / description
        Previous value: -"Landing page URL."New value: +"URL посадочной страницы (обязателен для TextAdAdd)."
      • addedInput schema / properties / href / minLength
        Added value: +1
      • addedInput schema / properties / mobile / default
        Added value: +false
      • changedInput schema / properties / mobile / description
        Previous value: -"Whether this is a mobile ad."New value: +"Мобильное ли это объявление. Поле в API устарело (значение принудительно NO), но остаётся обязательным."
      • changedInput schema / properties / text / description
        Previous value: -"Ad body text, up to 81 characters."New value: +"Текст объявления, до 81 символа."
      • changedInput schema / properties / title / description
        Previous value: -"Title (Title 1), up to 56 characters."New value: +"Заголовок (Title 1), до 56 символов."
      • changedInput schema / properties / title2 / description
        Previous value: -"Second title (Title 2), up to 30 characters."New value: +"Второй заголовок (Title 2), до 30 символов."
      • changedInput schema / required
        Previous value: -[
        -  "adGroupId",
        -  "title",
        -  "text"
        -]New value: +[
        +  "adGroupId",
        +  "title",
        +  "text",
        +  "href"
        +]
    • Changedcreate_text_campaign6 fields changed
      • changedInput schema / properties / biddingStrategy / description
        Previous value: -"Full BiddingStrategy object {Search, Network}. Overrides the default."New value: +"Полный объект BiddingStrategy {Search, Network}. Заменяет значение по умолчанию."
      • changedInput schema / properties / dailyBudgetAmount / description
        Previous value: -"Daily budget in account currency units (converted to micros)."New value: +"Дневной бюджет в валюте аккаунта (конвертируется в микроединицы)."
      • addedInput schema / properties / dailyBudgetMode / description
        Added value: +"Режим траты дневного бюджета: STANDARD — показы как можно быстрее, DISTRIBUTED — равномерно в течение дня. По умолчанию STANDARD."
      • changedInput schema / properties / endDate / description
        Previous value: -"End date, format YYYY-MM-DD."New value: +"Дата окончания в формате YYYY-MM-DD."
      • changedInput schema / properties / name / description
        Previous value: -"Campaign name."New value: +"Название кампании."
      • changedInput schema / properties / startDate / description
        Previous value: -"Start date, format YYYY-MM-DD."New value: +"Дата начала в формате YYYY-MM-DD."
    • Changedcreate_vcard12 fields changed
      • changedInput schema / properties / campaignId / description
        Previous value: -"Campaign the vCard belongs to."New value: +"Кампания, к которой относится визитка."
      • changedInput schema / properties / city / description
        Previous value: -"City, e.g. Москва."New value: +"Город, например Москва."
      • changedInput schema / properties / companyName / description
        Previous value: -"Company name."New value: +"Название организации."
      • changedInput schema / properties / country / description
        Previous value: -"Country, e.g. Россия."New value: +"Страна, например Россия."
      • changedInput schema / properties / extraMessage / description
        Previous value: -"Additional info shown on the card."New value: +"Дополнительная информация на визитке."
      • changedInput schema / properties / ogrn / description
        Previous value: -"OGRN registration number."New value: +"ОГРН."
      • changedInput schema / properties / phone / description
        Previous value: -"Contact phone."New value: +"Контактный телефон."
      • changedInput schema / properties / phone / properties / cityCode / description
        Previous value: -"City/operator code, e.g. \"495\"."New value: +"Код города или оператора, например \"495\"."
      • changedInput schema / properties / phone / properties / countryCode / description
        Previous value: -"Country code, e.g. \"+7\"."New value: +"Код страны, например \"+7\"."
      • changedInput schema / properties / phone / properties / extension / description
        Previous value: -"Extension, if any."New value: +"Добавочный номер, если есть."
      • changedInput schema / properties / phone / properties / phoneNumber / description
        Previous value: -"Local number."New value: +"Местный номер."
      • changedInput schema / properties / workTime / description
        Previous value: -"Work time in API format, e.g. \"1#5#9#00#18#00\" = Mon–Fri 09:00–18:00."New value: +"Время работы в формате API, например \"1#5#9#00#18#00\" — пн–пт 09:00–18:00."
    • Changeddelete_ad_groups1 field changed
      • changedInput schema / properties / ids / description
        Previous value: -"Ad group ids to delete."New value: +"Id групп, которые нужно удалить."
    • Changeddelete_bid_modifiers1 field changed
      • changedInput schema / properties / ids / description
        Previous value: -"Bid modifier ids to delete."New value: +"Id корректировок, которые нужно удалить."
    • Changeddelete_callouts1 field changed
      • changedInput schema / properties / ids / description
        Previous value: -"Callout ids to delete."New value: +"Id уточнений, которые нужно удалить."
    • Changeddelete_sitelinks1 field changed
      • changedInput schema / properties / ids / description
        Previous value: -"Sitelink set ids to delete."New value: +"Id наборов, которые нужно удалить."
    • Changeddelete_vcards1 field changed
      • changedInput schema / properties / ids / description
        Previous value: -"vCard ids to delete."New value: +"Id визиток, которые нужно удалить."
    • Addedfinish_login
    • Changedget_account_info1 field changed
      • changedInput schema / properties / fieldNames / description
        Previous value: -"Client fields to return. Defaults to a common set."New value: +"Какие поля клиента вернуть. По умолчанию — типовой набор."
    • Changedget_ad_images3 fields changed
      • changedInput schema / properties / hashes / description
        Previous value: -"Filter by image hashes."New value: +"Фильтр по хешам изображений."
      • changedInput schema / properties / limit / description
        Previous value: -"Max objects per page."New value: +"Максимум объектов на страницу."
      • changedInput schema / properties / offset / description
        Previous value: -"Pagination offset."New value: +"Смещение постраничной выдачи."
    • Changedget_ad_videos3 fields changed
      • changedInput schema / properties / ids / description
        Previous value: -"Video ids (required by the API)."New value: +"Id видео (обязательны по требованию API)."
      • changedInput schema / properties / limit / description
        Previous value: -"Max objects per page."New value: +"Максимум объектов на страницу."
      • changedInput schema / properties / offset / description
        Previous value: -"Pagination offset."New value: +"Смещение постраничной выдачи."
    • Changedget_balance1 field changed
      • changedInput schema / properties / logins / description
        Previous value: -"Account logins to fetch. Defaults to the token's own account."New value: +"Логины аккаунтов, по которым нужны данные. По умолчанию — собственный аккаунт токена."
    • Changedget_bid_modifiers5 fields changed
      • changedInput schema / properties / adGroupIds / description
        Previous value: -"Filter by ad group ids."New value: +"Фильтр по id групп объявлений."
      • changedInput schema / properties / campaignIds / description
        Previous value: -"Filter by campaign ids."New value: +"Фильтр по id кампаний."
      • changedInput schema / properties / ids / description
        Previous value: -"Filter by bid modifier ids."New value: +"Фильтр по id корректировок."
      • changedInput schema / properties / levels / description
        Previous value: -"Levels to read. Defaults to both CAMPAIGN and AD_GROUP."New value: +"Уровни, на которых читать. По умолчанию оба: CAMPAIGN и AD_GROUP."
      • changedInput schema / properties / types / description
        Previous value: -"Filter by adjustment types."New value: +"Фильтр по типам корректировок."
    • Changedget_callouts3 fields changed
      • changedInput schema / properties / ids / description
        Previous value: -"Filter by callout ids."New value: +"Фильтр по id уточнений."
      • changedInput schema / properties / limit / description
        Previous value: -"Max objects per page."New value: +"Максимум объектов на страницу."
      • changedInput schema / properties / offset / description
        Previous value: -"Pagination offset."New value: +"Смещение постраничной выдачи."
    • Changedget_creatives3 fields changed
      • changedInput schema / properties / ids / description
        Previous value: -"Filter by creative ids."New value: +"Фильтр по id креативов."
      • changedInput schema / properties / limit / description
        Previous value: -"Max objects per page."New value: +"Максимум объектов на страницу."
      • changedInput schema / properties / offset / description
        Previous value: -"Pagination offset."New value: +"Смещение постраничной выдачи."
    • Changedget_dictionaries1 field changed
      • changedInput schema / properties / names / description
        Previous value: -"Dictionary names to fetch."New value: +"Названия нужных справочников."
    • Changedget_regions2 fields changed
      • changedInput schema / properties / limit / description
        Previous value: -"Max regions to return. Default 50."New value: +"Максимум регионов в ответе. По умолчанию 50."
      • changedInput schema / properties / query / description
        Previous value: -"Case-insensitive substring of the region name, e.g. 'Москва' or 'Moscow'."New value: +"Подстрока названия региона без учёта регистра, например 'Москва' или 'Moscow'."
    • Changedget_sitelinks3 fields changed
      • changedInput schema / properties / ids / description
        Previous value: -"Sitelink set ids (required by the API)."New value: +"Id наборов быстрых ссылок (обязательны по требованию API)."
      • changedInput schema / properties / limit / description
        Previous value: -"Max objects per page."New value: +"Максимум объектов на страницу."
      • changedInput schema / properties / offset / description
        Previous value: -"Pagination offset."New value: +"Смещение постраничной выдачи."
    • Changedget_statistics14 fields changed
      • changedInput schema / properties / campaignIds / description
        Previous value: -"Limit the report to these campaign ids."New value: +"Ограничить отчёт этими id кампаний."
      • changedInput schema / properties / dateFrom / description
        Previous value: -"Start date YYYY-MM-DD (required for CUSTOM_DATE)."New value: +"Дата начала YYYY-MM-DD (обязательна для CUSTOM_DATE)."
      • changedInput schema / properties / dateRangeType / description
        Previous value: -"Predefined date range. Inferred as CUSTOM_DATE when dateFrom/dateTo are given."New value: +"Предустановленный период. Если заданы dateFrom/dateTo, подставляется CUSTOM_DATE."
      • changedInput schema / properties / dateTo / description
        Previous value: -"End date YYYY-MM-DD (required for CUSTOM_DATE)."New value: +"Дата окончания YYYY-MM-DD (обязательна для CUSTOM_DATE)."
      • changedInput schema / properties / fieldNames / description
        Previous value: -"Report columns (must be valid for the report type)."New value: +"Колонки отчёта (должны быть допустимы для его типа)."
      • changedInput schema / properties / includeVat / description
        Previous value: -"Whether costs include VAT. Default true."New value: +"Включать ли НДС в расход. По умолчанию true."
      • changedInput schema / properties / minCost / description
        Previous value: -"Only include rows with Cost >= this in the detail list."New value: +"Включать в детализацию только строки с Cost >= этого значения."
      • changedInput schema / properties / order / description
        Previous value: -"Sort order for detail rows. Default desc."New value: +"Порядок сортировки строк детализации. По умолчанию desc."
      • changedInput schema / properties / queryContains / description
        Previous value: -"Only include rows whose query/criterion contains this substring (case-insensitive)."New value: +"Включать только строки, где запрос или условие содержит эту подстроку (без учёта регистра)."
      • changedInput schema / properties / reportType / description
        Previous value: -"Report type. Default CAMPAIGN_PERFORMANCE_REPORT."New value: +"Тип отчёта. По умолчанию CAMPAIGN_PERFORMANCE_REPORT."
      • changedInput schema / properties / sortBy / description
        Previous value: -"Metric to rank the detail rows by. Default Cost."New value: +"Метрика для ранжирования строк детализации. По умолчанию Cost."
      • changedInput schema / properties / topN / description
        Previous value: -"Max detail rows in the summary (server-capped at 100). Default 50."New value: +"Максимум строк детализации в сводке (на сервере ограничено 100). По умолчанию 50."
      • changedInput schema / properties / zeroClicksOnly / description
        Previous value: -"Only include rows with 0 clicks in the detail list."New value: +"Включать в детализацию только строки с 0 кликов."
      • changedInput schema / properties / zeroConversionsOnly / description
        Previous value: -"Only rows with clicks>0 and 0 conversions (needs Conversions in fieldNames)."New value: +"Только строки с clicks>0 и 0 конверсий (нужно Conversions в fieldNames)."
    • Changedget_vcards3 fields changed
      • changedInput schema / properties / ids / description
        Previous value: -"vCard ids (required by the API)."New value: +"Id визиток (обязательны по требованию API)."
      • changedInput schema / properties / limit / description
        Previous value: -"Max objects per page."New value: +"Максимум объектов на страницу."
      • changedInput schema / properties / offset / description
        Previous value: -"Pagination offset."New value: +"Смещение постраничной выдачи."
    • Changedkeyword_action1 field changed
      • changedInput schema / properties / ids / description
        Previous value: -"Keyword ids to act on."New value: +"Id ключевых фраз, к которым применить действие."
    • Changedlist_ad_groups6 fields changed
      • changedInput schema / properties / autoPaginate / description
        Previous value: -"Fetch all pages by following LimitedBy (ignores limit as a total cap)."New value: +"Забрать все страницы, идя по LimitedBy (limit тогда не ограничивает общий объём)."
      • changedInput schema / properties / campaignIds / description
        Previous value: -"Filter by campaign ids."New value: +"Фильтр по id кампаний."
      • changedInput schema / properties / fieldNames / description
        Previous value: -"Ad group fields to return."New value: +"Какие поля группы вернуть."
      • changedInput schema / properties / ids / description
        Previous value: -"Filter by ad group ids."New value: +"Фильтр по id групп объявлений."
      • changedInput schema / properties / limit / description
        Previous value: -"Max objects per page."New value: +"Максимум объектов на страницу."
      • changedInput schema / properties / offset / description
        Previous value: -"Pagination offset (objects to skip)."New value: +"Смещение постраничной выдачи (сколько объектов пропустить)."
    • Changedlist_ads9 fields changed
      • changedInput schema / properties / adGroupIds / description
        Previous value: -"Filter by ad group ids."New value: +"Фильтр по id групп объявлений."
      • changedInput schema / properties / autoPaginate / description
        Previous value: -"Fetch all pages by following LimitedBy (ignores limit as a total cap)."New value: +"Забрать все страницы, идя по LimitedBy (limit тогда не ограничивает общий объём)."
      • changedInput schema / properties / campaignIds / description
        Previous value: -"Filter by campaign ids."New value: +"Фильтр по id кампаний."
      • changedInput schema / properties / fieldNames / description
        Previous value: -"Ad fields to return."New value: +"Какие поля объявления вернуть."
      • changedInput schema / properties / ids / description
        Previous value: -"Filter by ad ids."New value: +"Фильтр по id объявлений."
      • changedInput schema / properties / limit / description
        Previous value: -"Max objects per page."New value: +"Максимум объектов на страницу."
      • changedInput schema / properties / offset / description
        Previous value: -"Pagination offset (objects to skip)."New value: +"Смещение постраничной выдачи (сколько объектов пропустить)."
      • changedInput schema / properties / states / description
        Previous value: -"Filter by ad states."New value: +"Фильтр по состояниям объявлений."
      • changedInput schema / properties / statuses / description
        Previous value: -"Filter by moderation statuses."New value: +"Фильтр по статусам модерации."
    • Changedlist_campaigns8 fields changed
      • changedInput schema / properties / autoPaginate / description
        Previous value: -"Fetch all pages by following LimitedBy (ignores limit as a total cap)."New value: +"Забрать все страницы, идя по LimitedBy (limit тогда не ограничивает общий объём)."
      • changedInput schema / properties / fieldNames / description
        Previous value: -"Campaign fields to return."New value: +"Какие поля кампании вернуть."
      • changedInput schema / properties / ids / description
        Previous value: -"Filter by campaign ids."New value: +"Фильтр по id кампаний."
      • changedInput schema / properties / limit / description
        Previous value: -"Max objects per page."New value: +"Максимум объектов на страницу."
      • changedInput schema / properties / offset / description
        Previous value: -"Pagination offset (objects to skip)."New value: +"Смещение постраничной выдачи (сколько объектов пропустить)."
      • changedInput schema / properties / states / description
        Previous value: -"Filter by campaign states."New value: +"Фильтр по состояниям кампаний."
      • changedInput schema / properties / statuses / description
        Previous value: -"Filter by moderation statuses."New value: +"Фильтр по статусам модерации."
      • changedInput schema / properties / types / description
        Previous value: -"Filter by campaign types."New value: +"Фильтр по типам кампаний."
    • Changedlist_keywords7 fields changed
      • changedInput schema / properties / adGroupIds / description
        Previous value: -"Filter by ad group ids."New value: +"Фильтр по id групп объявлений."
      • changedInput schema / properties / autoPaginate / description
        Previous value: -"Fetch all pages by following LimitedBy (ignores limit as a total cap)."New value: +"Забрать все страницы, идя по LimitedBy (limit тогда не ограничивает общий объём)."
      • changedInput schema / properties / campaignIds / description
        Previous value: -"Filter by campaign ids."New value: +"Фильтр по id кампаний."
      • changedInput schema / properties / fieldNames / description
        Previous value: -"Keyword fields to return."New value: +"Какие поля ключевой фразы вернуть."
      • changedInput schema / properties / ids / description
        Previous value: -"Filter by keyword ids."New value: +"Фильтр по id ключевых фраз."
      • changedInput schema / properties / limit / description
        Previous value: -"Max objects per page."New value: +"Максимум объектов на страницу."
      • changedInput schema / properties / offset / description
        Previous value: -"Pagination offset (objects to skip)."New value: +"Смещение постраничной выдачи (сколько объектов пропустить)."
    • Addedlogout
    • Changedraw_request4 fields changed
      • changedInput schema / properties / confirmWrite / description
        Previous value: -"Must be true to run a write method (anything other than get/has/check)."New value: +"Должен быть true для запуска метода записи (всё, кроме get/has/check)."
      • changedInput schema / properties / method / description
        Previous value: -"API method, e.g. get, add, update, delete, set, toggle, checkCampaigns."New value: +"Метод API, например get, add, update, delete, set, toggle, checkCampaigns."
      • changedInput schema / properties / params / description
        Previous value: -"Raw params object for the method."New value: +"Объект params для метода — как есть."
      • changedInput schema / properties / service / description
        Previous value: -"Lowercase service path, e.g. campaigns, bidmodifiers, sitelinks, vcards, changes, keywordsresearch."New value: +"Путь сервиса строчными буквами, например campaigns, bidmodifiers, sitelinks, vcards, changes, keywordsresearch."
    • Changedset_bid_modifiers5 fields changed
      • changedInput schema / properties / bids / description
        Previous value: -"Each item needs an id and at least one of percent/enabled."New value: +"В каждом элементе нужны id и percent."
      • removedInput schema / properties / bids / items / properties / enabled
        Removed value: -{
        -  "description": "Enable or disable the adjustment.",
        -  "type": "boolean"
        -}
      • changedInput schema / properties / bids / items / properties / id / description
        Previous value: -"Bid modifier id."New value: +"Id корректировки."
      • changedInput schema / properties / bids / items / properties / percent / description
        Previous value: -"New adjustment percent."New value: +"Новый процент корректировки."
      • changedInput schema / properties / bids / items / required
        Previous value: -[
        -  "id"
        -]New value: +[
        +  "id",
        +  "percent"
        +]
    • Changedset_keyword_bids6 fields changed
      • changedInput schema / properties / bids / description
        Previous value: -"Each item needs one target id and at least one of bid/contextBid."New value: +"В каждом элементе нужен один целевой id и хотя бы одно из полей bid/contextBid."
      • changedInput schema / properties / bids / items / properties / adGroupId / description
        Previous value: -"Target all keywords in an ad group."New value: +"Применить ко всем фразам группы объявлений."
      • changedInput schema / properties / bids / items / properties / bid / description
        Previous value: -"Search bid in currency units."New value: +"Ставка на поиске в валюте аккаунта."
      • changedInput schema / properties / bids / items / properties / campaignId / description
        Previous value: -"Target all keywords in a campaign."New value: +"Применить ко всем фразам кампании."
      • changedInput schema / properties / bids / items / properties / contextBid / description
        Previous value: -"Network bid in currency units."New value: +"Ставка в сетях в валюте аккаунта."
      • changedInput schema / properties / bids / items / properties / keywordId / description
        Previous value: -"Target a single keyword."New value: +"Применить к одной ключевой фразе."
    • Addedstart_login
    • Changedupdate_ad_group4 fields changed
      • changedInput schema / properties / id / description
        Previous value: -"Ad group id to update."New value: +"Id группы, которую нужно обновить."
      • changedInput schema / properties / name / description
        Previous value: -"New ad group name."New value: +"Новое название группы."
      • changedInput schema / properties / negativeKeywords / description
        Previous value: -"Replace the ad group's negative keywords; pass an empty array to clear them."New value: +"Заменяет минус-фразы группы; пустой массив очищает их."
      • changedInput schema / properties / regionIds / description
        Previous value: -"New target geo region ids."New value: +"Новые id регионов показа."
    • Changedupdate_campaign6 fields changed
      • changedInput schema / properties / dailyBudgetAmount / description
        Previous value: -"Daily budget in account currency units."New value: +"Дневной бюджет в валюте аккаунта."
      • addedInput schema / properties / dailyBudgetMode / description
        Added value: +"Режим траты дневного бюджета: STANDARD — показы как можно быстрее, DISTRIBUTED — равномерно в течение дня. Если не задан, сохраняется текущий режим кампании."
      • changedInput schema / properties / endDate / description
        Previous value: -"New end date, format YYYY-MM-DD."New value: +"Новая дата окончания в формате YYYY-MM-DD."
      • changedInput schema / properties / id / description
        Previous value: -"Campaign id to update."New value: +"Id кампании, которую нужно обновить."
      • changedInput schema / properties / name / description
        Previous value: -"New campaign name."New value: +"Новое название кампании."
      • changedInput schema / properties / negativeKeywords / description
        Previous value: -"Replace the campaign's negative keywords; pass an empty array to clear them."New value: +"Заменяет минус-фразы кампании; пустой массив очищает их."
    • Changedupdate_text_ad5 fields changed
      • changedInput schema / properties / href / description
        Previous value: -"New landing page URL."New value: +"Новый URL посадочной страницы."
      • changedInput schema / properties / id / description
        Previous value: -"Ad id to update."New value: +"Id объявления, которое нужно обновить."
      • changedInput schema / properties / text / description
        Previous value: -"New body text, up to 81 characters."New value: +"Новый текст объявления, до 81 символа."
      • changedInput schema / properties / title / description
        Previous value: -"New Title (Title 1), up to 56 characters."New value: +"Новый заголовок (Title 1), до 56 символов."
      • changedInput schema / properties / title2 / description
        Previous value: -"New second title (Title 2), up to 30 characters."New value: +"Новый второй заголовок (Title 2), до 30 символов."
    • Changedupload_ad_image3 fields changed
      • changedInput schema / properties / imageData / description
        Previous value: -"Base64-encoded image bytes (a data: URL prefix is stripped). Provide this or url."New value: +"Байты изображения в base64 (префикс data:-URL отбрасывается). Нужно передать это поле или url."
      • changedInput schema / properties / name / description
        Previous value: -"Image name shown in the library."New value: +"Название изображения в библиотеке."
      • changedInput schema / properties / url / description
        Previous value: -"Public image URL; fetched and base64-encoded server-side. Provide this or imageData."New value: +"Публичный URL изображения; сервер скачает его и закодирует в base64. Нужно передать это поле или imageData."
  7. 9 tool updatesv0.1.1
    • Changedget_ad_images1 field changed
      • changedInput schema / properties / limit / maximum
        Previous value: -10000New value: +1000
    • Changedget_ad_videos1 field changed
      • changedInput schema / properties / limit / maximum
        Previous value: -10000New value: +1000
    • Addedget_balance
    • Changedget_callouts1 field changed
      • changedInput schema / properties / limit / maximum
        Previous value: -10000New value: +1000
    • Changedget_creatives1 field changed
      • changedInput schema / properties / limit / maximum
        Previous value: -10000New value: +1000
    • Changedget_sitelinks1 field changed
      • changedInput schema / properties / limit / maximum
        Previous value: -10000New value: +1000
    • Changedget_statistics3 fields changed
      • removedInput schema / properties / dateTo / $ref
        Removed value: -"#/properties/dateFrom"
      • addedInput schema / properties / dateTo / pattern
        Added value: +"^\\d{4}-\\d{2}-\\d{2}$"
      • addedInput schema / properties / dateTo / type
        Added value: +"string"
    • Changedget_vcards1 field changed
      • changedInput schema / properties / limit / maximum
        Previous value: -10000New value: +1000
    • Changedlist_campaigns1 field changed
      • changedInput schema / properties / types / items / enum
        Previous value: -[
        -  "TEXT_CAMPAIGN",
        -  "MOBILE_APP_CAMPAIGN",
        -  "DYNAMIC_TEXT_CAMPAIGN",
        -  "CPM_BANNER_CAMPAIGN",
        -  "SMART_CAMPAIGN",
        -  "MCBANNER_CAMPAIGN"
        -]New value: +[
        +  "TEXT_CAMPAIGN",
        +  "MOBILE_APP_CAMPAIGN",
        +  "DYNAMIC_TEXT_CAMPAIGN",
        +  "CPM_BANNER_CAMPAIGN",
        +  "SMART_CAMPAIGN",
        +  "MCBANNER_CAMPAIGN",
        +  "UNIFIED_CAMPAIGN"
        +]
  8. 39 tool updatesv0.1.0
    • First observedad_action
    • First observedadd_bid_modifier
    • First observedadd_callouts
    • First observedadd_keywords
    • First observedcampaign_action
    • First observedcreate_ad_group
    • First observedcreate_sitelinks_set
    • First observedcreate_text_ad
    • First observedcreate_text_campaign
    • First observedcreate_vcard
    • First observeddelete_ad_groups
    • First observeddelete_bid_modifiers
    • First observeddelete_callouts
    • First observeddelete_sitelinks
    • First observeddelete_vcards
    • First observedget_account_info
    • First observedget_ad_images
    • First observedget_ad_videos
    • First observedget_bid_modifiers
    • First observedget_callouts
    • First observedget_creatives
    • First observedget_dictionaries
    • First observedget_quota
    • First observedget_regions
    • First observedget_sitelinks
    • First observedget_statistics
    • First observedget_vcards
    • First observedkeyword_action
    • First observedlist_ad_groups
    • First observedlist_ads
    • First observedlist_campaigns
    • First observedlist_keywords
    • First observedraw_request
    • First observedset_bid_modifiers
    • First observedset_keyword_bids
    • First observedupdate_ad_group
    • First observedupdate_campaign
    • First observedupdate_text_ad
    • First observedupload_ad_image

TDQS

B3.4/5.0

Scored across 46 tools

Disambiguation4/5

Most tools target a distinct resource/action and the very detailed descriptions clarify boundaries, e.g. campaign_action vs set_campaign_strategy and list_clients vs clients_overview. Some overlap remains around generic raw_request, get_dictionaries vs get_regions, and several action-style tools that could be confused at a glance.

Naming Consistency4/5

The set is predominantly snake_case verb_noun (list_campaigns, create_ad_group, delete_callouts, set_keyword_bids). Minor deviations are noun-first tools such as auth_status and clients_overview, plus the generic raw_request.

Tool Count2/5

At 46 tools this is a very large surface, well beyond the typical well-scoped range, even accounting for the breadth of Yandex Direct. Many tools are justified by real API resources, but the sheer count increases selection burden and cognitive load.

Completeness4/5

Core lifecycle coverage is strong: campaigns, ad groups, ads, keywords, bid modifiers, sitelinks, callouts, statistics, account, clients and auth are represented. Some operations such as video upload, creative creation, and certain campaign settings require raw_request rather than dedicated tools.

Maintenance

ActivityNo data
ResponsivenessOutdated data

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables interaction with Yandex advertising and analytics APIs (Direct, Metrika, Audience, Webmaster, AdMetrica) through MCP tools, resources, and prompts for campaign management and data retrieval.
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to manage Yandex Direct advertising campaigns, ads, keywords, and reports via natural language using the Yandex Direct API v5.
    2
    1
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables AI agents to manage Yandex Direct advertising accounts via the API v5, including reports, bids, campaign management, and semantic analysis through natural language requests.
    4
    87 npm
    MIT