mcp-server-yandex-direct

MCP-сервер для работы с Yandex Direct API v5 через Claude Code, Claude Desktop и другие MCP-совместимые клиенты.

Возможности

• 79 MCP-инструментов для всех 22 сервисов Yandex Direct API v5 + Reports
• CLI-интерфейс с 79 командами
• Pydantic-модели для валидации запросов/ответов
• Поддержка агентского режима (заголовок Client-Login)

Установка

pip install mcp-server-yandex-direct

Настройка

Переменные окружения

Переменная	Обязательная	Описание
YD_TOKEN	Да	OAuth-токен Yandex Direct API
YD_CLIENT_LOGIN	Нет	Логин клиента для агентских аккаунтов
YD_LANG	Нет	Язык ответов: ru, en, uk

Claude Code

Добавьте в настройки MCP:

{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": ["mcp-server-yandex-direct"],
      "env": {
        "YD_TOKEN": "your-oauth-token"
      }
    }
  }
}

Использование CLI

# Получить кампании
mcp-server-yandex-direct campaigns-get '{"SelectionCriteria": {}, "FieldNames": ["Id", "Name", "State"]}'

# Остановить кампании
mcp-server-yandex-direct campaigns-suspend 123,456

# Получить объявления кампании
mcp-server-yandex-direct ads-get '{"SelectionCriteria": {"CampaignIds": [123]}, "FieldNames": ["Id", "Type", "State"]}'

# Получить справочники
mcp-server-yandex-direct dictionaries-get Currencies,Regions

# Получить отчёт
mcp-server-yandex-direct reports-get '{"params": {"SelectionCriteria": {"DateFrom": "2026-01-01", "DateTo": "2026-04-28"}, "FieldNames": ["Date", "CampaignId", "Clicks", "Cost"], "ReportName": "My Report", "ReportType": "CAMPAIGN_PERFORMANCE_REPORT", "DateRangeType": "CUSTOM_DATE", "Format": "TSV"}}'

Сервисы API

Сервис	Описание	Методы	Кол-во
Campaigns	Управление рекламными кампаниями	get, add, update, delete, suspend, resume, archive, unarchive	8
AdGroups	Управление группами объявлений	get, add, update, delete	4
Ads	Управление объявлениями	get, add, update, delete, suspend, resume, archive, unarchive, moderate	9
Keywords	Управление ключевыми фразами	get, add, update, delete, suspend, resume	6
Bids	Управление ставками	get, set, setAuto	3
BidModifiers	Корректировки ставок	get, add, delete, set	4
Sitelinks	Быстрые ссылки	get, add, delete	3
AdImages	Изображения для объявлений	get, add, delete	3
AdVideos	Видео для объявлений	get, add	2
AdExtensions	Расширения объявлений (уточнения)	get, add, delete	3
AudienceTargets	Условия нацеливания на аудиторию	get, add, delete, suspend, resume, setBids	6
RetargetingLists	Условия ретаргетинга и подбора аудитории	get, add, update, delete	4
NegativeKeywordSharedSets	Наборы минус-фраз	get, add, update, delete	4
Feeds	Фиды (товарные каталоги)	get, add, update, delete	4
Creatives	Креативы (видео, баннеры)	get, add	2
KeywordsResearch	Исследование ключевых фраз	deduplicate, hasSearchVolume	2
Leads	Заявки с Турбо-страниц	get	1
Changes	Отслеживание изменений	check, checkDictionaries, checkCampaigns	3
Dictionaries	Справочники (регионы, валюты, часовые пояса)	get	1
Clients	Управление параметрами клиента	get, update	2
AgencyClients	Управление клиентами агентства	get, add, update	3
TurboPages	Турбо-страницы	get	1
Reports	Отчёты (TSV/CSV)	get	1
Итого			79

Разработка

pip install -e ".[test]"
pytest tests/ -v

Лицензия

MIT