Русская версия

Сервер MCP (Model Context Protocol) для Yandex Direct, Yandex Metrika, Yandex Wordstat и Yandex Webmaster API. Предоставляет 132 инструмента для управления рекламными кампаниями, аналитикой, исследованием ключевых слов, органическим поиском и отчетностью через любого MCP-совместимого клиента.

Управление рекламой и аналитикой Яндекса через ИИ

Особенности

Яндекс Direct API v5 (80 инструментов) Кампании — создавать, обновлять, приостанавливать, возобновлять, архивировать, удалять Ad Groups — создание, обновление с настройками таргетинга Реклама — текст, изображение, динамика, реклама покупок с умеренностью ** Ключевые слова** — управление ключевыми словами и ставками Статистика — подробные отчеты об исполнении с повторным использованием асинхронного анализа Bid Modifiers — мобильные, настольные, демографические, региональные изменения Ретаргетинг — ретаргетинг списков и целевых аудиторий Умные рекламные мишени — фильтры таргетинга на основе кормов Сайт-ссылки, VCards, Callouts — расширения объявлений Изображения — загружать, управлять и удалять рекламные изображения ** Питание** — управление кормами для продуктов Videos & Creatives — создание видеорекламы ** Словари** — регионы, интересы, категории ** Негативные ключевые слова** — общие отрицательные наборы ключевых слов

Yandex MCP Server

🇷🇺 Русская версия

MCP (Model Context Protocol) server for Yandex Direct, Yandex Metrika, Yandex Wordstat, and Yandex Webmaster APIs. Provides 132 tools for managing advertising campaigns, analytics, keyword research, organic search, and reporting through any MCP-compatible client.

Manage Yandex advertising and analytics through AI

Features

Yandex Direct API v5 (80 tools)

• Campaigns — create, update, pause, resume, archive, delete
• Ad Groups — create, update with targeting settings
• Ads — text, image, dynamic, shopping ads with moderation
• Keywords — manage keywords and bids
• Statistics — detailed performance reports with async retry
• Bid Modifiers — mobile, desktop, demographics, regional adjustments
• Retargeting — retargeting lists and audience targets
• Smart Ad Targets — feed-based targeting filters
• Sitelinks, VCards, Callouts — ad extensions
• Images — upload, manage, and delete ad images
• Feeds — product feed management
• Videos & Creatives — video ad creation
• Dictionaries — regions, interests, categories
• Negative Keywords — shared negative keyword sets

Yandex Wordstat API (5 tools)

• Top Requests — popular search queries and associations
• Dynamics — query frequency trends over time
• Regions — regional distribution of search queries
• Regions Tree — hierarchical region structure
• User Info — API quota and usage limits

Yandex Webmaster API v4 (4 tools)

• User ID — resolve the token owner’s Webmaster UserID
• Hosts — list verified sites and their IDs
• Host Summary — SQI, searchable and excluded page counts
• Popular Queries — organic search queries with shows, clicks, and positions

Yandex Metrika API (43 tools)

• Counters — create, configure, delete tracking counters
• Goals — conversion goal management
• Reports — analytics with custom metrics, time series, comparisons, drill-down
• Segments — audience segmentation
• Filters — traffic filtering rules
• Grants — access permission management
• Offline Data — upload conversions, calls, expenses, user parameters
• Labels & Annotations — organize counters and mark chart events
• Delegates — account delegation

Quick Start

1. Install

git clone https://github.com/SvechaPVL/yandex-mcp.git
cd yandex-mcp
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -e .

2. Set up your Yandex API token

Create a .env file:

YANDEX_TOKEN=your_oauth_token_here