yandex-direct-mcp-plus 1.3.0 → 1.5.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, getKeywordAuctionTool, 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,8 +43,10 @@ export const tools = [
     // Ключевые фразы и ставки
     listKeywordsTool,
     addKeywordsTool,
+    updateKeywordsTool,
     manageKeywordsTool,
     setKeywordBidsTool,
+    getKeywordAuctionTool,
     // Минус-фразы
     getCampaignNegativeKeywordsTool,
     setCampaignNegativeKeywordsTool,
@@ -55,12 +57,14 @@ export const tools = [
     // Ассеты объявления
     listSitelinksTool,
     setSitelinksTool,
+    deleteSitelinksTool,
     listAdExtensionsTool,
     addAdExtensionsTool,
     deleteAdExtensionsTool,
     manageAdImagesTool,
     listVcardsTool,
     addVcardTool,
+    deleteVcardsTool,
     // Таргетинг и корректировки
     listAudienceTargetsTool,
     setAudienceTargetsTool,
@@ -68,8 +72,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/api-fields.d.ts

@@ -0,0 +1,161 @@
+export declare const API_FIELDS: {
+    readonly adextensions: {
+        readonly AdExtensionFieldEnum: readonly ["Associated", "Id", "State", "Status", "StatusClarification", "Type"];
+        readonly CalloutFieldEnum: readonly ["CalloutText"];
+    };
+    readonly adgroups: {
+        readonly AdGroupFieldEnum: readonly ["CampaignId", "Id", "Name", "NegativeKeywordSharedSetIds", "NegativeKeywords", "RegionIds", "RestrictedRegionIds", "ServingStatus", "Status", "Subtype", "TrackingParams", "Type"];
+        readonly DynamicTextAdGroupFieldEnum: readonly ["AutotargetingCategories", "AutotargetingSettings", "DomainUrl", "DomainUrlProcessingStatus"];
+        readonly DynamicTextFeedAdGroupFieldEnum: readonly ["AutotargetingCategories", "AutotargetingSettings", "FeedId", "Source", "SourceProcessingStatus", "SourceType"];
+        readonly MobileAppAdGroupFieldEnum: readonly ["AppAvailabilityStatus", "AppIconModeration", "AppOperatingSystemType", "StoreUrl", "TargetCarrier", "TargetDeviceType", "TargetOperatingSystemVersion"];
+        readonly SmartAdGroupFieldEnum: readonly ["AdBodySource", "AdTitleSource", "FeedId"];
+        readonly TextAdGroupFeedParamsFieldEnum: readonly ["FeedCategoryIds", "FeedId"];
+        readonly UnifiedAdGroupFieldEnum: readonly ["OfferRetargeting"];
+    };
+    readonly adimages: {
+        readonly AdImageFieldEnum: readonly ["AdImageHash", "Associated", "Name", "OriginalUrl", "PreviewUrl", "Subtype", "Type"];
+    };
+    readonly ads: {
+        readonly AdFieldEnum: readonly ["AdCategories", "AdGroupId", "AgeLabel", "CampaignId", "Id", "State", "Status", "StatusClarification", "Subtype", "Type"];
+        readonly CpcVideoAdBuilderAdFieldEnum: readonly ["AutogeneratedErirAdDescription", "Creative", "ErirAdDescription", "Href", "TurboPageId", "TurboPageModeration"];
+        readonly CpmBannerAdBuilderAdFieldEnum: readonly ["AutogeneratedErirAdDescription", "Creative", "ErirAdDescription", "Href", "TrackingPixels", "TurboPageId", "TurboPageModeration"];
+        readonly CpmVideoAdBuilderAdFieldEnum: readonly ["AutogeneratedErirAdDescription", "Creative", "ErirAdDescription", "Href", "TrackingPixels", "TurboPageId", "TurboPageModeration"];
+        readonly DynamicTextAdFieldEnum: readonly ["AdExtensions", "AdImageHash", "AdImageModeration", "SitelinkSetId", "SitelinksModeration", "Text", "VCardId", "VCardModeration"];
+        readonly ListingAdFieldEnum: readonly ["AdExtensions", "BusinessId", "DefaultTexts", "FeedFilterConditions", "FeedId", "FeedProcessingStatus", "SitelinkSetId", "SitelinksModeration", "TextSources", "TitleSources"];
+        readonly MobileAppAdBuilderAdFieldEnum: readonly ["AutogeneratedErirAdDescription", "Creative", "ErirAdDescription", "TrackingUrl"];
+        readonly MobileAppAdFieldEnum: readonly ["Action", "AdImageHash", "AdImageModeration", "AutogeneratedErirAdDescription", "ErirAdDescription", "Features", "Text", "Title", "TrackingUrl", "VideoExtension"];
+        readonly MobileAppCpcVideoAdBuilderAdFieldEnum: readonly ["AutogeneratedErirAdDescription", "Creative", "ErirAdDescription", "TrackingUrl"];
+        readonly MobileAppImageAdFieldEnum: readonly ["AdImageHash", "AutogeneratedErirAdDescription", "ErirAdDescription", "TrackingUrl"];
+        readonly ResponsiveAdFieldEnum: readonly ["AdExtensions", "AdImages", "BusinessId", "DisplayDomain", "DisplayUrlPath", "DisplayUrlPathModeration", "ErirAdDescription", "Href", "PriceExtension", "SitelinkSetId", "SitelinksModeration", "Texts", "Titles", "VideoExtensions"];
+        readonly ShoppingAdFieldEnum: readonly ["AdExtensions", "BusinessId", "DefaultTexts", "FeedFilterConditions", "FeedId", "FeedProcessingStatus", "SitelinkSetId", "SitelinksModeration", "TextSources", "TitleSources"];
+        readonly SmartAdBuilderAdFieldEnum: readonly ["Creative"];
+        readonly TextAdBuilderAdFieldEnum: readonly ["AutogeneratedErirAdDescription", "Creative", "ErirAdDescription", "FinalUrl", "Href", "TurboPageId", "TurboPageModeration"];
+        readonly TextAdFieldEnum: readonly ["AdExtensions", "AdImageHash", "AdImageModeration", "AutogeneratedErirAdDescription", "BusinessId", "DisplayDomain", "DisplayUrlPath", "DisplayUrlPathModeration", "ErirAdDescription", "FinalUrl", "Href", "Mobile", "PreferVCardOverBusiness", "SitelinkSetId", "SitelinksModeration", "Text", "Title", "Title2", "TurboPageId", "TurboPageModeration", "VCardId", "VCardModeration", "VideoExtension"];
+        readonly TextAdPriceExtensionFieldEnum: readonly ["OldPrice", "Price", "PriceCurrency", "PriceQualifier"];
+        readonly TextImageAdFieldEnum: readonly ["AdImageHash", "AutogeneratedErirAdDescription", "ErirAdDescription", "FinalUrl", "Href", "TurboPageId", "TurboPageModeration"];
+    };
+    readonly agencyclients: {
+        readonly AgencyClientFieldEnum: readonly ["AccountQuality", "Archived", "AvailableAdGroupTypes", "AvailableCampaignTypes", "Bonuses", "ClientId", "ClientInfo", "CountryId", "CreatedAt", "Currency", "ForbiddenPlatform", "Grants", "Login", "Notification", "OverdraftSumAvailable", "Phone", "Representatives", "Restrictions", "Settings", "Type", "VatRate"];
+    };
+    readonly audiencetargets: {
+        readonly AudienceTargetFieldEnum: readonly ["AdGroupId", "CampaignId", "ContextBid", "Id", "InterestId", "RetargetingListId", "State", "StrategyPriority"];
+    };
+    readonly bidmodifiers: {
+        readonly AdGroupAdjustmentFieldEnum: readonly ["BidModifier"];
+        readonly BidModifierFieldEnum: readonly ["AdGroupId", "CampaignId", "Id", "Level", "Type"];
+        readonly DemographicsAdjustmentFieldEnum: readonly ["Age", "BidModifier", "Enabled", "Gender"];
+        readonly DesktopAdjustmentFieldEnum: readonly ["BidModifier"];
+        readonly DesktopOnlyAdjustmentFieldEnum: readonly ["BidModifier"];
+        readonly IncomeGradeAdjustmentFieldEnum: readonly ["BidModifier", "Enabled", "Grade"];
+        readonly MobileAdjustmentFieldEnum: readonly ["BidModifier", "OperatingSystemType"];
+        readonly RegionalAdjustmentFieldEnum: readonly ["BidModifier", "Enabled", "RegionId"];
+        readonly RetargetingAdjustmentFieldEnum: readonly ["Accessible", "BidModifier", "Enabled", "RetargetingConditionId"];
+        readonly SerpLayoutAdjustmentFieldEnum: readonly ["BidModifier", "Enabled", "SerpLayout"];
+        readonly SmartAdAdjustmentFieldEnum: readonly ["BidModifier"];
+        readonly SmartTvAdjustmentFieldEnum: readonly ["BidModifier"];
+        readonly TabletAdjustmentFieldEnum: readonly ["BidModifier", "OperatingSystemType"];
+        readonly VideoAdjustmentFieldEnum: readonly ["BidModifier"];
+    };
+    readonly bids: {
+        readonly BidFieldEnum: readonly ["AdGroupId", "AuctionBids", "AutotargetingSearchBidIsAuto", "Bid", "CampaignId", "CompetitorsBids", "ContextBid", "ContextCoverage", "CurrentSearchPrice", "KeywordId", "MinSearchPrice", "SearchPrices", "ServingStatus", "StrategyPriority"];
+    };
+    readonly businesses: {
+        readonly BusinessFieldEnum: readonly ["Address", "HasOffice", "Id", "InternalUrl", "IsPublished", "MergedIds", "Name", "Phone", "ProfileUrl", "Rubric", "Urls"];
+    };
+    readonly campaigns: {
+        readonly CampaignFieldEnum: readonly ["BlockedIps", "ClientInfo", "Currency", "DailyBudget", "EndDate", "ExcludedSites", "Funds", "Id", "Name", "NegativeKeywords", "Notification", "RepresentedBy", "SourceId", "StartDate", "State", "Statistics", "Status", "StatusClarification", "StatusPayment", "TimeTargeting", "TimeZone", "Type"];
+        readonly CpmBannerCampaignFieldEnum: readonly ["BiddingStrategy", "CounterIds", "FrequencyCap", "Settings", "VideoTarget"];
+        readonly DynamicTextCampaignFieldEnum: readonly ["AttributionModel", "BiddingStrategy", "CanBeUsedAsPackageBiddingStrategySource", "CounterIds", "NegativeKeywordSharedSetIds", "PackageBiddingStrategy", "PlacementTypes", "PriorityGoals", "Settings", "TrackingParams"];
+        readonly DynamicTextCampaignSearchStrategyPlacementTypesFieldEnum: readonly ["DynamicPlaces", "ProductGallery", "SearchResults"];
+        readonly MobileAppCampaignFieldEnum: readonly ["BiddingStrategy", "CanBeUsedAsPackageBiddingStrategySource", "NegativeKeywordSharedSetIds", "PackageBiddingStrategy", "Settings", "WeeklyBudgetRollover"];
+        readonly SmartCampaignFieldEnum: readonly ["AttributionModel", "BiddingStrategy", "CanBeUsedAsPackageBiddingStrategySource", "CounterId", "PackageBiddingStrategy", "PriorityGoals", "Settings", "TrackingParams"];
+        readonly TextCampaignFieldEnum: readonly ["AttributionModel", "BiddingStrategy", "CanBeUsedAsPackageBiddingStrategySource", "CounterIds", "NegativeKeywordSharedSetIds", "PackageBiddingStrategy", "PriorityGoals", "RelevantKeywords", "Settings", "TrackingParams", "WeeklyBudgetRollover"];
+        readonly TextCampaignSearchStrategyPlacementTypesFieldEnum: readonly ["DynamicPlaces", "ProductGallery", "SearchResults"];
+        readonly UnifiedCampaignFieldEnum: readonly ["AttributionModel", "BiddingStrategy", "CanBeUsedAsPackageBiddingStrategySource", "CounterIds", "NegativeKeywordSharedSetIds", "PackageBiddingStrategy", "PriorityGoals", "Settings", "TrackingParams", "WeeklyBudgetRollover"];
+        readonly UnifiedCampaignPackageBiddingStrategyPlatformsFieldEnum: readonly ["DynamicPlaces", "Maps", "Network", "ProductGallery", "SearchOrganizationList", "SearchResult"];
+        readonly UnifiedCampaignSearchStrategyPlacementTypesFieldEnum: readonly ["DynamicPlaces", "Maps", "ProductGallery", "SearchOrganizationList", "SearchResults"];
+    };
+    readonly changes: {
+        readonly CheckFieldEnum: readonly ["AdGroupIds", "AdIds", "CampaignIds", "CampaignsStat"];
+    };
+    readonly clients: {
+        readonly ClientFieldEnum: readonly ["AccountQuality", "Archived", "AvailableAdGroupTypes", "AvailableCampaignTypes", "Bonuses", "ClientId", "ClientInfo", "CountryId", "CreatedAt", "Currency", "ForbiddenPlatform", "Grants", "Login", "Notification", "OverdraftSumAvailable", "Phone", "Representatives", "Restrictions", "Settings", "Type", "VatRate"];
+    };
+    readonly creatives: {
+        readonly CpcVideoCreativeFieldEnum: readonly ["Duration"];
+        readonly CpmVideoCreativeFieldEnum: readonly ["Duration"];
+        readonly CreativeFieldEnum: readonly ["Associated", "Height", "Id", "IsAdaptive", "Name", "PreviewUrl", "ThumbnailUrl", "Type", "Width"];
+        readonly SmartCreativeFieldEnum: readonly ["BusinessType", "CreativeGroupId", "CreativeGroupName"];
+        readonly VideoExtensionCreativeFieldEnum: readonly ["Duration"];
+    };
+    readonly dictionaries: {
+        readonly GeoRegionFieldEnum: readonly ["GeoRegionId", "GeoRegionName", "ParentGeoRegionNames"];
+    };
+    readonly dynamictextadtargets: {
+        readonly WebpageFieldEnum: readonly ["AdGroupId", "Bid", "CampaignId", "ConditionType", "Conditions", "ContextBid", "Id", "Name", "State", "StatusClarification", "StrategyPriority"];
+    };
+    readonly feeds: {
+        readonly FeedFieldEnum: readonly ["BusinessType", "CampaignIds", "FilterSchema", "Id", "Name", "NumberOfItems", "NumberOfListings", "SourceType", "Status", "TitleAndTextSources", "UpdatedAt"];
+        readonly FileFeedFieldEnum: readonly ["Filename"];
+        readonly UrlFeedFieldEnum: readonly ["Login", "RemoveUtmTags", "Url"];
+    };
+    readonly keywordbids: {
+        readonly KeywordBidFieldEnum: readonly ["AdGroupId", "CampaignId", "KeywordId", "ServingStatus", "StrategyPriority"];
+        readonly KeywordBidNetworkFieldEnum: readonly ["Bid", "Coverage"];
+        readonly KeywordBidSearchFieldEnum: readonly ["AuctionBids", "AutotargetingSearchBidIsAuto", "Bid"];
+    };
+    readonly keywords: {
+        readonly KeywordFieldEnum: readonly ["AdGroupId", "AutotargetingBrandOptions", "AutotargetingCategories", "AutotargetingSearchBidIsAuto", "Bid", "CampaignId", "ContextBid", "Id", "Keyword", "Productivity", "ServingStatus", "State", "StatisticsNetwork", "StatisticsSearch", "Status", "StrategyPriority", "UserParam1", "UserParam2"];
+    };
+    readonly keywordsresearch: {
+        readonly HasSearchVolumeFieldEnum: readonly ["AllDevices", "Desktops", "Keyword", "MobilePhones", "RegionIds", "Tablets"];
+    };
+    readonly leads: {
+        readonly LeadFieldEnum: readonly ["Data", "Id", "SubmittedAt", "TurboPageId", "TurboPageName"];
+    };
+    readonly negativekeywordsharedsets: {
+        readonly NegativeKeywordSharedSetFieldEnum: readonly ["Associated", "Id", "Name", "NegativeKeywords"];
+    };
+    readonly retargetinglists: {
+        readonly RetargetingListFieldEnum: readonly ["AvailableForTargetsInAdGroupTypes", "Description", "Id", "IsAvailable", "Name", "Rules", "Scope", "Type"];
+    };
+    readonly sitelinks: {
+        readonly SitelinkFieldEnum: readonly ["Description", "Href", "Title", "TurboPageId"];
+        readonly SitelinksSetFieldEnum: readonly ["Id", "Sitelinks"];
+    };
+    readonly smartadtargets: {
+        readonly SmartAdTargetFieldEnum: readonly ["AdGroupId", "Audience", "AvailableItemsOnly", "AverageCpa", "AverageCpc", "CampaignId", "ConditionType", "Conditions", "Id", "Name", "State", "StrategyPriority"];
+    };
+    readonly strategies: {
+        readonly StrategyAverageCpaFieldEnum: readonly ["AverageCpa", "BidCeiling", "BudgetType", "CustomPeriodBudget", "ExplorationBudget", "GoalId", "WeeklyBudgetRollover", "WeeklySpendLimit"];
+        readonly StrategyAverageCpaMultipleGoalsFieldEnum: readonly ["BidCeiling", "BudgetType", "CustomPeriodBudget", "ExplorationBudget", "WeeklyBudgetRollover", "WeeklySpendLimit"];
+        readonly StrategyAverageCpaPerCampaignFieldEnum: readonly ["AverageCpa", "BidCeiling", "BudgetType", "CustomPeriodBudget", "ExplorationBudget", "GoalId", "WeeklySpendLimit"];
+        readonly StrategyAverageCpaPerFilterFieldEnum: readonly ["BidCeiling", "BudgetType", "CustomPeriodBudget", "ExplorationBudget", "FilterAverageCpa", "GoalId", "WeeklySpendLimit"];
+        readonly StrategyAverageCpcFieldEnum: readonly ["AverageCpc", "BudgetType", "CustomPeriodBudget", "WeeklyBudgetRollover", "WeeklySpendLimit"];
+        readonly StrategyAverageCpcPerCampaignFieldEnum: readonly ["AverageCpc", "BidCeiling", "BudgetType", "CustomPeriodBudget", "WeeklySpendLimit"];
+        readonly StrategyAverageCpcPerFilterFieldEnum: readonly ["BidCeiling", "BudgetType", "CustomPeriodBudget", "FilterAverageCpc", "WeeklySpendLimit"];
+        readonly StrategyAverageCrrFieldEnum: readonly ["BudgetType", "Crr", "CustomPeriodBudget", "ExplorationBudget", "GoalId", "WeeklyBudgetRollover", "WeeklySpendLimit"];
+        readonly StrategyFieldEnum: readonly ["AttributionModel", "CounterIds", "Id", "Name", "PriorityGoals", "StatusArchived", "Type"];
+        readonly StrategyMaximumClicksFieldEnum: readonly ["BidCeiling", "BudgetType", "CustomPeriodBudget", "WeeklyBudgetRollover", "WeeklySpendLimit"];
+        readonly StrategyMaximumConversionRateFieldEnum: readonly ["BidCeiling", "BudgetType", "CustomPeriodBudget", "GoalId", "WeeklyBudgetRollover", "WeeklySpendLimit"];
+        readonly StrategyMaxProfitFieldEnum: readonly ["BudgetType", "CustomPeriodBudget", "ExplorationBudget", "WeeklyBudgetRollover", "WeeklySpendLimit"];
+        readonly StrategyPayForConversionCrrFieldEnum: readonly ["BudgetType", "Crr", "CustomPeriodBudget", "GoalId", "WeeklySpendLimit"];
+        readonly StrategyPayForConversionFieldEnum: readonly ["BudgetType", "Cpa", "CustomPeriodBudget", "GoalId", "WeeklySpendLimit"];
+        readonly StrategyPayForConversionMultipleGoalsFieldEnum: readonly ["BudgetType", "CustomPeriodBudget", "WeeklySpendLimit"];
+        readonly StrategyPayForConversionPerCampaignFieldEnum: readonly ["BudgetType", "Cpa", "CustomPeriodBudget", "GoalId", "WeeklySpendLimit"];
+        readonly StrategyPayForConversionPerFilterFieldEnum: readonly ["BudgetType", "Cpa", "CustomPeriodBudget", "GoalId", "WeeklySpendLimit"];
+    };
+    readonly turbopages: {
+        readonly TurboPageFieldEnum: readonly ["BoundWithHref", "Href", "Id", "Name", "PreviewHref", "TurboSiteHref"];
+    };
+    readonly vcards: {
+        readonly VCardFieldEnum: readonly ["Apartment", "Building", "CampaignId", "City", "CompanyName", "ContactEmail", "ContactPerson", "Country", "ExtraMessage", "House", "Id", "InstantMessenger", "MetroStationId", "Ogrn", "Phone", "PointOnMap", "Street", "WorkTime"];
+    };
+    readonly "general.xsd": {
+        readonly AutotargetingBrandOptionsFieldEnum: readonly ["WithAdvertiserBrand", "WithCompetitorsBrand", "WithoutBrands"];
+        readonly AutotargetingCategoriesFieldEnum: readonly ["Accessory", "Alternative", "Broader", "Exact", "Narrow"];
+    };
+};
+type ApiService = keyof typeof API_FIELDS;
+export type FieldOf<S extends ApiService, E extends keyof (typeof API_FIELDS)[S]> = (typeof API_FIELDS)[S][E] extends readonly (infer Value)[] ? Value : never;
+export {};