theyahia avatar

yandex-direct-mcp

theyahia/yandex-direct-mcp

Connects Claude to Yandex Direct API v5 for managing PPC campaigns in Russia's leading search advertising platform. Exposes 12 operations including campaign CRUD (create, list, update with budget and status controls), ad group management with region targeting, text ad creation, keyword additions, and statistics pulls via ReportService. You'd use this if you're running Yandex Direct campaigns and want to check performance metrics, spin up new campaigns with daily budgets, or bulk manage keywords and ad groups without leaving your Claude workflow. Requires a Yandex Direct OAuth token. Particularly relevant for Russian market advertisers who need programmatic access to campaign operations and reporting data.

GitHub stars
4
tools
20
transport
STDIO
last updated
May 1, 2026

Tools

20 tools

Public tool metadata for what this MCP can expose to an agent.

list_campaignsСписок кампаний (фильтр по статусу/типу, пагинация)

Список кампаний (фильтр по статусу/типу, пагинация)

No parameter schema in public metadata yet.

get_campaignДетальная информация о кампании по ID

Детальная информация о кампании по ID

No parameter schema in public metadata yet.

create_campaignСоздать кампанию (бюджет в рублях, выбор стратегии)

Создать кампанию (бюджет в рублях, выбор стратегии)

No parameter schema in public metadata yet.

update_campaignОбновить название/бюджет и/или статус (SUSPEND/RESUME/ARCHIVE/UNARCHIVE)

Обновить название/бюджет и/или статус (SUSPEND/RESUME/ARCHIVE/UNARCHIVE)

No parameter schema in public metadata yet.

list_ad_groupsГруппы объявлений выбранных кампаний

Группы объявлений выбранных кампаний

No parameter schema in public metadata yet.

create_ad_groupСоздать группу с таргетингом по регионам

Создать группу с таргетингом по регионам

No parameter schema in public metadata yet.

delete_ad_groupsУдалить группы по ID

Удалить группы по ID

No parameter schema in public metadata yet.

set_ad_group_negative_keywordsЗадать минус-фразы группы

Задать минус-фразы группы

No parameter schema in public metadata yet.

list_adsОбъявления в группах

Объявления в группах

No parameter schema in public metadata yet.

create_text_adСоздать текстовое объявление (≤56/≤30/≤81)

Создать текстовое объявление (≤56/≤30/≤81)

No parameter schema in public metadata yet.

update_text_adОбновить заголовок/текст/ссылку

Обновить заголовок/текст/ссылку

No parameter schema in public metadata yet.

manage_adssuspend/resume/archive/unarchive/moderate/delete

suspend/resume/archive/unarchive/moderate/delete

No parameter schema in public metadata yet.

list_keywordsКлючевые фразы в группах (ставки в рублях)

Ключевые фразы в группах (ставки в рублях)

No parameter schema in public metadata yet.

add_keywordsДобавить ключевые фразы

Добавить ключевые фразы

No parameter schema in public metadata yet.

set_keyword_bidsУстановить ставки (поиск/сети, рубли) на фразах/группах/кампаниях

Установить ставки (поиск/сети, рубли) на фразах/группах/кампаниях

No parameter schema in public metadata yet.

manage_keywordssuspend/resume/delete

suspend/resume/delete

No parameter schema in public metadata yet.

set_campaign_negative_keywordsЗадать минус-фразы кампании

Задать минус-фразы кампании

No parameter schema in public metadata yet.

get_statisticsСтатистика за период (показы, клики, расход, CTR, CPC)

Статистика за период (показы, клики, расход, CTR, CPC)

No parameter schema in public metadata yet.

get_account_balanceБаланс аккаунта (Live API v4)

Баланс аккаунта (Live API v4)

No parameter schema in public metadata yet.

get_regionsСправочник кодов регионов (225 = Россия)

Справочник кодов регионов (225 = Россия)

No parameter schema in public metadata yet.

Sponsors

Readme

@theyahia/yandex-direct-mcp

MCP-сервер для API Яндекс.Директ — управление контекстной рекламой из любого MCP-клиента (Claude, Cursor и др.): кампании, группы, объявления, ключевые слова, ставки, минус-фразы, статистика, баланс. 20 инструментов.

npm License: MIT

Деньги — в рублях (бюджеты, ставки на вводе и выводе); сервер сам конвертирует в микроединицы API. Поддержаны песочница для безопасного теста и агентский режим (Client-Login).

Установка

Claude Desktop

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": ["-y", "@theyahia/yandex-direct-mcp"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "ваш_токен"
      }
    }
  }
}

Claude Code

claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y @theyahia/yandex-direct-mcp

Конфигурация (переменные окружения)


View the full README on GitHub

Details

Repository
github.com/theyahia/yandex-direct-mcp
Website
github.com/theYahia/yandex-direct-mcp
Category
Finance & Commerce
Package
@theyahia/yandex-direct-mcp
Transport
STDIO
Registry
MCP registry, active

More from theyahia

Related Finance & Commerce MCP servers

View all
1vdalhambra avatarFinancekit Mcpvdalhambra/financekit-mcpStock quotes, technical analysis, crypto prices, and portfolio insights for AI agents4stars
2mohisyed avatarjPOS MCP Servermohisyed/jpos-mcpMCP server for jPOS and ISO 8583. Deterministic payment protocol tools for AI agents.3stars
3kaditang avatarAgent Wallet Mcpkaditang/agent-wallet-mcpDEPRECATED - hosted service retired 2026-10-31. Local non-custodial Solana MCP (you sign).3stars
4ragingorangutan avatarRootvine Mcpragingorangutan/rootvine-mcpNeutral commerce resolution for AI agents — music live, ranked by trust, never by commission.3stars
5theyahia avatarYookassa Mcptheyahia/yookassa-mcpMCP server for YooKassa payment API — payments, refunds, receipts (54-FZ). 10 tools. First MCP for3stars
6adgentek avatarAdsmcpadgentek/adsmcpMCP-native ad server. Monetize AI chatbots and agents with conversational ads.2stars