yandex-direct-mcp-plus 1.3.0 → 1.4.0

package/README.md

@@ -1,33 +1,60 @@
 # yandex-direct-mcp-plus
 
-MCP-сервер для API Яндекс.Директ — управление контекстной рекламой из любого MCP-клиента (Claude, Cursor и др.): кампании, объявления, аудитории, изображения, фиды, уточнения, ставки, минус-фразы, стратегии, расписание показов, статистика и баланс. **51 инструмент.**
+Ведение контекстной рекламы Яндекс.Директа из диалога с ассистентом: собрать кампанию, разобрать поисковые запросы, вычистить минус-фразы, поправить ставки и посмотреть расход — не переключаясь между разделами кабинета. Работает в любом MCP-клиенте: Claude Code, Claude Desktop, Cursor и другие.
 
+[![npm](https://img.shields.io/npm/v/yandex-direct-mcp-plus.svg)](https://www.npmjs.com/package/yandex-direct-mcp-plus)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node](https://img.shields.io/badge/node-%3E%3D22-green.svg)](https://nodejs.org)
 
-> Деньги — **в рублях** (бюджеты, ставки на вводе и выводе); сервер сам конвертирует в микроединицы API. Поддержан **агентский режим** (Client-Login).
->
-> Все ID передаются строками (`"1915016273214320641"`). Это сохраняет 64-битные идентификаторы Яндекс.Директа без потери точности в JavaScript.
+- **58 инструментов**, из них 24 только читают. Кампании и стратегии, группы, объявления и модерация, ключевые фразы и ставки, минус-фразы и общие наборы, быстрые ссылки, уточнения, изображения, визитки, корректировки ставок, ретаргетинг, аудиторные и динамические цели, фиды, расписание показов, статистика, поисковые запросы, баланс и справочники.
+- **Деньги — в рублях**, на вводе и на выводе; в микроединицы API сервер переводит сам. Поддержан агентский режим (`Client-Login`).
+- **ID — строками** (`"1915016273214320641"`): 64-битные идентификаторы Директа не помещаются в число JavaScript и молча теряют точность. Здесь это стережёт правило линтера, а не внимательность.
+- **Реклама боевая.** Тестовой среды у Директа больше нет — какие инструменты тратят деньги и что удаляют необратимо, перечислено в разделе [Что меняет данные](#что-меняет-данные).
+- **Телеметрии нет.** Сервер не отправляет никуда ничего, кроме запросов к API Яндекса.
 
-> [!NOTE]
-> В npm пакет пока не опубликован — ставится сборкой из исходников. Публикация будет отдельным релизом.
+## Содержание
+
+- [Что можно делать](#что-можно-делать) — примеры запросов обычным текстом
+- [Установка](#установка) — Claude Code, Claude Desktop, Cursor, из исходников
+- [Токен](#токен) — как получить и какие переменные окружения нужны
+- [Что меняет данные](#что-меняет-данные) — что тратит бюджет и что необратимо
+- [Инструменты](#инструменты-58) — полный список с описаниями
+- [Разработка](#разработка) — сборка, тесты, архитектура
+
+## Что можно делать
+
+Обычным текстом в чате — инструменты сервер подставляет сам:
+
+```
+Собери кампанию «Летняя распродажа»: бюджет 5000 ₽/день, старт 1 мая, показы будни 9–21
+Добавь минус-фразы «бесплатно» и «скачать» в кампанию 12345, не затерев остальные
+Посмотри поисковые запросы за месяц и предложи, что заминусовать
+Подними ставку до 25 ₽ там, где CTR выше 8%, а показов меньше сотни
+Что изменилось в кампаниях со вчера?
+Покажи расход по кампаниям за неделю и баланс аккаунта
+Найди код региона для Новосибирска
+```
+
+Полный список — [58 инструментов](#инструменты-58) ниже.
 
 ## Установка
 
+Нужен Node.js 22+ и OAuth-токен Яндекс.Директа — [как его получить](#токен).
+
+### Claude Code
+
 ```bash
-git clone git@github.com:Pavelsiba/yandex-direct-mcp-plus.git
-cd yandex-direct-mcp-plus
-npm ci && npm run build
+claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y yandex-direct-mcp-plus
 ```
 
-### Claude Desktop
+### Claude Desktop, Cursor и другие клиенты
 
 ```json
 {
   "mcpServers": {
     "yandex-direct": {
-      "command": "node",
-      "args": ["/путь/к/yandex-direct-mcp-plus/dist/app/index.js"],
+      "command": "npx",
+      "args": ["-y", "yandex-direct-mcp-plus"],
       "env": {
         "YANDEX_DIRECT_TOKEN": "ваш_токен"
       }
@@ -36,12 +63,19 @@ npm ci && npm run build
 }
 ```
 
-### Claude Code
+### Из исходников
 
 ```bash
-claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- node /путь/к/yandex-direct-mcp-plus/dist/app/index.js
+git clone git@github.com:Pavelsiba/yandex-direct-mcp-plus.git
+cd yandex-direct-mcp-plus
+npm ci && npm run build
 ```
-## Конфигурация (переменные окружения)
+
+Дальше тот же конфиг, но `"command": "node"` и путь к `dist/app/index.js` вместо `npx`.
+
+## Токен
+
+OAuth-токен выпускается для приложения, зарегистрированного в [Яндекс OAuth](https://oauth.yandex.ru/), с доступом к API Директа. Подробности — [регистрация приложения и получение токена](https://yandex.ru/dev/direct/doc/ru/token). Доступ к API нужно [запросить в интерфейсе Директа](https://yandex.ru/dev/direct/doc/ru/access-request) — заявку рассматривают от часа до нескольких суток.
 
 | Переменная | Обязательна | Назначение |
 |------------|:-----------:|------------|
@@ -49,17 +83,36 @@ claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- node /
 | `YANDEX_DIRECT_LOGIN` | нет | Логин клиента для агентских токенов (заголовок `Client-Login`). Обязателен, если токен агентский |
 | `YANDEX_DIRECT_POLYGON_CAMPAIGN_ID` | нет | Только для `npm run test:int`: ID кампании-полигона, оставленной черновиком. Сетевые тесты пишут в неё и ни во что другое; без переменной они пропускаются |
 
-### Как получить токен
+## Что меняет данные
 
-OAuth-токен выпускается для приложения, зарегистрированного в [Яндекс OAuth](https://oauth.yandex.ru/), с доступом к API Директа. Подробности — [регистрация приложения и получение токена](https://yandex.ru/dev/direct/doc/ru/token). Доступ к API нужно [запросить в интерфейсе Директа](https://yandex.ru/dev/direct/doc/ru/access-request).
+Тестовой среды у Яндекс.Директа больше нет: песочница отключена с июля 2026, и любой вызов идёт по боевому аккаунту. Отлаживать сценарии приходится на отдельной кампании, оставленной черновиком, — показов она не даёт и потому не тратит бюджет, пока не пройдёт модерацию и не будет включена.
 
-## ⚠️ Внимание: реальные траты
+Граница проходит не по «чтение или запись», а по скорости, с которой действие превращается в деньги.
 
-Инструменты `create_campaign`, `create_text_ad`, `add_keywords`, `set_keyword_bids` и др. меняют боевой рекламный аккаунт и могут **расходовать деньги**.
+**24 инструмента только читают** — все `list_*`, `get_*` и справочники. Вызвать их безопасно всегда.
 
-Тестовой среды у Яндекс.Директа больше нет: песочница отключена с июля 2026, и любой вызов идёт по боевому аккаунту. Отлаживать сценарии приходится на отдельной кампании, оставленной черновиком, — показов она не даёт и потому не тратит бюджет, пока не пройдёт модерацию и не будет включена.
+**Тратят бюджет или запускают показы** — восемь:
+
+| Инструмент | Чем именно |
+|------------|------------|
+| `manage_campaigns` | `resume` — включает показы остановленной кампании |
+| `manage_ads` | `resume` и `moderate` — возвращает объявления в показ |
+| `moderate_ads` | Отправляет объявления на модерацию, после неё начнутся показы |
+| `update_campaign` | Меняет дневной бюджет |
+| `set_keyword_bids` | Меняет ставки, то есть цену клика |
+| `set_strategy` | Меняет стратегию — переписывает всю экономику кампании |
+| `add_bid_adjustments` | Заводит корректировку: +N% к ставке на срезе аудитории |
+| `set_bid_adjustments` | Меняет коэффициент существующей корректировки |
+
+**Удаляют необратимо** — эти инструменты помечены аннотацией `DESTRUCTIVE`, и хороший MCP-клиент спросит подтверждение перед вызовом:
 
-## Инструменты (51)
+`manage_campaigns` (`delete`), `manage_ads` (`delete`), `manage_keywords` (`delete`), `delete_ad_groups`, `delete_ad_extensions`, `delete_sitelinks`, `delete_vcards`, `delete_bid_adjustments`, `delete_retargeting_lists`, `manage_ad_images` (`delete`), `manage_dynamic_targets` (`delete`), `set_audience_targets` (`delete`), `manage_negative_keyword_shared_sets` (`delete`).
+
+Сюда же — `set_campaign_negative_keywords` и `set_ad_group_negative_keywords` в режиме `replace`: он затирает прежний список минус-фраз целиком. Именно поэтому у них нет режима по умолчанию — `mode` приходится назвать явно.
+
+Остальные инструменты создают и правят объекты. Пока кампания не прошла модерацию и не включена, показов по ней нет и бюджет не расходуется.
+
+## Инструменты (58)
 
 **Кампании**
 
@@ -69,7 +122,7 @@ OAuth-токен выпускается для приложения, зарег
 | `get_campaign` | Детальная информация о кампании по ID |
 | `create_campaign` | Создать кампанию (бюджет в рублях, выбор стратегии, часовой пояс, UTM-разметка) |
 | `update_campaign` | Обновить название/бюджет/UTM-разметку и/или статус (SUSPEND/RESUME/ARCHIVE/UNARCHIVE) |
-| `manage_campaigns` | suspend/resume/archive/unarchive для списка кампаний |
+| `manage_campaigns` | suspend/resume/archive/unarchive/delete для списка кампаний |
 | `get_strategy` | Получить стратегию текстово-графической кампании |
 | `set_strategy` | Сменить стратегию: ручная, максимум кликов, средняя цена клика/конверсии, оплата за конверсию |
 | `get_time_targeting` | Расписание показов: часовой пояс, часы по дням недели, праздники |
@@ -100,6 +153,7 @@ OAuth-токен выпускается для приложения, зарег
 |------------|----------|
 | `list_keywords` | Ключевые фразы в группах (ставки в рублях) |
 | `add_keywords` | Добавить ключевые фразы |
+| `update_keywords` | Изменить текст фразы и подстановочные переменные `{param1}`/`{param2}` |
 | `set_keyword_bids` | Установить ставки (поиск/сети, рубли) на фразах/группах/кампаниях |
 | `manage_keywords` | suspend/resume/delete |
 | `set_campaign_negative_keywords` | Минус-фразы кампании: `mode` обязателен — `replace`, `add` или `remove` |
@@ -111,12 +165,15 @@ OAuth-токен выпускается для приложения, зарег
 |------------|----------|
 | `list_sitelinks` | Получить наборы быстрых ссылок |
 | `set_sitelinks` | Создать новый набор быстрых ссылок |
+| `delete_sitelinks` | Удалить наборы быстрых ссылок |
 | `list_ad_extensions` | Получить уточнения (callouts) |
 | `add_ad_extensions` | Создать уточнения |
 | `delete_ad_extensions` | Удалить уточнения |
 | `manage_ad_images` | Загрузить, получить или удалить изображения |
-| `get_bid_adjustments` | Получить корректировки по устройствам, полу и возрасту |
+| `get_bid_adjustments` | Получить корректировки: устройства, пол и возраст, аудитории, регионы, платёжеспособность, размещение |
+| `add_bid_adjustments` | Создать корректировки на кампаниях или группах |
 | `set_bid_adjustments` | Изменить коэффициенты существующих корректировок |
+| `delete_bid_adjustments` | Удалить корректировки по ID |
 
 **Аудитории, цели и фиды**
 
@@ -124,6 +181,8 @@ OAuth-токен выпускается для приложения, зарег
 |------------|----------|
 | `list_retargeting_lists` | Получить условия ретаргетинга и подбора аудитории |
 | `add_retargeting_list` | Создать условие ретаргетинга |
+| `update_retargeting_lists` | Изменить название, описание и правила условий (правила заменяются целиком) |
+| `delete_retargeting_lists` | Удалить условия ретаргетинга |
 | `list_audience_targets` | Получить аудиторные цели |
 | `set_audience_targets` | add/set_bids/suspend/resume/delete аудиторных целей |
 | `list_dynamic_targets` | Получить динамические цели |
@@ -139,26 +198,15 @@ OAuth-токен выпускается для приложения, зарег
 |------------|----------|
 | `get_statistics` | Статистика за период (показы, клики, расход, CTR, CPC) |
 | `get_search_queries` | Фактические поисковые запросы для подбора минус-фраз |
-| `get_changes` | Проверить изменения кампаний, групп и объявлений |
+| `get_changes` | Проверить изменения кампаний, групп, объявлений и справочников |
 | `list_vcards` | Получить виртуальные визитки |
 | `add_vcard` | Создать виртуальную визитку |
+| `delete_vcards` | Удалить визитки по ID |
 | `list_businesses` | Получить профили организаций Яндекс Бизнеса |
 | `get_account_balance` | Баланс аккаунта (Live API v4) |
-| `get_regions` | Справочник кодов регионов (225 = Россия) |
+| `get_regions` | Справочник кодов регионов (225 = Россия), с вложенностью по запросу |
 | `list_time_zones` | Справочник часовых поясов для расписания показов |
 
-## Примеры запросов
-
-```
-Покажи все активные рекламные кампании
-Создай кампанию "Летняя распродажа" с бюджетом 5000 ₽/день, старт 2026-05-01
-Установи ставку 25 ₽ на ключевые фразы 111 и 222
-Добавь минус-фразы "бесплатно", "скачать" в кампанию 12345
-Какая статистика у кампаний 12345 и 67890 за последнюю неделю?
-Найди код региона для Новосибирска
-Покажи баланс аккаунта
-```
-
 ## Разработка
 
 ```bash

package/dist/app/registry.js

@@ -4,21 +4,21 @@ import { createAdGroupTool, deleteAdGroupsTool, listAdGroupsTool } from "#tools/
 import { manageAdImagesTool } from "#tools/ad-images/tool";
 import { createTextAdTool, listAdsTool, manageAdsTool, moderateAdsTool, updateTextAdTool } from "#tools/ads/tool";
 import { listAudienceTargetsTool, setAudienceTargetsTool } from "#tools/audience-targets/tool";
-import { getBidAdjustmentsTool, setBidAdjustmentsTool } from "#tools/bid-adjustments/tool";
+import { addBidAdjustmentsTool, deleteBidAdjustmentsTool, getBidAdjustmentsTool, setBidAdjustmentsTool } from "#tools/bid-adjustments/tool";
 import { listBusinessesTool } from "#tools/businesses/tool";
 import { createCampaignTool, getCampaignTool, getStrategyTool, listCampaignsTool, manageCampaignsTool, setStrategyTool, updateCampaignTool } from "#tools/campaigns/tool";
 import { getChangesTool } from "#tools/changes/tool";
 import { getRegionsTool, listTimeZonesTool } from "#tools/dictionaries/tool";
 import { listDynamicTargetsTool, manageDynamicTargetsTool } from "#tools/dynamic-targets/tool";
 import { listFeedsTool } from "#tools/feeds/tool";
-import { addKeywordsTool, listKeywordsTool, manageKeywordsTool, setKeywordBidsTool } from "#tools/keywords/tool";
+import { addKeywordsTool, listKeywordsTool, manageKeywordsTool, setKeywordBidsTool, updateKeywordsTool } from "#tools/keywords/tool";
 import { getCampaignNegativeKeywordsTool, linkNegativeKeywordSetsTool, listNegativeKeywordSharedSetsTool, manageNegativeKeywordSharedSetsTool, setAdGroupNegativeKeywordsTool, setCampaignNegativeKeywordsTool } from "#tools/negative-keywords/tool";
-import { addRetargetingListTool, listRetargetingListsTool } from "#tools/retargeting/tool";
+import { addRetargetingListTool, deleteRetargetingListsTool, listRetargetingListsTool, updateRetargetingListsTool } from "#tools/retargeting/tool";
 import { getSearchQueriesTool } from "#tools/search-queries/tool";
-import { listSitelinksTool, setSitelinksTool } from "#tools/sitelinks/tool";
+import { deleteSitelinksTool, listSitelinksTool, setSitelinksTool } from "#tools/sitelinks/tool";
 import { getStatisticsTool } from "#tools/statistics/tool";
 import { getTimeTargetingTool, setTimeTargetingTool } from "#tools/time-targeting/tool";
-import { addVcardTool, listVcardsTool } from "#tools/vcards/tool";
+import { addVcardTool, deleteVcardsTool, listVcardsTool } from "#tools/vcards/tool";
 export const tools = [
     // Кампании и стратегии
     listCampaignsTool,
@@ -43,6 +43,7 @@ export const tools = [
     // Ключевые фразы и ставки
     listKeywordsTool,
     addKeywordsTool,
+    updateKeywordsTool,
     manageKeywordsTool,
     setKeywordBidsTool,
     // Минус-фразы
@@ -55,12 +56,14 @@ export const tools = [
     // Ассеты объявления
     listSitelinksTool,
     setSitelinksTool,
+    deleteSitelinksTool,
     listAdExtensionsTool,
     addAdExtensionsTool,
     deleteAdExtensionsTool,
     manageAdImagesTool,
     listVcardsTool,
     addVcardTool,
+    deleteVcardsTool,
     // Таргетинг и корректировки
     listAudienceTargetsTool,
     setAudienceTargetsTool,
@@ -68,8 +71,12 @@ export const tools = [
     manageDynamicTargetsTool,
     listRetargetingListsTool,
     addRetargetingListTool,
+    updateRetargetingListsTool,
+    deleteRetargetingListsTool,
     getBidAdjustmentsTool,
+    addBidAdjustmentsTool,
     setBidAdjustmentsTool,
+    deleteBidAdjustmentsTool,
     // Отчёты
     getStatisticsTool,
     getSearchQueriesTool,

package/dist/shared/api/errors.d.ts

@@ -1,2 +1,3 @@
 export declare function assertNoApiError(data: unknown): void;
 export declare function assertNoApiErrorV4(data: Record<string, unknown> | null): void;
+export declare function assertNoReportAuthError(body: string): void;

package/dist/shared/api/errors.js

@@ -1,10 +1,29 @@
 // Разбор ошибок Директа. Хендлеры сюда не заглядывают: их дело — сценарий.
+// 53 — единственная ошибка, которую не чинит ни повтор, ни другой запрос: токен истёк,
+// отозван или указан неверно. Проба 06.09.2026: v5 отдаёт её телом с HTTP 200
+// («Ошибка авторизации» / «Недействительный OAuth-токен»), v4 — тем же кодом, но с пустым
+// error_detail, а Reports — HTTP 400 и XML, где код лежит в <reports:errorCode>.
+const AUTH_ERROR_CODE = 53;
+// Текст адресован модели на другом конце протокола, а не человеку в логе: без явного
+// «повтор не поможет» она уводит вызов в ретраи, и пользователь так и не узнает, что
+// нужно перевыпустить токен.
+const AUTH_ERROR_MESSAGE = [
+    "Токен Яндекс.Директа не принят: истёк, отозван или задан неверно.",
+    "Это не сбой сети и не временная ошибка — повторять вызов бесполезно.",
+    "Нужен новый OAuth-токен (https://yandex.ru/dev/direct/doc/ru/token):",
+    "передайте его в переменной YANDEX_DIRECT_TOKEN в конфигурации MCP-клиента и перезапустите сервер."
+].join(" ");
+function isAuthError(code) {
+    return Number(code) === AUTH_ERROR_CODE;
+}
 // v5 возвращает ошибку уровня запроса телом с HTTP 200 — статус проверять бесполезно,
 // признак ошибки один: ключ `error`. Док: https://yandex.ru/dev/direct/doc/en/concepts/errors-list
 export function assertNoApiError(data) {
     const error = data?.error;
     if (!error || typeof error !== "object")
         return;
+    if (isAuthError(error.error_code))
+        throw new Error(AUTH_ERROR_MESSAGE);
     const parts = [`Ошибка API Яндекс.Директ [${error.error_code ?? "?"}]: ${error.error_string ?? "неизвестная ошибка"}`];
     if (error.error_detail)
         parts.push(`— ${error.error_detail}`);
@@ -16,6 +35,18 @@ export function assertNoApiError(data) {
 export function assertNoApiErrorV4(data) {
     if (!data || (data.error_code === undefined && data.error_str === undefined))
         return;
+    if (isAuthError(data.error_code))
+        throw new Error(AUTH_ERROR_MESSAGE);
     const detail = data.error_detail ? ` — ${data.error_detail}` : "";
     throw new Error(`Ошибка API v4 [${data.error_code ?? "?"}]: ${data.error_str ?? "неизвестная ошибка"}${detail}`);
 }
+const REPORT_ERROR_CODE = /<reports:errorCode>(\d+)<\/reports:errorCode>/;
+// Reports — единственный сервис, отвечающий настоящим HTTP-кодом и XML, поэтому его
+// ошибка не доходит ни до assertNoApiError, ни до схемы: транспорт бросает раньше.
+// Вызывается из fetchWithRetry — там тело неуспешного ответа и оказывается. Код тянем
+// регуляркой: разбирать XML ради одного числа — лишняя зависимость.
+export function assertNoReportAuthError(body) {
+    const code = REPORT_ERROR_CODE.exec(body)?.[1];
+    if (code && isAuthError(code))
+        throw new Error(AUTH_ERROR_MESSAGE);
+}

package/dist/shared/api/fetch.js

@@ -1,4 +1,5 @@
 // Транспорт: заголовки, повторы, таймаут. Знает про HTTP и токен, не знает про домен.
+import { assertNoReportAuthError } from "#shared/api/errors";
 import { getClientLogin, getToken } from "#shared/config/env";
 import { MAX_RETRIES, MAX_RETRY_DELAY_MS, REQUEST_TIMEOUT_MS } from "#shared/config/limits";
 export function commonHeaders() {
@@ -45,6 +46,7 @@ export async function fetchWithRetry(url, options = {}, retries = MAX_RETRIES) {
                 continue;
             }
             const body = await response.text().catch(() => "");
+            assertNoReportAuthError(body);
             throw new Error(`HTTP ${response.status}: ${response.statusText}. ${body}`);
         }
         catch (error) {

package/dist/shared/config/enums.d.ts

@@ -1,7 +1,7 @@
 export declare const CAMPAIGN_STATUSES: readonly ["ACCEPTED", "DRAFT", "MODERATION", "REJECTED"];
 export declare const KEYWORD_ACTIONS: readonly ["suspend", "resume", "delete"];
 export declare const AD_ACTIONS: readonly ["suspend", "resume", "archive", "unarchive", "moderate", "delete"];
-export declare const CAMPAIGN_ACTIONS: readonly ["suspend", "resume", "archive", "unarchive"];
+export declare const CAMPAIGN_ACTIONS: readonly ["suspend", "resume", "archive", "unarchive", "delete"];
 export declare const CAMPAIGN_STATUS_ACTIONS: readonly ["SUSPEND", "RESUME", "ARCHIVE", "UNARCHIVE"];
 export declare const CAMPAIGN_TYPES_CREATABLE: readonly ["TEXT_CAMPAIGN", "DYNAMIC_TEXT_CAMPAIGN"];
 export declare const CAMPAIGN_TYPES: readonly ["TEXT_CAMPAIGN", "MOBILE_APP_CAMPAIGN", "DYNAMIC_TEXT_CAMPAIGN", "CPM_BANNER_CAMPAIGN", "SMART_CAMPAIGN", "UNIFIED_CAMPAIGN"];
@@ -15,7 +15,12 @@ export declare const AD_IMAGE_ACTIONS: readonly ["add", "get", "delete"];
 export declare const ASSOCIATED_FLAGS: readonly ["YES", "NO"];
 export declare const RETARGETING_TYPES: readonly ["RETARGETING", "AUDIENCE"];
 export declare const RETARGETING_RULE_OPERATORS: readonly ["ALL", "ANY", "NONE"];
-export declare const BID_ADJUSTMENT_TYPES: readonly ["MOBILE_ADJUSTMENT", "TABLET_ADJUSTMENT", "DESKTOP_ADJUSTMENT", "DESKTOP_ONLY_ADJUSTMENT", "DEMOGRAPHICS_ADJUSTMENT"];
+export declare const BID_ADJUSTMENT_TYPES: readonly ["MOBILE_ADJUSTMENT", "TABLET_ADJUSTMENT", "DESKTOP_ADJUSTMENT", "DESKTOP_ONLY_ADJUSTMENT", "SMART_TV_ADJUSTMENT", "DEMOGRAPHICS_ADJUSTMENT", "RETARGETING_ADJUSTMENT", "REGIONAL_ADJUSTMENT", "VIDEO_ADJUSTMENT", "SMART_AD_ADJUSTMENT", "SERP_LAYOUT_ADJUSTMENT", "INCOME_GRADE_ADJUSTMENT", "AD_GROUP_ADJUSTMENT"];
+export declare const OPERATING_SYSTEM_TYPES: readonly ["IOS", "ANDROID"];
+export declare const GENDERS: readonly ["GENDER_MALE", "GENDER_FEMALE"];
+export declare const AGE_RANGES: readonly ["AGE_0_17", "AGE_18_24", "AGE_25_34", "AGE_35_44", "AGE_45", "AGE_45_54", "AGE_55"];
+export declare const SERP_LAYOUTS: readonly ["ALONE", "SUGGEST"];
+export declare const INCOME_GRADES: readonly ["VERY_HIGH", "HIGH", "ABOVE_AVERAGE"];
 export declare const BID_ADJUSTMENT_LEVELS: readonly ["CAMPAIGN", "AD_GROUP"];
 export declare const AUDIENCE_TARGET_STATES: readonly ["ON", "SUSPENDED"];
 export declare const AUDIENCE_TARGET_ACTIONS: readonly ["add", "set_bids", "suspend", "resume", "delete"];
@@ -23,7 +28,7 @@ export declare const STRATEGY_PRIORITIES: readonly ["LOW", "NORMAL", "HIGH"];
 export declare const DYNAMIC_TARGET_ACTIONS: readonly ["add", "set_bids", "suspend", "resume", "delete"];
 export declare const WEBPAGE_CONDITION_OPERANDS: readonly ["URL", "DOMAIN", "PAGE_TITLE", "PAGE_CONTENT", "OFFERS_LIST_URL"];
 export declare const WEBPAGE_CONDITION_OPERATORS: readonly ["EQUALS_ANY", "NOT_EQUALS_ALL", "CONTAINS_ANY", "NOT_CONTAINS_ALL"];
-export declare const CHANGES_MODES: readonly ["campaigns", "objects"];
+export declare const CHANGES_MODES: readonly ["campaigns", "objects", "dictionaries"];
 export declare const CHANGES_FIELD_NAMES: readonly ["CampaignIds", "AdGroupIds", "AdIds", "CampaignsStat"];
 export declare const SETTABLE_SEARCH_STRATEGIES: readonly ["HIGHEST_POSITION", "WB_MAXIMUM_CLICKS", "AVERAGE_CPC", "AVERAGE_CPA", "PAY_FOR_CONVERSION", "SERVING_OFF"];
 export declare const SETTABLE_NETWORK_STRATEGIES: readonly ["NETWORK_DEFAULT", "MAXIMUM_COVERAGE", "WB_MAXIMUM_CLICKS", "AVERAGE_CPC", "AVERAGE_CPA", "PAY_FOR_CONVERSION", "SERVING_OFF"];

package/dist/shared/config/enums.js

@@ -11,8 +11,10 @@ export const CAMPAIGN_STATUSES = ["ACCEPTED", "DRAFT", "MODERATION", "REJECTED"]
 export const KEYWORD_ACTIONS = ["suspend", "resume", "delete"];
 // Действия над объявлениями: тоже методы сервиса ads.
 export const AD_ACTIONS = ["suspend", "resume", "archive", "unarchive", "moderate", "delete"];
-// Действия над кампанией: отдельные методы API, набор закрыт.
-export const CAMPAIGN_ACTIONS = ["suspend", "resume", "archive", "unarchive"];
+// Действия над кампанией: отдельные методы API, набор закрыт. delete необратим и
+// доступен не всегда: кампанию с накопленной статистикой, поступившими средствами или
+// в статусе CONVERTED Директ удалять отказывается — такую только архивировать.
+export const CAMPAIGN_ACTIONS = ["suspend", "resume", "archive", "unarchive", "delete"];
 // То же действие в update_campaign исторически принимается в верхнем регистре.
 // Регистр — часть внешнего контракта, менять его нельзя: он зашит в чужие сценарии.
 export const CAMPAIGN_STATUS_ACTIONS = ["SUSPEND", "RESUME", "ARCHIVE", "UNARCHIVE"];
@@ -82,15 +84,30 @@ export const ASSOCIATED_FLAGS = ["YES", "NO"];
 // RetargetingListTypeEnum и RetargetingListRuleOperatorEnum.
 export const RETARGETING_TYPES = ["RETARGETING", "AUDIENCE"];
 export const RETARGETING_RULE_OPERATORS = ["ALL", "ANY", "NONE"];
-// Типы корректировок, которые читает get_bid_adjustments. BidModifierTypeEnum шире
-// (регионы, видео, доход, SERP-раскладка) — эти сервер пока не покрывает, см. roadmap.
+// BidModifierTypeEnum целиком: тем же набором фильтрует get_bid_adjustments и выбирает
+// вид корректировки add_bid_adjustments — в API это один список.
 export const BID_ADJUSTMENT_TYPES = [
     "MOBILE_ADJUSTMENT",
     "TABLET_ADJUSTMENT",
     "DESKTOP_ADJUSTMENT",
     "DESKTOP_ONLY_ADJUSTMENT",
-    "DEMOGRAPHICS_ADJUSTMENT"
+    "SMART_TV_ADJUSTMENT",
+    "DEMOGRAPHICS_ADJUSTMENT",
+    "RETARGETING_ADJUSTMENT",
+    "REGIONAL_ADJUSTMENT",
+    "VIDEO_ADJUSTMENT",
+    "SMART_AD_ADJUSTMENT",
+    "SERP_LAYOUT_ADJUSTMENT",
+    "INCOME_GRADE_ADJUSTMENT",
+    "AD_GROUP_ADJUSTMENT"
 ];
+// Срезы, на которые вешается корректировка: OperatingSystemTypeEnum, GenderEnum,
+// AgeRangeEnum, SerpLayoutEnum и IncomeGradeEnum из general.xsd.
+export const OPERATING_SYSTEM_TYPES = ["IOS", "ANDROID"];
+export const GENDERS = ["GENDER_MALE", "GENDER_FEMALE"];
+export const AGE_RANGES = ["AGE_0_17", "AGE_18_24", "AGE_25_34", "AGE_35_44", "AGE_45", "AGE_45_54", "AGE_55"];
+export const SERP_LAYOUTS = ["ALONE", "SUGGEST"];
+export const INCOME_GRADES = ["VERY_HIGH", "HIGH", "ABOVE_AVERAGE"];
 // BidModifierLevelEnum.
 export const BID_ADJUSTMENT_LEVELS = ["CAMPAIGN", "AD_GROUP"];
 // AudienceTargetStateEnum и действия сервиса audiencetargets (setBids — наш set_bids).
@@ -103,8 +120,9 @@ export const STRATEGY_PRIORITIES = ["LOW", "NORMAL", "HIGH"];
 export const DYNAMIC_TARGET_ACTIONS = ["add", "set_bids", "suspend", "resume", "delete"];
 export const WEBPAGE_CONDITION_OPERANDS = ["URL", "DOMAIN", "PAGE_TITLE", "PAGE_CONTENT", "OFFERS_LIST_URL"];
 export const WEBPAGE_CONDITION_OPERATORS = ["EQUALS_ANY", "NOT_EQUALS_ALL", "CONTAINS_ANY", "NOT_CONTAINS_ALL"];
-// Режимы get_changes (наши имена методов checkCampaigns/check) и CheckFieldEnum.
-export const CHANGES_MODES = ["campaigns", "objects"];
+// Режимы get_changes (наши имена методов checkCampaigns/check/checkDictionaries)
+// и CheckFieldEnum.
+export const CHANGES_MODES = ["campaigns", "objects", "dictionaries"];
 export const CHANGES_FIELD_NAMES = ["CampaignIds", "AdGroupIds", "AdIds", "CampaignsStat"];
 // Стратегии, которые умеет выставлять set_strategy. Список по-прежнему уже полного
 // (в TextCampaignStrategyBase двенадцать структур настроек), но покрывает переход

package/dist/shared/config/limits.d.ts

@@ -32,10 +32,16 @@ export declare const RETARGETING_LIMITS: {
     readonly description: 4096;
     readonly membershipDays: 540;
 };
+export declare const MAX_RETARGETING_LISTS_PER_CALL = 1000;
+export declare const KEYWORD_TEXT_MAX = 4096;
+export declare const KEYWORD_USER_PARAM_MAX = 255;
+export declare const MAX_KEYWORDS_PER_UPDATE = 1000;
+export declare const MAX_SITELINK_SETS_PER_CALL = 1000;
 export declare const BID_MODIFIER_RANGE: {
     readonly min: 0;
     readonly max: 1300;
 };
+export declare const MAX_ADJUSTMENTS_PER_CALL = 1000;
 export declare const MAX_CAMPAIGNS_PER_ADJUSTMENT_CALL = 10;
 export declare const MAX_CAMPAIGNS_PER_AUDIENCE_CALL = 100;
 export declare const MAX_CAMPAIGNS_PER_CHANGES_CALL = 3000;

package/dist/shared/config/limits.js

@@ -30,8 +30,20 @@ export const AD_IMAGE_NAME_MAX = 255;
 export const MAX_IMAGES_PER_CALL = 100;
 // Ретаргетинг: длины полей и срок учёта цели.
 export const RETARGETING_LIMITS = { name: 250, description: 4096, membershipDays: 540 };
+// Сколько условий ретаргетинга принимают update и delete за вызов.
+export const MAX_RETARGETING_LISTS_PER_CALL = 1_000;
+// Ключевые фразы: длина фразы, подстановочные переменные {param1} и {param2},
+// размер пакета update.
+export const KEYWORD_TEXT_MAX = 4_096;
+export const KEYWORD_USER_PARAM_MAX = 255;
+export const MAX_KEYWORDS_PER_UPDATE = 1_000;
+// Наборов быстрых ссылок за вызов — не больше тысячи. Для визиток такого числа в
+// документации нет (страниц VCards там не осталось вовсе), поэтому у них общий потолок.
+export const MAX_SITELINK_SETS_PER_CALL = 1_000;
 // Коэффициент корректировки ставки, в процентах.
 export const BID_MODIFIER_RANGE = { min: 0, max: 1300 };
+// BidModifiers.add: не больше тысячи корректировок за вызов.
+export const MAX_ADJUSTMENTS_PER_CALL = 1_000;
 // Корректировки читаются не больше чем по десяти кампаниям за вызов.
 export const MAX_CAMPAIGNS_PER_ADJUSTMENT_CALL = 10;
 // Аудиторные цели читаются не больше чем по сотне кампаний за вызов.

package/dist/tools/bid-adjustments/handler.d.ts

@@ -1,4 +1,6 @@
 import type { z } from "zod";
-import type { getBidAdjustmentsSchema, setBidAdjustmentsSchema } from "./schema.js";
+import type { addBidAdjustmentsSchema, deleteBidAdjustmentsSchema, getBidAdjustmentsSchema, setBidAdjustmentsSchema } from "./schema.js";
 export declare function handleGetBidAdjustments(params: z.infer<typeof getBidAdjustmentsSchema>): Promise<string>;
 export declare function handleSetBidAdjustments(params: z.infer<typeof setBidAdjustmentsSchema>): Promise<string>;
+export declare function handleAddBidAdjustments(params: z.infer<typeof addBidAdjustmentsSchema>): Promise<string>;
+export declare function handleDeleteBidAdjustments(params: z.infer<typeof deleteBidAdjustmentsSchema>): Promise<string>;