Server data from the Official MCP Registry
MCP server for Yandex Direct API v5: manage PPC campaigns, ads, keywords, and statistics.
MCP server for Yandex Direct API v5: manage PPC campaigns, ads, keywords, and statistics.
Valid MCP server (1 strong, 0 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
7 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: YANDEX_DIRECT_TOKEN
Environment variable: YANDEX_DIRECT_LOGIN
Environment variable: YANDEX_DIRECT_SANDBOX
Environment variable: YANDEX_DIRECT_LANG
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-gistrec-mcp-yandex-direct": {
"env": {
"YANDEX_DIRECT_LANG": "your-yandex-direct-lang-here",
"YANDEX_DIRECT_LOGIN": "your-yandex-direct-login-here",
"YANDEX_DIRECT_TOKEN": "your-yandex-direct-token-here",
"YANDEX_DIRECT_SANDBOX": "your-yandex-direct-sandbox-here"
},
"args": [
"-y",
"mcp-yandex-direct"
],
"command": "npx"
}
}
}From the project's GitHub README.
MCP-сервер для Yandex Direct API v5: управляйте контекстной рекламой из Claude, Cursor, Codex и других AI-клиентов на естественном языке.
Ассистент сам собирает данные из статистики, ключей, ставок и расширений, находит закономерности и вносит правки — то, что в веб-кабинете Директа приходится делать вручную и по одному экрану.
raw_request.raw_request блокирует любой не-read метод без confirmWrite=true; выделенные write-инструменты (ставки, бюджеты, минус-слова, статусы) проходят штатное подтверждение MCP-клиента перед вызовом.autoPaginate — проход всех страниц по курсору LimitedBy, без молчаливой обрезки на больших аккаунтах.get_quota — остаток дневной квоты API в Units (потрачено / осталось / лимит).YANDEX_DIRECT_SANDBOX) для безопасных тестов.Попросите ассистента на русском — например:
Вы: Проанализируй кампанию ClearTranscriptBot за последнюю неделю и предложи, что улучшить.
Claude (вызывает
get_statistics,list_keywords,get_callouts,get_sitelinks):Кампания «EPK/Поиск — бот в Max и Telegram» за 7 дней:
Дата Показы Клики CTR Расход, ₽ Ср. клик, ₽ 08.06 544 90 16.5% 782.50 8.69 09.06 456 70 15.4% 528.93 7.56 10.06 206 39 18.9% 254.48 6.53 11.06 198 36 18.2% 205.87 5.72 12.06 275 37 13.5% 178.95 4.84 13.06 332 45 13.6% 214.62 4.77 14.06 419 82 19.6% 481.55 5.87 Итого 2 430 399 16.4% 2 646.90 6.63 Что улучшить:
- Автотаргетинг забирает почти весь трафик. Условие
---autotargetingсобирает основную долю показов и кликов, а ключи («расшифровка интервью», «транскрибация записи» …) получают по 1–22 показа и почти 0 кликов — стоит усилить ставки на фразы или точнее настроить автотаргетинг.- Ставки на минимуме (0.30 ₽), а CTR высокий (16–20%). На поиске при таком CTR имеет смысл поднять ставки на топ-фразы — заберёте больше недорогих показов.
- Объявление 17674525479 отстаёт (CTR 2–10% против 17–20% у основного) — кандидат на переработку заголовка/текста или отключение.
- Расширения в порядке — 9 уточнений и 3 быстрые ссылки; можно добавить ещё пару быстрых ссылок (лимит — 8).
Разверните своего клиента:
claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y mcp-yandex-direct
claude_desktop_config.json — macOS ~/Library/Application Support/Claude/, Windows %APPDATA%\Claude\
{
"mcpServers": {
"yandex-direct": {
"command": "npx",
"args": ["-y", "mcp-yandex-direct"],
"env": { "YANDEX_DIRECT_TOKEN": "ваш_токен" }
}
}
}
~/.cursor/mcp.json (или .cursor/mcp.json в проекте)
{
"mcpServers": {
"yandex-direct": {
"command": "npx",
"args": ["-y", "mcp-yandex-direct"],
"env": { "YANDEX_DIRECT_TOKEN": "ваш_токен" }
}
}
}
Командой: codex mcp add yandex-direct --env YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y mcp-yandex-direct
Или в ~/.codex/config.toml:
[mcp_servers.yandex-direct]
command = "npx"
args = ["-y", "mcp-yandex-direct"]
[mcp_servers.yandex-direct.env]
YANDEX_DIRECT_TOKEN = "ваш_токен"
.vscode/mcp.json — ключ servers (не mcpServers)
{
"servers": {
"yandex-direct": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-yandex-direct"],
"env": { "YANDEX_DIRECT_TOKEN": "ваш_токен" }
}
}
}
Откройте ссылку, залогинившись под аккаунтом с доступом к нужному кабинету Яндекс Директа, и подтвердите доступ — токен покажется на странице:
Скопируйте токен в YANDEX_DIRECT_TOKEN. Токен персональный (привязан к вашему кабинету) и действует около года; при утере его можно получить заново по той же ссылке.
⚠️ Токен даёт полный доступ к рекламному кабинету (включая трату бюджета) и хранится открытым текстом в конфиге клиента — относитесь к нему как к паролю.
| Переменная | Обяз. | Описание |
|---|---|---|
YANDEX_DIRECT_TOKEN | да | OAuth-токен Яндекс Директа. |
YANDEX_DIRECT_LOGIN | нет | Логин клиента (для агентских аккаунтов). |
YANDEX_DIRECT_SANDBOX | нет | true — работать в песочнице API. |
Полный список переменных (язык ответов, таймауты, повторы) и инструментов — в docs/TOOLS.md.
npx, отдельная установка не нужна).get_statistics использует асинхронный сервис Reports: отчёт генерируется на стороне Яндекса (сервер опрашивает готовность) и имеет собственные лимиты на объём и число отчётов в сутки.YANDEX_DIRECT_LOGIN.Вопросы, идеи и доработки — пишите в Telegram: @gistrec.
MIT — см. LICENSE.
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.