Яндекс.Директ
NPM · YANDEX-DIRECT-MCP-PLUS
API Яндекс.Директа v5: кампании, объявления, фразы, ставки, минус-фразы, статистика
Available components
Last scanned (1 hour ago)
Scores higher than 95% of npm servers
Category Marketing and SEO
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 0 of 6 dependencies flagged as unhealthy. View diagnostics → Pass
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to Pavelsiba/yandex-direct-mcp-plus). View diagnostics → Pass
- Clear OSI-approved license (AGPL-3.0-only).Pass
- Actively maintained (last published 0 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability68
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 10683 tokens (~161/item across 66 items; 66 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management87
- Stability check failed: the tool surface changed between 1.7.0 and 2.1.0: 2 tool removals, 0 breaking changes, 9 additions. See how to fix → Fail
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 6 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 67 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 5 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87.
- 4 Nov 26 −2
- Stability: fail → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Package version: 2.0.1 → 2.1.0 functional
- 1 Nov 26 −1
- Stability: pass → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Stability: pass → fail ▼ security
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Package version: 1.8.0 → 2.0.1 functional
- 29 Oct 26 +1
- Stability: 0.97 → pass security
- 28 Oct 26 −1
- Stability: pass → 0.97 functional
- 26 Oct 26 +1
- Stability: fail → pass ▲ security
- 17 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 85 to 98.
- 16 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 82 to 85.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Analysed npm/yandex-direct-mcp-plus@2.1.0
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | Pavelsiba/yandex-direct-mcp-plus |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/Pavelsiba/yandex-direct-mcp-plus/.github/workflows/release.yml@refs/heads/main |
| Rekor log index | 3690139133 |
| Predicate type | SLSA build provenance https://slsa.dev/provenance/v1 |
| Subject digest | sha512:d5d54d0c4967229f1f877cc4c7ea26db023db2b175ee226cd954bc1560c34611437c83e00c23ef62a70c1e1de5417deccbb1831af4e54511411a6d247 |
Background: How many MCP packages publish verified provenance →
Dependencies 6 packages
| Packages resolved | 6 |
|---|---|
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
set_ad_group_negative_keywords Минус-фразы группы ~273
Минус-фразы на уровне группы объявлений. Режим mode обязателен: replace заменяет список целиком (прежние фразы теряются, пустой массив очищает), add дописывает к текущим, remove убирает названные — читать список перед этим не нужно, add и remove делают это сами. Чтобы добавить фразу к существующим, нужен add: replace с одной фразой сотрёт остальные.
| Name | Type | Req | Description |
|---|---|---|---|
| ad_group_id | string | yes | ID группы объявлений |
| mode | string | yes | Обязателен. replace — заменить список целиком (пустой массив очищает, прежние фразы теряются), add — дописать к текущим, remove — убрать перечисленные. add и remove сначала читают текущий список, это… |
| negative_keywords | array | yes | Минус-фразы группы: при mode=replace — полный новый список взамен прежнего, при add — что дописать, при remove — что убрать |
No output schema declared.
No examples provided.
set_audience_targets Управление аудиторными целями ~117
Добавить, остановить, возобновить, удалить аудиторные цели или изменить их ставки.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | Что сделать: add, set_bids, suspend, resume или delete (необратимо) |
| audience_target_ids | array | – | Условия для suspend, resume или delete |
| bids | array | – | Новые ставки и приоритеты; обязателен при action=set_bids |
| targets | array | – | Условия для добавления; обязателен при action=add |
No output schema declared.
No examples provided.
set_auto_keyword_bids Ставки под объём трафика ~264
Назначить ставки по правилу вместо суммы: на поиске — под желаемый объём трафика (5–100%), в сетях — под долю аудитории, с надбавкой в процентах и потолком в рублях. Директ рассчитает ставку по текущим торгам один раз, следить за ними дальше не будет; назначенные ставки покажет get_keyword_auction. Только при ручной стратегии на соответствующей площадке — иначе Директ отклонит вызов. Отдельному автотаргетингу правило не задаётся: используйте ad_group_ids или campaign_ids.
| Name | Type | Req | Description |
|---|---|---|---|
| ad_group_ids | array | – | Ставки по всем фразам указанных групп |
| campaign_ids | array | – | Ставки по всем фразам указанных кампаний |
| keyword_ids | array | – | Ставки по указанным фразам и автотаргетингам |
| network | object | – | Правило ставки в сетях: под долю аудитории. Только при ручной стратегии в сетях |
| search | object | – | Правило ставки на поиске: под объём трафика. Только при ручной стратегии на поиске |
No output schema declared.
No examples provided.
set_bid_adjustments Изменить корректировки ставок ~40
Изменить коэффициенты существующих корректировок по их ID.
| Name | Type | Req | Description |
|---|---|---|---|
| adjustments | array | yes | Корректировки и их новые коэффициенты |
No output schema declared.
No examples provided.
set_campaign_negative_keywords Минус-фразы кампании ~270
Минус-фразы на уровне кампании. Режим mode обязателен: replace заменяет список целиком (прежние фразы теряются, пустой массив очищает), add дописывает к текущим, remove убирает названные — читать список перед этим не нужно, add и remove делают это сами. Чтобы добавить фразу к существующим, нужен add: replace с одной фразой сотрёт остальные.
| Name | Type | Req | Description |
|---|---|---|---|
| campaign_id | string | yes | ID кампании |
| mode | string | yes | Обязателен. replace — заменить список целиком (пустой массив очищает, прежние фразы теряются), add — дописать к текущим, remove — убрать перечисленные. add и remove сначала читают текущий список, это… |
| negative_keywords | array | yes | Минус-фразы кампании: при mode=replace — полный новый список взамен прежнего, при add — что дописать, при remove — что убрать |
No output schema declared.
No examples provided.
set_keyword_bids Установить ставки ~332
Установить фиксированные ставки (поиск/сети, в рублях) на уровне фраз, групп или кампаний и включить или выключить автоставку автотаргетинга. Ставки применяются только при ручной стратегии: на автостратегии их назначает Директ, и ставка, не подходящая стратегии, не применится. Сначала get_strategy, затем get_keyword_auction — сколько стоит нужный объём трафика; ставку под объём ставит set_auto_keyword_bids.
| Name | Type | Req | Description |
|---|---|---|---|
| ad_group_ids | array | – | Ставки по всем фразам указанных групп |
| autotargeting_auto_bid | boolean | – | Автоставка автотаргетинга на поиске: true — Директ подбирает ставку сам, false — действует search_bid. Если для keyword_ids передать search_bid без этого поля, Директ выключит автоставку; чтобы сохра… |
| campaign_ids | array | – | Ставки по всем фразам указанных кампаний |
| keyword_ids | array | – | Ставки по указанным фразам и автотаргетингам |
| network_bid | number | – | Ставка в сетях (РСЯ) в рублях. Применяется только при ручной стратегии в сетях (MAXIMUM_COVERAGE) |
| search_bid | number | – | Ставка на поиске в рублях. Применяется только при ручной стратегии на поиске (HIGHEST_POSITION) |
No output schema declared.
No examples provided.
set_priority_goals Цели стратегии ~319
Задать цели стратегии кампании (PriorityGoals) и их ценность в рублях — по ним автостратегия оптимизирует ставки, в том числе «максимум конверсий» со служебным GoalId 13. Режим mode обязателен: add добавляет цели или меняет ценность уже заданных, remove убирает названные, replace заменяет список целиком (пустой массив очищает). Текущий список сервер читает сам. Чтобы добавить цель к существующим, нужен add: replace с одной целью сотрёт остальные. ⚠️ Смена целей перезапускает обучение стратегии. Поддерживаются текстово-графические, динамические, смарт и единые перфоманс-кампании; ID целей — из Метрики.
| Name | Type | Req | Description |
|---|---|---|---|
| campaign_id | string | yes | ID кампании: текстово-графической, динамической, смарт или единой перфоманс-кампании |
| goals | array | yes | Цели: при mode=replace — полный новый список взамен прежнего (пустой массив очищает), при add — что добавить или чью ценность поменять, при remove — что убрать |
| mode | string | yes | Обязателен. replace — заменить список целиком (прежние цели теряются), add — добавить цели или поменять ценность уже заданных, remove — убрать перечисленные. Текущий список сервер читает сам, это доп… |
No output schema declared.
No examples provided.
set_sitelinks Создать быстрые ссылки ~58
Создать новый набор из 1–8 быстрых ссылок. Возвращает ID набора для привязки к объявлению.
| Name | Type | Req | Description |
|---|---|---|---|
| sitelinks | array | yes | Новый набор из 1–8 быстрых ссылок |
No output schema declared.
No examples provided.
set_strategy Изменить стратегию кампании ~501
Изменить стратегию текстово-графической кампании: ручная, максимум кликов, средняя цена клика или конверсии, оплата за конверсию. Цены — в рублях, цель Метрики — goal_id.
| Name | Type | Req | Description |
|---|---|---|---|
| average_cpa | number | – | Средняя цена конверсии в рублях; обязательна для AVERAGE_CPA |
| average_cpc | number | – | Средняя цена клика в рублях; обязательна для AVERAGE_CPC |
| bid_ceiling | number | – | Максимальная ставка в рублях для WB_MAXIMUM_CLICKS, WB_MAXIMUM_CONVERSION_RATE и AVERAGE_CPA |
| campaign_id | string | yes | ID текстово-графической кампании |
| conversion_price | number | – | Цена конверсии в рублях для PAY_FOR_CONVERSION: списывается за конверсию, а не за клик |
| goal_id | string | – | ID цели Метрики для AVERAGE_CPA, PAY_FOR_CONVERSION и WB_MAXIMUM_CONVERSION_RATE; для оплаты за конверсию обязателен. Для WB_MAXIMUM_CONVERSION_RATE допустимо служебное 13 — оптимизация по ключевым ц… |
| network_limit_percent | integer | – | Доля расходов в сетях для NETWORK_DEFAULT, проценты |
| network_type | string | yes | Стратегия в сетях: NETWORK_DEFAULT (по настройкам поиска), MAXIMUM_COVERAGE, WB_MAXIMUM_CLICKS, WB_MAXIMUM_CONVERSION_RATE, AVERAGE_CPC, AVERAGE_CPA, PAY_FOR_CONVERSION или SERVING_OFF |
| search_type | string | yes | Стратегия на поиске: HIGHEST_POSITION (ручная), WB_MAXIMUM_CLICKS, WB_MAXIMUM_CONVERSION_RATE (максимум конверсий за недельный бюджет), AVERAGE_CPC, AVERAGE_CPA, PAY_FOR_CONVERSION или SERVING_OFF |
| weekly_spend_limit | number | – | Недельный бюджет в рублях; обязателен для WB_MAXIMUM_CLICKS и WB_MAXIMUM_CONVERSION_RATE, для остальных автостратегий необязателен |
No output schema declared.
No examples provided.
set_time_targeting Задать расписание показов ~342
Задать расписание показов кампании: дни, часы, почасовые коэффициенты, праздники и часовой пояс. ⚠️ Расписание заменяется целиком: часы вне переданных правил показов не получат.
| Name | Type | Req | Description |
|---|---|---|---|
| campaign_id | string | yes | ID кампании, десятичная строка |
| consider_working_weekends | boolean | – | Показывать ли в рабочие выходные по расписанию переносимого буднего дня; false — по расписанию выходного |
| holiday_bid_percent | integer | – | Коэффициент к ставке в праздники, % от текущей: 10–200 с шагом 10. Ноль запрещён — показы отключает suspend_on_holidays |
| holiday_end_hour | integer | – | Час окончания показов в праздники, не включая его, 1–24 |
| holiday_start_hour | integer | – | Час начала показов в праздники включительно, 0–23 |
| schedule | array | yes | Правила показов. Часы, не покрытые ни одним правилом, показов не получают — расписание задаётся целиком, а не дополняется. Правила применяются по порядку, последнее переопределяет предыдущие |
| suspend_on_holidays | boolean | – | true — в праздники показов нет; false — идут по правилам holiday_*. Не задан — праздники отдельно не настраиваются |
| time_zone | string | – | Часовой пояс кампании, например Europe/Moscow. Допустимые значения — в справочнике list_time_zones. Не задан — остаётся прежним |
No output schema declared.
No examples provided.
start_login Вход в Яндекс.Директ: ссылка ~66
Первый шаг входа из диалога, без ручного токена: возвращает ссылку на вход в Яндекс. Ссылку показать пользователю, код со страницы Яндекса передать в finish_login. Повторный вызов делает прежнюю ссылку недействительной.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
update_ad_group Обновить группу ~259
Изменить группу объявлений без пересоздания: название, регионы показа (полный список, заменяет прежний) и/или UTM-разметку ссылок. Минус-фразы группы — set_ad_group_negative_keywords, наборы — link_negative_keyword_sets, автотаргетинг — update_keywords.
| Name | Type | Req | Description |
|---|---|---|---|
| ad_group_id | string | yes | ID группы объявлений, десятичная строка |
| name | string | – | Новое название группы |
| region_ids | array | – | Регионы показа, коды из get_regions: ["225"] — Россия, ["225","-213"] — Россия кроме Москвы, ["0"] — все регионы. Минус-регионы нельзя сочетать с 0 и нельзя отправлять одни, без обычного региона. Спи… |
| tracking_params | – | – | UTM-разметка, дописывается к ссылкам объявлений группы. Без ведущего «?»: utm_source=yandex&utm_content={ad_id}. Допустимы подстановки Директа в фигурных скобках. null снимает разметку |
No output schema declared.
No examples provided.
update_campaign Обновить кампанию ~195
Обновить кампанию: название, бюджет (руб), UTM-разметку и/или статус (SUSPEND/RESUME/ARCHIVE/UNARCHIVE). Разметка действует на ссылки всех объявлений кампании.
| Name | Type | Req | Description |
|---|---|---|---|
| campaign_id | string | yes | ID кампании, десятичная строка |
| daily_budget | number | – | Новый дневной бюджет в рублях |
| name | string | – | Новое название |
| status | string | – | Действие со статусом показов: SUSPEND (остановить), RESUME, ARCHIVE, UNARCHIVE |
| tracking_params | – | – | UTM-разметка, дописывается к ссылкам всех объявлений кампании. Без ведущего «?»: utm_source=yandex&utm_campaign={campaign_id}. Допустимы подстановки Директа в фигурных скобках. null снимает разметку |
No output schema declared.
No examples provided.
update_keywords Изменить ключевые слова ~178
Изменить текст ключевых фраз, подстановочные переменные {param1}/{param2} и настройки автотаргетинга. Правка текста может привести к появлению фразы с новым ID или к её удалению как дубликата — сверьтесь с list_keywords после вызова. Автотаргетинг — фраза ---autotargeting: её ID берётся из list_keywords, категории запросов и брендов задаются autotargeting_categories / autotargeting_brand_options. Выключить автотаргетинг целиком — manage_keywords с suspend (delete Директ отбивает). Ставки меняет set_keyword_bids, статус — manage_keywords.
| Name | Type | Req | Description |
|---|---|---|---|
| keywords | array | yes | Фразы и их новые значения; поля, которые не переданы, остаются прежними |
No output schema declared.
No examples provided.
update_responsive_ad Обновить комбинаторное объявление ~175
Обновить комбинаторное объявление: заголовки, тексты, ссылка. Набор заголовков или текстов заменяется целиком — передайте полный, вместе с теми, что не меняются; текущие показывает list_ads. Изменённое объявление уходит на модерацию.
| Name | Type | Req | Description |
|---|---|---|---|
| ad_id | string | yes | ID обновляемого объявления |
| href | string | – | Новая ссылка на сайт |
| texts | array | – | Тексты, от 1 до 3, каждый до 81 символов. Заменяют прежние целиком: передайте полный набор |
| titles | array | – | Заголовки, от 1 до 7, каждый до 56 символов. Заменяют прежние целиком: передайте полный набор |
No output schema declared.
No examples provided.
update_retargeting_lists Изменить списки ретаргетинга ~76
Изменить название, описание и правила условий ретаргетинга. Переданные правила заменяют прежние целиком: сначала прочитайте условие через list_retargeting_lists.
| Name | Type | Req | Description |
|---|---|---|---|
| retargeting_lists | array | yes | Условия и их новые значения; поля, которые не переданы, остаются прежними |
No output schema declared.
No examples provided.
How do I install the Яндекс.Директ MCP server?
Яндекс.Директ runs locally as an npm package, launched with npx -y yandex-direct-mcp-plus. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · yandex-direct-mcp-plus
claude mcp add pavelsiba-yandex-direct-mcp-plus -- npx -y yandex-direct-mcp-plus
What is the Яндекс.Директ MCP server?
Яндекс.Директ is an MCP server listed in the public MCP registry as io.github.Pavelsiba/yandex-direct-mcp-plus. API Яндекс.Директа v5: кампании, объявления, фразы, ставки, минус-фразы, статистика. This page covers its npm package (yandex-direct-mcp-plus).
Is the Яндекс.Директ MCP server safe to use?
Яндекс.Директ scores 92 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Яндекс.Директ MCP server expose?
Яндекс.Директ exposes 66 tools: start_login, finish_login, auth_status, logout, list_campaigns, and 61 more. Their descriptions and schemas cost roughly 10,358 tokens of context every time the server is loaded.
Is the Яндекс.Директ MCP server still maintained?
Яндекс.Директ is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Яндекс.Директ MCP server under?
Яндекс.Директ declares the AGPL-3.0-only licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.