yandex-direct-mcp

io.github.theYahia由 GitHub 账号 theYahia 发布v3.0.2更新于 Oct 24, 2026

MCP server for Yandex Direct — PPC campaigns, ads, keywords, statistics (Russia)

已验证STDIO仅桌面数据与分析商业与电商

概览

AI 生成的概览

面向 Yandex Direct 的本地 MCP 服务器，让助手管理俄罗斯市场的搜索广告系列、广告组、广告、关键词、出价和统计。

可以做什么
列出、查看、创建和更新广告系列，包括预算与暂停、恢复、归档等状态变更。列出、创建和删除广告组，并设置广告组的否定关键词。列出、创建和更新文字广告，并可暂停、恢复、归档、送审或删除。列出和添加关键词，以卢布设置出价，管理关键词状态并设置广告系列的否定关键词。获取按周期的统计（展示、点击、花费、CTR、CPC）、账户余额和地区代码。
适用场景
适合在俄罗斯投放 Yandex Direct 广告时使用，让助手起草或调整广告系列、广告、关键词和出价，或在不打开网页后台的情况下获取效果统计和余额。
运行要求
通过 npx 在本地运行（需要 Node.js）。需要在 YANDEX_DIRECT_TOKEN 中提供 Yandex Direct 的 OAuth 令牌；令牌所属应用须在 Yandex OAuth 注册，并在 Direct 中申请 API 访问权限。可选 YANDEX_DIRECT_SANDBOX=1 使用沙盒，代理令牌需 YANDEX_DIRECT_LOGIN。需要访问 Yandex Direct 的网络连接。
安装前请注意
create_campaign、create_text_ad、add_keywords、set_keyword_bids 等工具会改动正式广告账户并可能产生真实花费；预算和出价以卢布输入。建议先用 YANDEX_DIRECT_SANDBOX=1 测试。YANDEX_DIRECT_TOKEN 中的 OAuth 令牌可访问账户，须妥善保密。部分工具会删除或归档广告、广告组和关键词。

安装

在 SourceWeft 中

  1. 打开 控制台中的 yandex-direct-mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@theyahia/yandex-direct-mcp

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

[npm] [License: MIT]

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

Установка

Claude Desktop

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

Claude Code

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

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

ПеременнаяОбязательнаНазначение
YANDEX_DIRECT_TOKENдаOAuth-токен Яндекс.Директ
YANDEX_DIRECT_SANDBOXнет1 — работа в песочнице (изолированные данные, без трат). Тот же токен, отличается только URL
YANDEX_DIRECT_LOGINнетЛогин клиента для агентских токенов (заголовок Client-Login). Обязателен, если токен агентский

Как получить токен

OAuth-токен выпускается для приложения, зарегистрированного в Яндекс OAuth, с доступом к API Директа. Подробности — регистрация приложения и получение токена. Доступ к API нужно запросить в интерфейсе Директа.

⚠️ Внимание: реальные траты

Инструменты create_campaign, create_text_ad, add_keywords, set_keyword_bids и др. меняют боевой рекламный аккаунт и могут расходовать деньги. Для отладки сценариев включайте песочницу (YANDEX_DIRECT_SANDBOX=1).

Инструменты (20)

Кампании

ИнструментОписание
list_campaignsСписок кампаний (фильтр по статусу/типу, пагинация)
get_campaignДетальная информация о кампании по ID
create_campaignСоздать кампанию (бюджет в рублях, выбор стратегии)
update_campaignОбновить название/бюджет и/или статус (SUSPEND/RESUME/ARCHIVE/UNARCHIVE)

Группы объявлений

ИнструментОписание
list_ad_groupsГруппы объявлений выбранных кампаний
create_ad_groupСоздать группу с таргетингом по регионам
delete_ad_groupsУдалить группы по ID
set_ad_group_negative_keywordsЗадать минус-фразы группы

Объявления

ИнструментОписание
list_adsОбъявления в группах
create_text_adСоздать текстовое объявление (≤56/≤30/≤81)
update_text_adОбновить заголовок/текст/ссылку
manage_adssuspend/resume/archive/unarchive/moderate/delete

Ключевые слова и ставки

ИнструментОписание
list_keywordsКлючевые фразы в группах (ставки в рублях)
add_keywordsДобавить ключевые фразы
set_keyword_bidsУстановить ставки (поиск/сети, рубли) на фразах/группах/кампаниях
manage_keywordssuspend/resume/delete
set_campaign_negative_keywordsЗадать минус-фразы кампании

Статистика, аккаунт, справочники

ИнструментОписание
get_statisticsСтатистика за период (показы, клики, расход, CTR, CPC)
get_account_balanceБаланс аккаунта (Live API v4)
get_regionsСправочник кодов регионов (225 = Россия)

Примеры запросов

Покажи все активные рекламные кампанииСоздай кампанию "Летняя распродажа" с бюджетом 5000 ₽/день, старт 2026-05-01Установи ставку 25 ₽ на ключевые фразы 111 и 222Добавь минус-фразы "бесплатно", "скачать" в кампанию 12345Какая статистика у кампаний 12345 и 67890 за последнюю неделю?Найди код региона для НовосибирскаПокажи баланс аккаунта

Разработка

bash
npm installnpm run build      # tsc → dist/npm test           # vitest (моки fetch)npm run dev        # tsx src/index.ts

Лицензия

MIT

来源：README.md，提交 24690a3

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v3.0.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分