Яндекс.Директ
NPM · YANDEX-DIRECT-MCP-PLUS · SCANNED SEP 21
API Яндекс.Директа v5: кампании, объявления, фразы, ставки, минус-фразы, статистика
Available components
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 Security98
- 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
- 32 of 97 dependencies flagged as unhealthy. View diagnostics → Partial
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 (MIT).Pass
- Actively maintained (last published 7 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability72
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 8455 tokens (~140/item across 60 items; 60 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 Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
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 60 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
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
{
"mcpServers": {
"pavelsiba-yandex-direct-mcp-plus": {
"command": "npx",
"args": [
"-y",
"yandex-direct-mcp-plus"
]
}
}
} {
"servers": {
"pavelsiba-yandex-direct-mcp-plus": {
"command": "npx",
"args": [
"-y",
"yandex-direct-mcp-plus"
]
}
}
} codex mcp add pavelsiba-yandex-direct-mcp-plus -- npx -y yandex-direct-mcp-plus
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"pavelsiba-yandex-direct-mcp-plus": {
"type": "local",
"command": [
"npx",
"-y",
"yandex-direct-mcp-plus"
],
"enabled": true
}
}
} openclaw mcp add pavelsiba-yandex-direct-mcp-plus --command npx --arg -y --arg yandex-direct-mcp-plus
mcp_servers:
pavelsiba-yandex-direct-mcp-plus:
command: "npx"
args: ["-y", "yandex-direct-mcp-plus"] {
"McpServers": {
"pavelsiba-yandex-direct-mcp-plus": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"yandex-direct-mcp-plus"
]
}
}
} assistant mcp add pavelsiba-yandex-direct-mcp-plus -t stdio -c npx -a -y yandex-direct-mcp-plus
{
"mcpServers": {
"pavelsiba-yandex-direct-mcp-plus": {
"command": "npx",
"args": [
"-y",
"yandex-direct-mcp-plus"
]
}
}
} 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.
- 21 Sept 26 +4
- Stability: unverified → 0.27 ▲ functional
- 14 Sept 26 +15
- Malware scan: unverified → pass ▲ security
- 13 Sept 26 65
First indexed and scored.
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 21 Sept 2026 · Analysed npm/yandex-direct-mcp-plus@1.6.1
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 | 2818956181 |
| Predicate type | https://slsa.dev/provenance/v1 |
| Subject digest | sha512:f78171d7b86920e813436d6516e0bac7b5922cf346adfbe9fec5530bb9194275e9686865f40a078dee1b1e42a23476c73c28a0408775a808e1dd13d0a |
Background: How many MCP packages publish verified provenance →
Dependencies 97 packages
| Packages resolved | 97 |
|---|---|
| Stale | 32 |
| 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_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 Установить ставки ~190
Установить ставки (поиск/сети, в рублях) на уровне фраз, групп или кампаний (сервис Bids). Работает только при ручном управлении ставками: на автостратегии Директ назначает ставки сам, вызов пройдёт без ошибки, но на показы не повлияет. Сначала get_strategy, затем get_keyword_auction — сколько стоит нужная позиция.
| Name | Type | Req | Description |
|---|---|---|---|
| ad_group_ids | array | – | Ставки на все фразы указанных групп |
| bid | number | – | Ставка на поиске в рублях |
| campaign_ids | array | – | Ставки на все фразы указанных кампаний |
| context_bid | number | – | Ставка в сетях (РСЯ) в рублях |
| keyword_ids | array | – | Ставки на уровне фраз |
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.
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 Изменить ключевые слова ~102
Изменить текст ключевых фраз и подстановочные переменные {param1}/{param2}. Правка текста может привести к появлению фразы с новым ID или к её удалению как дубликата — сверьтесь с list_keywords после вызова. Ставки меняет set_keyword_bids, статус — manage_keywords.
| Name | Type | Req | Description |
|---|---|---|---|
| keywords | array | yes | Фразы и их новые значения; поля, которые не переданы, остаются прежними |
No output schema declared.
No examples provided.
update_retargeting_lists Изменить списки ретаргетинга ~77
Изменить название, описание и правила условий ретаргетинг��. Переданные правила заменяют прежние целиком: сначала прочитайте условие через list_retargeting_lists.
| Name | Type | Req | Description |
|---|---|---|---|
| retargeting_lists | array | yes | Условия и их новые значения; поля, которые не переданы, остаются прежними |
No output schema declared.
No examples provided.
update_text_ad Обновить объявление ~97
Обновить текстовое объявление: заголовок, текст, ссылка. Изменённое объявление уходит на модерацию.
| Name | Type | Req | Description |
|---|---|---|---|
| ad_id | string | yes | ID обновляемого объявления |
| href | string | – | Новая ссылка на сайт |
| text | string | – | Новый текст объявления |
| title | string | – | Новый заголовок |
| title2 | string | – | Новый второй заголовок |
No output schema declared.
No examples provided.
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 84 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 September 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 60 tools: list_campaigns, get_campaign, create_campaign, update_campaign, manage_campaigns, and 55 more. Their descriptions and schemas cost roughly 8,455 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 21 September 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 MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.