# yandex-direct-mcp-plus

API Яндекс.Директа v5: кампании, объявления, фразы, ставки, минус-фразы, статистика

- **Type:** MCP server
- **Trust:** 85/100 (A), scored on the package rubric
- **Verification:** verified (build provenance)
- **Version:** 1.7.0
- **Author:** io.github.Pavelsiba
- **License:** Unknown
- **npm:** yandex-direct-mcp-plus
- **Source:** https://github.com/Pavelsiba/yandex-direct-mcp-plus
- **Compatible clients:** claude-code, cursor, copilot, gemini (basis: transport)

## Trust

85/100 (A), scored on the package rubric
- Publisher verified: no
- Build provenance: verified attestation
- npm trusted publishing (OIDC): yes
- Install scripts: nothing suspicious found
- Prompt-injection scan: not run
- Obfuscation scan: not run
- Evidence age: 0 days

## Security scan

- **Status:** clean
- **Scanned:** 2026-09-23T16:53:08.042Z
- **Version scanned:** 1.7.0
- **CVEs:** none found by OSV at scan time

## Tools

40 declared. Statically extracted from the shipped source — a floor on the surface, not a census.
- `get_account_balance` — Баланс и финансовая информация аккаунта (Amount, Currency) через Live API v4.
- `list_ad_extensions` — Получить уточнения (callouts) с их статусами и текстом.
- `add_ad_extensions` — Создать уточнения (callouts), каждый текст до 25 символов.
- `delete_ad_extensions` — Удалить уточнения по ID. ⚠️ Необратимо.
- `list_ad_groups` — Группы объявлений выбранных кампаний: названия, регионы, статусы.
- `create_ad_group` — Создать группу объявлений в кампании с таргетингом по регионам (см. get_regions).
- `delete_ad_groups` — Удалить группы объявлений по их ID. ⚠️ Необратимо.
- `manage_ad_images` — Загрузить, получить или удалить изображения объявлений (AdImages). Для add данные передаются в base64.
- `list_ads` — Объявления в группах: заголовки, тексты, ссылки, статусы, тип и подтип объявления, привязанные сайтлинки,
- `create_text_ad` — Создать текстовое объявление: заголовок (≤56), второй заголовок (≤30), текст (≤81), ссылка.
- `update_text_ad` — Обновить текстовое объявление: заголовок, текст, ссылка. Изменённое объявление уходит на модерацию.
- `manage_ads` — Действие над объявлениями: suspend/resume/archive/unarchive/moderate/delete. ⚠️ delete необратимо.
- `moderate_ads` — Отправить выбранные объявления на модерацию.
- `list_audience_targets` — Получить условия нацеливания на аудиторию по ID кампании, группы, ретаргетинга или интереса.
- `set_audience_targets` — Добавить, остановить, возобновить, удалить аудиторные цели или изменить их ставки.
- `get_bid_adjustments` — Получить корректировки ставок кампании или группы: устройства, пол и возраст, аудитории, регионы, платёжеспособность, размещение.
- `add_bid_adjustments` — Создать корректировки ставок на кампаниях или группах. Коэффициент — проценты от ставки: 100 ничего не меняет, 0 отключает показы среза.
- `set_bid_adjustments` — Изменить коэффициенты существующих корректировок по их ID.
- `delete_bid_adjustments` — Удалить корректировки по их ID. Ставка среза возвращается к базовой; отменить удаление нельзя.
- `list_businesses` — Получить доступные профили организаций из Яндекс Бизнеса.
- `list_campaigns` — Список рекламных кампаний Яндекс.Директ с фильтрацией по статусу и типу. Бюджеты — в рублях. По умолчанию возвращается узкий набор полей; нужны другие (Funds, T
- `get_campaign` — Детальная информация о кампании по ID: бюджет (руб), статус и пояснение к нему, даты, статистика,
- `create_campaign` — Создать новую текстово-графическую кампанию. Бюджет в рублях. Смарт-баннеры и динамические объявления Директ через API не создаёт с 22.05.2026, единую перфоманс
- `update_campaign` — Обновить кампанию: название, бюджет (руб), UTM-разметку и/или статус (SUSPEND/RESUME/ARCHIVE/UNARCHIVE). Разметка действует на ссылки всех объявлений кампании.
- `manage_campaigns` — Запустить, остановить, архивировать, разархивировать или удалить кампании. ⚠️ delete необратимо и недоступен кампании с накопленной статистикой — такую только а
- `get_strategy` — Получить текущую стратегию показов текстово-графической кампании вместе с целями (PriorityGoals), счётчиками и
- `set_strategy` — Изменить стратегию текстово-графической кампании: ручная, максимум кликов, средняя цена клика или конверсии,
- `set_priority_goals` — Задать цели стратегии кампании (PriorityGoals) и их ценность в рублях — по ним автостратегия оптимизирует
- `get_changes` — Проверить изменения кампаний, групп и объявлений начиная с указанного времени, а также изменения справочников (mode=dictionaries) и текущее время сервера Директ
- `get_regions` — Справочник кодов регионов (GeoRegions) для таргетинга. Фильтр по названию, 225 = Россия. with_parents=true показывает вложенность и различает одноимённые города
- `list_time_zones` — Справочник часовых поясов (TimeZones) для set_time_targeting и create_campaign. Фильтр по коду или названию.
- `list_dynamic_targets` — Получить условия нацеливания динамических текстовых объявлений.
- `manage_dynamic_targets` — Создать, изменить ставки, остановить, возобновить или удалить динамические цели.
- `list_feeds` — Получить товарные фиды, их источники, статусы обработки и связанные кампании.
- `list_keywords` — Ключевые фразы в группах объявлений: фразы, ставки (руб), статусы. По умолчанию возвращается узкий набор полей; нужны другие (StatisticsSearch, StatisticsNetwor
- `add_keywords` — Добавить ключевые фразы в группу объявлений.
- `update_keywords` — Изменить текст ключевых фраз и подстановочные переменные {param1}/{param2}. Правка текста может привести к появлению фразы с новым ID или к её удалению как дубл
- `manage_keywords` — Действие над ключевыми фразами: suspend/resume/delete. ⚠️ delete необратимо.
- `get_keyword_auction` — Сколько стоит показ: ставки и списываемые цены по позициям, ставки конкурентов, минимальная цена входа.
- `set_keyword_bids` — Установить ставки (поиск/сети, в рублях) на уровне фраз, групп или кампаний (сервис Bids). Работает только

## Install

**Verdict: install** — No blocking findings and no open coverage gaps — safe to install as configured.
**Config** (claude-code):
```json
"{\n  \"mcpServers\": {\n    \"yandex-direct-mcp-plus\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"yandex-direct-mcp-plus\"\n      ],\n      \"env\": {\n        \"YANDEX_DIRECT_TOKEN\": \"<YOUR_YANDEX_DIRECT_TOKEN>\"\n      }\n    }\n  }\n}"
```
**Credentials it will ask for** (names only — Forge never holds a value):
- `YANDEX_DIRECT_TOKEN` — Yandex Direct Token (required)
Placeholders only. Forge never holds, brokers, or transmits a credential value — replace each <YOUR_NAME> in your own config file. Do not send a value back to Forge; no Forge endpoint accepts one.
- This entry needs 1 credential (1 required). The generated config carries placeholders, so it will fail in the editor rather than at runtime if they are left unset.

## Blast radius

Extensive blast radius — deletes data; holds an api key.
- Floor 54, ceiling 54 (tier: extensive)
- This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score.

## Machine-readable views of this entry

- Signed JSON: https://forgeregistry.com/api/v1/packages/yandex-direct-mcp-plus
- Install plan: https://forgeregistry.com/api/v1/packages/yandex-direct-mcp-plus/install-plan
- Alternatives: https://forgeregistry.com/api/v1/alternatives/yandex-direct-mcp-plus
- HTML page: https://forgeregistry.com/registry/yandex-direct-mcp-plus
- MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan`

## About this document

Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.