yandex-direct-mcp-plus 1.3.0

package/dist/tools/campaigns/schema.js

@@ -0,0 +1,109 @@
+// Контракт инструментов кампаний. Здесь же граница snake_case → camelCase
+// и конвертация рублей в микроединицы: хендлер получает готовые значения.
+import { z } from "zod";
+import { CAMPAIGN_ACTIONS, CAMPAIGN_STATUS_ACTIONS, CAMPAIGN_STATUSES, CAMPAIGN_TYPES, CAMPAIGN_TYPES_CREATABLE, NETWORK_STRATEGIES, SEARCH_STRATEGIES, SETTABLE_NETWORK_STRATEGIES, SETTABLE_SEARCH_STRATEGIES } from "#shared/config/enums";
+import { dateField } from "#shared/lib/date";
+import { idField } from "#shared/lib/id";
+import { rublesField } from "#shared/lib/money";
+import { pageFields } from "#shared/lib/pagination";
+export const listCampaignsSchema = z.object({
+    status: z.literal(CAMPAIGN_STATUSES).optional().meta({ description: "Фильтр по статусу модерации кампании" }),
+    types: z.array(z.literal(CAMPAIGN_TYPES)).optional().meta({ description: "Фильтр по типам кампаний" }),
+    ...pageFields
+});
+export const getCampaignSchema = z.object({
+    campaign_id: idField("ID рекламной кампании, десятичная строка")
+});
+// UTM-разметка кампании. Директ дописывает эту строку к ссылке каждого объявления, поэтому
+// метки задаются один раз на кампанию, а не вписываются в href руками. Знак «?» не нужен:
+// его подставляет Директ, а присланный превратился бы в «??».
+//
+// Не литерал и без разбора на пары: набор меток открытый, а в значениях живут подстановки
+// Директа ({campaign_id}, {keyword} и прочие) — проверка вида «ключ=значение» отвергала бы
+// их. В WSDL это xsd:string без ограничения длины, поэтому проверяем только непустоту.
+const trackingParamsField = () => z
+    .string()
+    .check(z.minLength(1, { error: "Разметка не может быть пустой строкой — чтобы снять её, передайте null" }))
+    .nullable()
+    .optional()
+    .meta({
+    description: "UTM-разметка, дописывается к ссылкам всех объявлений кампании. Без ведущего «?»: utm_source=yandex&utm_campaign={campaign_id}. Допустимы подстановки Директа в фигурных скобках. null снимает разметку"
+});
+export const createCampaignSchema = z.object({
+    name: z
+        .string()
+        .check(z.minLength(1, { error: "Название не может быть пустым" }))
+        .meta({ description: "Название кампании" }),
+    type: z
+        .literal(CAMPAIGN_TYPES_CREATABLE)
+        .default("TEXT_CAMPAIGN")
+        .meta({ description: "Тип кампании: текстово-графическая или динамические объявления" }),
+    start_date: dateField("Дата начала показов, YYYY-MM-DD"),
+    daily_budget: rublesField("Дневной бюджет в рублях, например 1000 — это 1000 ₽").optional(),
+    search_strategy: z
+        .literal(SEARCH_STRATEGIES)
+        .default("HIGHEST_POSITION")
+        .meta({ description: "Стратегия показов на поиске; SERVING_OFF отключает показы на поиске" }),
+    network_strategy: z
+        .literal(NETWORK_STRATEGIES)
+        .default("SERVING_OFF")
+        .meta({ description: "Стратегия показов в сетях (РСЯ); SERVING_OFF отключает показы в сетях" }),
+    // Не литерал: в WSDL это xsd:string, закрытого списка нет — значения живут
+    // в справочнике TimeZones, его отдаёт list_time_zones.
+    time_zone: z
+        .string()
+        .check(z.minLength(1, { error: "Часовой пояс не может быть пустым" }))
+        .optional()
+        .meta({
+        description: "Часовой пояс показов, например Europe/Moscow (по умолчанию). Список — в справочнике list_time_zones; на даты отчётов не влияет, они всегда по Москве"
+    }),
+    tracking_params: trackingParamsField()
+});
+export const updateCampaignSchema = z.object({
+    campaign_id: idField("ID кампании, десятичная строка"),
+    name: z
+        .string()
+        .check(z.minLength(1, { error: "Название не может быть пустым" }))
+        .optional()
+        .meta({ description: "Новое название" }),
+    daily_budget: rublesField("Новый дневной бюджет в рублях").optional(),
+    status: z
+        .literal(CAMPAIGN_STATUS_ACTIONS)
+        .optional()
+        .meta({ description: "Действие со статусом показов: SUSPEND (остановить), RESUME, ARCHIVE, UNARCHIVE" }),
+    tracking_params: trackingParamsField()
+});
+export const manageCampaignsSchema = z.object({
+    campaign_ids: z
+        .array(idField("ID кампании, десятичная строка"))
+        .check(z.minLength(1, { error: "Список кампаний пуст" }), z.maxLength(1000, { error: "За один вызов допустимо не больше 1000 кампаний" }))
+        .meta({ description: "ID кампаний, над которыми выполняется действие" }),
+    action: z.literal(CAMPAIGN_ACTIONS).meta({ description: "Действие: suspend, resume, archive, unarchive" })
+});
+export const getStrategySchema = z.object({
+    campaign_id: idField("ID текстово-графической кампании")
+});
+// Набор уже, чем SEARCH_STRATEGIES: хендлер умеет собрать настройки только для
+// перечисленных типов. Настройки общие на обе стороны — автоматическая стратегия
+// по правилам Директа стоит на одной из них, вторая идёт NETWORK_DEFAULT или
+// SERVING_OFF, так что двусмысленности не возникает.
+export const setStrategySchema = z.object({
+    campaign_id: idField("ID текстово-графической кампании"),
+    search_type: z.literal(SETTABLE_SEARCH_STRATEGIES).meta({
+        description: "Стратегия на поиске: HIGHEST_POSITION (ручная), WB_MAXIMUM_CLICKS, AVERAGE_CPC, AVERAGE_CPA, PAY_FOR_CONVERSION или SERVING_OFF"
+    }),
+    network_type: z.literal(SETTABLE_NETWORK_STRATEGIES).meta({
+        description: "Стратегия в сетях: NETWORK_DEFAULT (по настройкам поиска), MAXIMUM_COVERAGE, WB_MAXIMUM_CLICKS, AVERAGE_CPC, AVERAGE_CPA, PAY_FOR_CONVERSION или SERVING_OFF"
+    }),
+    weekly_spend_limit: rublesField("Недельный бюджет в рублях; обязателен для WB_MAXIMUM_CLICKS, для остальных автостратегий необязателен").optional(),
+    bid_ceiling: rublesField("Максимальная ставка в рублях для WB_MAXIMUM_CLICKS и AVERAGE_CPA").optional(),
+    average_cpc: rublesField("Средняя цена клика в рублях; обязательна для AVERAGE_CPC").optional(),
+    average_cpa: rublesField("Средняя цена конверсии в рублях; обязательна для AVERAGE_CPA").optional(),
+    conversion_price: rublesField("Цена конверсии в рублях для PAY_FOR_CONVERSION: списывается за конверсию, а не за клик").optional(),
+    goal_id: idField("ID цели Метрики для AVERAGE_CPA и PAY_FOR_CONVERSION; для оплаты за конверсию обязателен").optional(),
+    network_limit_percent: z
+        .int()
+        .check(z.gte(1, { error: "Доля расходов не меньше 1%" }), z.lte(100, { error: "Доля расходов не больше 100%" }))
+        .optional()
+        .meta({ description: "Доля расходов в сетях для NETWORK_DEFAULT, проценты" })
+});

package/dist/tools/campaigns/tool.d.ts

@@ -0,0 +1,7 @@
+export declare const listCampaignsTool: import("#shared/lib/tool").ToolDescriptor;
+export declare const getCampaignTool: import("#shared/lib/tool").ToolDescriptor;
+export declare const createCampaignTool: import("#shared/lib/tool").ToolDescriptor;
+export declare const updateCampaignTool: import("#shared/lib/tool").ToolDescriptor;
+export declare const manageCampaignsTool: import("#shared/lib/tool").ToolDescriptor;
+export declare const getStrategyTool: import("#shared/lib/tool").ToolDescriptor;
+export declare const setStrategyTool: import("#shared/lib/tool").ToolDescriptor;

package/dist/tools/campaigns/tool.js

@@ -0,0 +1,61 @@
+// Дескрипторы инструментов домена: имя, описание и аннотация живут рядом с хендлером.
+import { defineTool, IDEMPOTENT, READ, WRITE } from "#shared/lib/tool";
+import { handleCreateCampaign, handleGetCampaign, handleGetStrategy, handleListCampaigns, handleManageCampaigns, handleSetStrategy, handleUpdateCampaign } from "./handler.js";
+import { createCampaignSchema, getCampaignSchema, getStrategySchema, listCampaignsSchema, manageCampaignsSchema, setStrategySchema, updateCampaignSchema } from "./schema.js";
+export const listCampaignsTool = defineTool({
+    name: "list_campaigns",
+    title: "Список кампаний",
+    description: "Список рекламных кампаний Яндекс.Директ с фильтрацией по статусу и типу. Бюджеты — в рублях.",
+    annotations: READ,
+    schema: listCampaignsSchema,
+    handler: handleListCampaigns
+});
+export const getCampaignTool = defineTool({
+    name: "get_campaign",
+    title: "Кампания по ID",
+    description: "Детальная информация о кампании по ID: бюджет (руб), статус, даты, статистика.",
+    annotations: READ,
+    schema: getCampaignSchema,
+    handler: handleGetCampaign
+});
+export const createCampaignTool = defineTool({
+    name: "create_campaign",
+    title: "Создать кампанию",
+    description: "Создать новую рекламную кампанию. Бюджет в рублях. ⚠️ Тестовой среды у Директа нет: кампания создаётся в боевом аккаунте. Деньги она начнёт тратить после модерации и включения, поэтому созданную для проверки оставляйте черновиком.",
+    annotations: WRITE,
+    schema: createCampaignSchema,
+    handler: handleCreateCampaign
+});
+export const updateCampaignTool = defineTool({
+    name: "update_campaign",
+    title: "Обновить кампанию",
+    description: "Обновить кампанию: название, бюджет (руб), UTM-разметку и/или статус (SUSPEND/RESUME/ARCHIVE/UNARCHIVE). Разметка действует на ссылки всех объявлений кампании.",
+    annotations: IDEMPOTENT,
+    schema: updateCampaignSchema,
+    handler: handleUpdateCampaign
+});
+export const manageCampaignsTool = defineTool({
+    name: "manage_campaigns",
+    title: "Управление кампаниями",
+    description: "Запустить, остановить, архивировать или разархивировать несколько кампаний.",
+    annotations: IDEMPOTENT,
+    schema: manageCampaignsSchema,
+    handler: handleManageCampaigns
+});
+export const getStrategyTool = defineTool({
+    name: "get_strategy",
+    title: "Стратегия кампании",
+    description: "Получить текущую стратегию показов текстово-графической кампании.",
+    annotations: READ,
+    schema: getStrategySchema,
+    handler: handleGetStrategy
+});
+export const setStrategyTool = defineTool({
+    name: "set_strategy",
+    title: "Изменить стратегию кампании",
+    description: "Изменить стратегию текстово-графической кампании: ручная, максимум кликов, средняя цена клика или конверсии, " +
+        "оплата за конверсию. Цены — в рублях, цель Метрики — goal_id.",
+    annotations: IDEMPOTENT,
+    schema: setStrategySchema,
+    handler: handleSetStrategy
+});

package/dist/tools/changes/handler.d.ts

@@ -0,0 +1,5 @@
+import type { z } from "zod";
+import type { getChangesSchema } from "./schema.js";
+type Params = z.infer<typeof getChangesSchema>;
+export declare function handleGetChanges(params: Params): Promise<string>;
+export {};

package/dist/tools/changes/handler.js

@@ -0,0 +1,33 @@
+import { apiPost } from "#shared/api/client";
+import { formatResult } from "#shared/lib/format";
+import { apiIds } from "#shared/lib/id";
+const NO_MONEY = { money: false };
+// Директ требует ровно один тип селектора: смешивать кампании, группы и объявления нельзя.
+function selectedScope(params) {
+    const scopes = [
+        params.campaign_ids?.length ? "CampaignIds" : undefined,
+        params.ad_group_ids?.length ? "AdGroupIds" : undefined,
+        params.ad_ids?.length ? "AdIds" : undefined
+    ].filter((scope) => scope !== undefined);
+    if (scopes.length !== 1) {
+        throw new Error("Для mode=objects передайте ровно один из campaign_ids/ad_group_ids/ad_ids.");
+    }
+    return scopes[0];
+}
+export async function handleGetChanges(params) {
+    if (params.mode === "campaigns") {
+        return formatResult(await apiPost("changes", "checkCampaigns", { Timestamp: params.timestamp }), NO_MONEY);
+    }
+    const scope = selectedScope(params);
+    const request = {
+        Timestamp: params.timestamp,
+        FieldNames: params.field_names ?? [scope]
+    };
+    if (params.campaign_ids?.length)
+        request.CampaignIds = apiIds(params.campaign_ids);
+    if (params.ad_group_ids?.length)
+        request.AdGroupIds = apiIds(params.ad_group_ids);
+    if (params.ad_ids?.length)
+        request.AdIds = apiIds(params.ad_ids);
+    return formatResult(await apiPost("changes", "check", request), NO_MONEY);
+}

package/dist/tools/changes/schema.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+export declare const getChangesSchema: z.ZodObject<{
+    mode: z.ZodLiteral<"campaigns" | "objects">;
+    timestamp: z.ZodString;
+    campaign_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ad_group_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ad_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    field_names: z.ZodOptional<z.ZodArray<z.ZodLiteral<"AdGroupIds" | "AdIds" | "CampaignIds" | "CampaignsStat">>>;
+}, z.core.$strip>;

package/dist/tools/changes/schema.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { CHANGES_FIELD_NAMES, CHANGES_MODES } from "#shared/config/enums";
+import { MAX_AD_GROUPS_PER_CHANGES_CALL, MAX_ADS_PER_CHANGES_CALL, MAX_CAMPAIGNS_PER_CHANGES_CALL } from "#shared/config/limits";
+import { timestampField } from "#shared/lib/date";
+import { idField } from "#shared/lib/id";
+export const getChangesSchema = z.object({
+    mode: z.literal(CHANGES_MODES).meta({
+        description: "campaigns — какие кампании менялись целиком; objects — что изменилось внутри выбранных объектов"
+    }),
+    timestamp: timestampField("Момент, начиная с которого искать изменения: YYYY-MM-DDThh:mm:ssZ"),
+    campaign_ids: z
+        .array(idField("ID кампании"))
+        .check(z.minLength(1, { error: "Список кампаний пуст" }), z.maxLength(MAX_CAMPAIGNS_PER_CHANGES_CALL, {
+        error: `Не больше ${MAX_CAMPAIGNS_PER_CHANGES_CALL} кампаний за вызов`
+    }))
+        .optional()
+        .meta({ description: "Кампании для mode=objects" }),
+    ad_group_ids: z
+        .array(idField("ID группы объявлений"))
+        .check(z.minLength(1, { error: "Список групп пуст" }), z.maxLength(MAX_AD_GROUPS_PER_CHANGES_CALL, {
+        error: `Не больше ${MAX_AD_GROUPS_PER_CHANGES_CALL} групп за вызов`
+    }))
+        .optional()
+        .meta({ description: "Группы для mode=objects" }),
+    ad_ids: z
+        .array(idField("ID объявления"))
+        .check(z.minLength(1, { error: "Список объявлений пуст" }), z.maxLength(MAX_ADS_PER_CHANGES_CALL, { error: `Не больше ${MAX_ADS_PER_CHANGES_CALL} объявлений за вызов` }))
+        .optional()
+        .meta({ description: "Объявления для mode=objects" }),
+    field_names: z
+        .array(z.literal(CHANGES_FIELD_NAMES))
+        .check(z.minLength(1, { error: "Список полей пуст" }))
+        .optional()
+        .meta({ description: "Какие изменения интересуют; по умолчанию — соответствующие переданным ID" })
+});

package/dist/tools/changes/tool.d.ts

@@ -0,0 +1 @@
+export declare const getChangesTool: import("#shared/lib/tool").ToolDescriptor;

package/dist/tools/changes/tool.js

@@ -0,0 +1,11 @@
+import { defineTool, READ } from "#shared/lib/tool";
+import { handleGetChanges } from "./handler.js";
+import { getChangesSchema } from "./schema.js";
+export const getChangesTool = defineTool({
+    name: "get_changes",
+    title: "Изменения объектов",
+    description: "Проверить изменения кампаний, групп и объявлений начиная с указанного времени.",
+    annotations: READ,
+    schema: getChangesSchema,
+    handler: handleGetChanges
+});

package/dist/tools/dictionaries/handler.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+import type { getRegionsSchema, listTimeZonesSchema } from "./schema.js";
+export declare function clearDictionaryCache(): void;
+export declare function handleGetRegions(params: z.infer<typeof getRegionsSchema>): Promise<string>;
+export declare function handleListTimeZones(params: z.infer<typeof listTimeZonesSchema>): Promise<string>;

package/dist/tools/dictionaries/handler.js

@@ -0,0 +1,66 @@
+import { z } from "zod";
+import { apiPost } from "#shared/api/client";
+import { parseApiResult } from "#shared/api/parse";
+import { formatResult } from "#shared/lib/format";
+// Схемы ответа нестрогие (`looseObject`): обязательны только поля, на которые опирается
+// инструмент, остальное проходит насквозь и попадает в вывод. Директ добавляет поля без
+// предупреждения — строгая схема превратила бы такое добавление в отказ инструмента.
+const geoRegionSchema = z.looseObject({
+    GeoRegionId: z.number(),
+    GeoRegionName: z.string()
+});
+const timeZoneSchema = z.looseObject({
+    TimeZone: z.string(),
+    TimeZoneName: z.string()
+});
+// Имя справочника связано с типом его записей здесь и только здесь: перепутать пару
+// или ошибиться в имени теперь нельзя — это ловит компилятор.
+const DICTIONARIES = {
+    GeoRegions: geoRegionSchema,
+    TimeZones: timeZoneSchema
+};
+// Справочники Директа — тысячи записей и почти неизменны, поэтому держатся
+// в памяти процесса: иначе каждый вызов тратил бы баллы API на одно и то же.
+let cache = {};
+// Кэш переживает импорты, поэтому тесту нужен явный сброс: без него проверка
+// «сходил в сеть один раз» зависела бы от того, загрузил ли справочник кто-то раньше.
+export function clearDictionaryCache() {
+    cache = {};
+}
+async function loadDictionary(name) {
+    const cached = cache[name];
+    if (cached)
+        return cached;
+    const data = (await apiPost("dictionaries", "get", { DictionaryNames: [name] }));
+    const items = parseApiResult(z.array(DICTIONARIES[name]), data?.result?.[name] ?? [], `справочник ${name}`);
+    // Запись по generic-ключу компилятор не выводит: для него `cache[name]` — пересечение
+    // всех вариантов. Чтение (`cache[name]` выше) типизировано точно, каст только здесь.
+    cache[name] = items;
+    return items;
+}
+function filterByName(items, names, search) {
+    if (!search)
+        return items;
+    const needle = search.toLowerCase();
+    return items.filter((item) => names(item).some((name) => String(name ?? "")
+        .toLowerCase()
+        .includes(needle)));
+}
+function limitedOutput(matched, limit) {
+    const limited = matched.slice(0, limit);
+    const note = matched.length > limited.length
+        ? `ℹ️ Показано ${limited.length} из ${matched.length}. Уточните search или увеличьте limit.\n\n`
+        : "";
+    // Записи справочника короткие, но вывод всё равно идёт через общий форматтер:
+    // один формат ответа на все инструменты, никаких исключений.
+    return note + formatResult(limited, { money: false });
+}
+export async function handleGetRegions(params) {
+    const regions = await loadDictionary("GeoRegions");
+    return limitedOutput(filterByName(regions, (region) => [region.GeoRegionName], params.search), params.limit);
+}
+export async function handleListTimeZones(params) {
+    const zones = await loadDictionary("TimeZones");
+    // Ищем и по коду (Europe/Moscow), и по названию: модель приходит то с одним, то с другим.
+    return limitedOutput(filterByName(zones, (zone) => [zone.TimeZone, zone.TimeZoneName], params.search), params.limit);
+}

package/dist/tools/dictionaries/schema.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+export declare const getRegionsSchema: z.ZodObject<{
+    search: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodInt>;
+}, z.core.$strip>;
+export declare const listTimeZonesSchema: z.ZodObject<{
+    search: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodInt>;
+}, z.core.$strip>;

package/dist/tools/dictionaries/schema.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { REGIONS_DEFAULT_LIMIT, REGIONS_MAX_LIMIT, TIME_ZONES_DEFAULT_LIMIT, TIME_ZONES_MAX_LIMIT } from "#shared/config/limits";
+export const getRegionsSchema = z.object({
+    search: z
+        .string()
+        .optional()
+        .meta({ description: "Фильтр по названию региона: подстрока без учёта регистра, например «москва»" }),
+    limit: z
+        .int()
+        .check(z.positive({ error: "Лимит должен быть больше нуля" }), z.lte(REGIONS_MAX_LIMIT, { error: `Лимит не больше ${REGIONS_MAX_LIMIT}` }))
+        .default(REGIONS_DEFAULT_LIMIT)
+        .meta({ description: `Сколько регионов вернуть, максимум ${REGIONS_MAX_LIMIT}` })
+});
+export const listTimeZonesSchema = z.object({
+    search: z.string().optional().meta({
+        description: "Фильтр по коду или названию пояса: подстрока без учёта регистра, например «moscow» или «Екатеринбург»"
+    }),
+    limit: z
+        .int()
+        .check(z.positive({ error: "Лимит должен быть больше нуля" }), z.lte(TIME_ZONES_MAX_LIMIT, { error: `Лимит не больше ${TIME_ZONES_MAX_LIMIT}` }))
+        .default(TIME_ZONES_DEFAULT_LIMIT)
+        .meta({ description: `Сколько часовых поясов вернуть, максимум ${TIME_ZONES_MAX_LIMIT}` })
+});

package/dist/tools/dictionaries/tool.d.ts

@@ -0,0 +1,2 @@
+export declare const getRegionsTool: import("#shared/lib/tool").ToolDescriptor;
+export declare const listTimeZonesTool: import("#shared/lib/tool").ToolDescriptor;

package/dist/tools/dictionaries/tool.js

@@ -0,0 +1,19 @@
+import { defineTool, READ } from "#shared/lib/tool";
+import { handleGetRegions, handleListTimeZones } from "./handler.js";
+import { getRegionsSchema, listTimeZonesSchema } from "./schema.js";
+export const getRegionsTool = defineTool({
+    name: "get_regions",
+    title: "Справочник регионов",
+    description: "Справочник кодов регионов (GeoRegions) для таргетинга. Фильтр по названию. 225 = Россия.",
+    annotations: READ,
+    schema: getRegionsSchema,
+    handler: handleGetRegions
+});
+export const listTimeZonesTool = defineTool({
+    name: "list_time_zones",
+    title: "Справочник часовых поясов",
+    description: "Справочник часовых поясов (TimeZones) для set_time_targeting и create_campaign. Фильтр по коду или названию.",
+    annotations: READ,
+    schema: listTimeZonesSchema,
+    handler: handleListTimeZones
+});

package/dist/tools/dynamic-targets/handler.d.ts

@@ -0,0 +1,6 @@
+import type { z } from "zod";
+import type { listDynamicTargetsSchema, manageDynamicTargetsSchema } from "./schema.js";
+type Params = z.infer<typeof manageDynamicTargetsSchema>;
+export declare function handleListDynamicTargets(params: z.infer<typeof listDynamicTargetsSchema>): Promise<string>;
+export declare function handleManageDynamicTargets(params: Params): Promise<string>;
+export {};

package/dist/tools/dynamic-targets/handler.js

@@ -0,0 +1,96 @@
+import { apiPost } from "#shared/api/client";
+import { formatResult } from "#shared/lib/format";
+import { apiId, apiIds } from "#shared/lib/id";
+import { buildPage } from "#shared/lib/pagination";
+const LIST_FIELDS = [
+    "Id",
+    "AdGroupId",
+    "CampaignId",
+    "Name",
+    "Bid",
+    "ContextBid",
+    "StrategyPriority",
+    "State",
+    "StatusClarification",
+    "Conditions",
+    "ConditionType"
+];
+export async function handleListDynamicTargets(params) {
+    const selection = {};
+    if (params.dynamic_target_ids?.length)
+        selection.Ids = apiIds(params.dynamic_target_ids);
+    if (params.ad_group_ids?.length)
+        selection.AdGroupIds = apiIds(params.ad_group_ids);
+    if (params.campaign_ids?.length)
+        selection.CampaignIds = apiIds(params.campaign_ids);
+    if (params.states?.length)
+        selection.States = params.states;
+    const request = { SelectionCriteria: selection, FieldNames: LIST_FIELDS };
+    const page = buildPage(params);
+    if (page)
+        request.Page = page;
+    return formatResult(await apiPost("dynamictextadtargets", "get", request));
+}
+function buildTarget(target) {
+    const item = {
+        AdGroupId: apiId(target.ad_group_id),
+        Name: target.name,
+        Conditions: target.conditions.map((condition) => ({
+            Operand: condition.operand,
+            Operator: condition.operator,
+            Arguments: condition.arguments
+        }))
+    };
+    if (target.bid !== undefined)
+        item.Bid = target.bid;
+    if (target.context_bid !== undefined)
+        item.ContextBid = target.context_bid;
+    if (target.strategy_priority)
+        item.StrategyPriority = target.strategy_priority;
+    return item;
+}
+function buildBid(bid) {
+    const selectors = [bid.dynamic_target_id, bid.ad_group_id, bid.campaign_id].filter(Boolean);
+    if (selectors.length !== 1) {
+        throw new Error("Каждая ставка должна содержать ровно один ID цели, группы или кампании.");
+    }
+    if (bid.bid === undefined && bid.context_bid === undefined && bid.strategy_priority === undefined) {
+        throw new Error("Для каждой ставки укажите bid, context_bid и/или strategy_priority.");
+    }
+    const item = {};
+    if (bid.dynamic_target_id)
+        item.Id = apiId(bid.dynamic_target_id);
+    if (bid.ad_group_id)
+        item.AdGroupId = apiId(bid.ad_group_id);
+    if (bid.campaign_id)
+        item.CampaignId = apiId(bid.campaign_id);
+    if (bid.bid !== undefined)
+        item.Bid = bid.bid;
+    if (bid.context_bid !== undefined)
+        item.ContextBid = bid.context_bid;
+    if (bid.strategy_priority)
+        item.StrategyPriority = bid.strategy_priority;
+    return item;
+}
+export async function handleManageDynamicTargets(params) {
+    if (params.action === "add") {
+        if (!params.targets?.length)
+            throw new Error("Для action=add передайте targets.");
+        // Динамические цели в API называются Webpages — имя поля тела повторяет справочник.
+        const webpages = params.targets.map(buildTarget);
+        return formatResult(await apiPost("dynamictextadtargets", "add", { Webpages: webpages }));
+    }
+    if (params.action === "set_bids") {
+        if (!params.bids?.length)
+            throw new Error("Для action=set_bids передайте bids.");
+        const bids = params.bids.map(buildBid);
+        return formatResult(await apiPost("dynamictextadtargets", "setBids", { Bids: bids }));
+    }
+    if (!params.dynamic_target_ids?.length) {
+        throw new Error(`Для action=${params.action} передайте dynamic_target_ids.`);
+    }
+    const data = await apiPost("dynamictextadtargets", params.action, {
+        SelectionCriteria: { Ids: apiIds(params.dynamic_target_ids) }
+    });
+    return formatResult(data);
+}

package/dist/tools/dynamic-targets/schema.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export declare const listDynamicTargetsSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodInt>;
+    offset: z.ZodOptional<z.ZodInt>;
+    dynamic_target_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ad_group_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    campaign_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    states: z.ZodOptional<z.ZodArray<z.ZodLiteral<"ON" | "SUSPENDED">>>;
+}, z.core.$strip>;
+export declare const manageDynamicTargetsSchema: z.ZodObject<{
+    action: z.ZodLiteral<"add" | "delete" | "resume" | "set_bids" | "suspend">;
+    targets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        ad_group_id: z.ZodString;
+        name: z.ZodString;
+        conditions: z.ZodArray<z.ZodObject<{
+            operand: z.ZodLiteral<"DOMAIN" | "OFFERS_LIST_URL" | "PAGE_CONTENT" | "PAGE_TITLE" | "URL">;
+            operator: z.ZodLiteral<"CONTAINS_ANY" | "EQUALS_ANY" | "NOT_CONTAINS_ALL" | "NOT_EQUALS_ALL">;
+            arguments: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        bid: z.ZodOptional<z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>>;
+        context_bid: z.ZodOptional<z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>>;
+        strategy_priority: z.ZodOptional<z.ZodLiteral<"HIGH" | "LOW" | "NORMAL">>;
+    }, z.core.$strip>>>;
+    bids: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dynamic_target_id: z.ZodOptional<z.ZodString>;
+        ad_group_id: z.ZodOptional<z.ZodString>;
+        campaign_id: z.ZodOptional<z.ZodString>;
+        bid: z.ZodOptional<z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>>;
+        context_bid: z.ZodOptional<z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>>;
+        strategy_priority: z.ZodOptional<z.ZodLiteral<"HIGH" | "LOW" | "NORMAL">>;
+    }, z.core.$strip>>>;
+    dynamic_target_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;